在 Ubuntu 上安装 Jellyfin 插件
一 前置准备
- 确保 Jellyfin 已安装并正常运行，默认访问端口为 8096。如未安装，可参考官方仓库一键安装脚本或手动添加仓库后安装：
- 一键脚本：curl https://repo.jellyfin.org/install-debuntu.sh | sudo bash
- 手动添加仓库后执行：sudo apt update && sudo apt install jellyfin -y
- 浏览器登录 http://服务器IP:8096 完成初始化设置，后续插件操作在管理后台完成。
二 方法一 通过 Web 界面安装（通用、推荐）
- 登录 Jellyfin Web 管理端，进入左侧 插件 页面。
- 点击 目录/仓库（Catalog/Repositories），选择并安装所需的插件仓库（如官方或第三方仓库）。
- 返回 插件 页，在 可用 或 已安装 列表中找到目标插件，点击 安装，按提示完成安装。
- 安装完成后，按插件说明进行启用与配置；如插件需要重启服务，按提示操作或在系统执行：sudo systemctl restart jellyfin。
三 方法二 手动安装插件（适用于离线或仓库未收录的插件）
- 准备插件包：通常为 .zip 或 .dll（Jellyfin 插件以 .dll 为主，部分社区插件提供 .zip 打包）。
- 放置插件文件：
- 系统安装路径：将插件文件复制到 /var/lib/jellyfin/plugins/（如插件包含多个文件/目录，保持原有结构）。
- Docker 部署：将插件复制到容器内 /config/plugins/，示例：
- 复制：docker cp 插件.zip jellyfin:/config/plugins/
- 进入容器解压（如为 zip）：docker exec -it jellyfin unzip /config/plugins/插件.zip -d /config/plugins/插件名
- 设置权限（系统安装时建议执行）：chown -R jellyfin:jellyfin /var/lib/jellyfin/plugins/插件名
- 重启 Jellyfin 使插件生效：
- 系统：sudo systemctl restart jellyfin
- Docker：docker restart jellyfin
- 进入 Web 管理端 插件 页，确认插件已启用，并按需配置。
四 Docker 部署的要点与常见问题
- 插件目录映射：运行容器时务必将宿主机的插件目录挂载到容器内 /config/plugins，例如：
- -v /path/to/config:/config
- 这样插件文件放在宿主机的 /path/to/config/plugins 即可被容器识别，后续无需再 docker cp。
- 权限与重启：确保宿主机插件目录对容器运行用户（常见为 PUID/PGID=1000）可读写；新增或更新插件后执行 docker restart jellyfin。
- 字体与中文显示（如安装字幕相关插件）：容器内安装中文字体并重启，例如：
- docker exec -it jellyfin /bin/bash
- apt update && apt install -y fonts-noto-cjk-extra
- exit
- docker restart jellyfin。
