Jellyfin Linux版如何添加插件

Jellyfin Linux版添加插件指南

一 通过 Web 界面安装

• 访问管理界面：在浏览器打开 http://服务器IP:8096，使用管理员账号登录。
• 进入插件页：左侧导航点击 设置 → 插件，在页面中选择 浏览/安装，找到需要的插件并点击 安装。
• 启用与重启：安装完成后在插件列表中启用；如提示或插件需要，重启服务：sudo systemctl restart jellyfin。
• 兼容性检查：安装前确认插件与当前 Jellyfin 版本兼容，必要时查看插件说明文档。

二 手动安装插件目录

• 准备插件包：从插件的 GitHub Releases 下载最新 .zip 包，解压后得到插件文件夹（名称通常为插件ID）。
• 放置插件目录（Linux 常见路径）：将插件文件夹复制到 $HOME/.local/share/jellyfin/plugins（若目录不存在可手动创建）。
• 重启服务：执行 sudo systemctl restart jellyfin 使插件加载。
• 常见插件示例：如 豆瓣元数据插件 支持通过“插件 → 存储库 → 添加”方式安装，或按上述手动方式放置后重启。

三 使用插件仓库添加第三方源

• 添加仓库：进入 设置 → 插件 → 存储库 → 添加，在 仓库URL 填入第三方清单地址，例如 https://github.com/Libitum/jellyfin-plugin-douban/releases/latest/download/manifest.json，保存后回到插件页安装对应插件。
• 国内镜像示例：如需使用中文字幕插件源，可添加 https://gitee.com/caryyu/jellyfin-plugin-repo/raw/master/manifest-cn.json 或 https://github.com/caryyu/jellyfin-plugin-repo/raw/master/manifest-us.json，再在列表中安装目标插件。

四 Docker 部署的添加方式

• 卷挂载方式：启动容器时将宿主机的 /config/plugins 挂载到容器内相同路径（示例：docker run … -v /path/to/config:/config …），把插件文件夹放入宿主机的 /path/to/config/plugins，然后 docker restart jellyfin。
• 复制进容器方式：将插件文件夹复制到运行中的容器：docker cp 插件文件夹 容器名:/config/plugins/插件文件夹，随后 docker restart jellyfin。

五 常见问题与排查

• 权限与路径：确保 Jellyfin 对插件目录有读写权限；Linux 手动安装时注意 $HOME/.local/share/jellyfin/plugins 路径与文件所有者。
• 重启与生效：多数插件安装或更新后需要 重启 Jellyfin 才能加载。
• 版本兼容：插件需与 Jellyfin 版本匹配，安装前查看插件页面说明。
• 查看日志：出现异常时检查 Jellyfin 日志（日志路径可在控制台或系统服务状态中查看），定位插件加载失败原因。