Jellyfin插件更新后旧版本文件夹未删除问题分析

Jellyfin作为一款开源的媒体服务器软件，其插件系统为用户提供了丰富的扩展功能。然而，近期用户反馈在插件更新过程中存在一个较为隐蔽的问题：当插件更新到新版本后，旧版本的插件文件夹并未被自动删除。

问题现象

当用户通过Jellyfin的插件管理系统更新插件时，新版本插件能够正常安装并运行，但系统并未自动清理旧版本的插件文件夹。这一现象在多个非捆绑插件中均有出现，例如TheTVDB插件从v17升级到v18版本时就存在此问题。

潜在影响

该问题在正常情况下不会立即显现影响，但当用户尝试禁用或卸载插件时，系统会加载所有版本的插件文件夹，导致出现多个版本插件同时存在的异常情况。更严重的是，每个旧版本插件都会被更新到最新版本，造成系统资源的浪费和潜在的功能冲突。

技术分析

深入分析该问题，发现Jellyfin系统中存在一个名为RemoveOldPlugins的配置参数，该参数默认值为false。这一设置直接决定了系统在插件更新时是否自动清理旧版本文件夹。

在Docker环境（如linuxserver镜像）中部署的Jellyfin实例，该参数同样默认为false。由于该参数未在Web管理界面中提供修改选项，普通用户很难发现这一隐藏配置，更无法轻易调整。

解决方案

对于遇到此问题的用户，可以通过以下步骤解决：

1. 找到Jellyfin的配置文件system.xml
2. 定位<RemoveOldPlugins>配置项
3. 将其值修改为true
4. 重启Jellyfin服务

对于Docker用户，可以通过执行命令查找和修改该配置：

docker exec -it jellyfin grep RemoveOldPlugins config/config/system.xml

最佳实践建议

为避免类似问题，建议Jellyfin管理员：

• 定期检查插件目录，手动清理残留的旧版本文件夹
• 在升级关键插件前进行备份
• 关注官方更新日志，了解相关配置变更
• 考虑在社区版本中将RemoveOldPlugins默认值改为true

该问题的修复将显著提升Jellyfin插件管理的健壮性，避免因版本残留导致的系统异常，同时也为后续的插件开发提供了更清晰的环境管理机制。