jellyfin在centos上的插件安装与使用

Jellyfin 在 CentOS 上的插件安装与使用

一 前置准备

• 确认 Jellyfin 已安装并运行，默认访问端口为 8096：
  • 启动与开机自启：sudo systemctl start jellyfin && sudo systemctl enable jellyfin
  • 防火墙放行：sudo firewall-cmd --zone=public --add-port=8096/tcp --permanent && sudo firewall-cmd --reload
• 插件与 Jellyfin 版本需匹配；安装后如插件要求，重启服务：sudo systemctl restart jellyfin
• 建议准备非 root 的系统用户运行 Jellyfin，涉及插件目录写入时便于权限管理（可选但推荐）。

二 安装方式

• 方式一 Web 界面安装（推荐）

  • 访问：http://服务器IP:8096，登录管理员账号
  • 路径：设置 → 插件 → 浏览，搜索并点击 安装，完成后在列表中 启用，必要时重启 Jellyfin
  • 适合大多数插件，操作直观、升级方便。

• 方式二 添加插件仓库后安装（以 MetaShark 为例）

  • 路径：设置 → 插件 → 存储库 → 添加存储库，填写仓库 URL
  • 返回插件页，找到并安装 MetaShark，按页面提示完成配置（如刮削源、语言等）
  • 适合需要第三方元数据的场景，便于集中管理与更新。

• 方式三 RPM 包或命令行工具安装（可选）

  • RPM 本地安装：下载插件的 .rpm 包，执行：sudo yum localinstall 插件名.rpm，然后 sudo systemctl restart jellyfin
  • 命令行插件管理器（若仓库提供）：sudo yum install jellyfin-plugin-manager -y，然后 sudo jellyfin-plugin-manager install <插件名>
  • 适合离线环境或需要脚本化部署的场景。

三 常用插件与快速使用

• 元数据与刮削增强
  • 安装并启用 MetaShark 后，在插件配置中选择刮削语言与数据源，返回 控制台 → 媒体库 执行 扫描全部库，可显著提升中文元数据匹配度与海报质量。
• 界面与主题
  • 路径：设置 → 外观与感觉（Look and Feel）→ 主题（Theme），选择内置主题实现界面风格切换；如需更深度的界面定制，可安装第三方皮肤包并在主题处上传应用（注意备份与兼容性）。
• 硬件加速（非插件但常配合插件使用）
  • 在 控制台 → 播放 → 硬件加速 选择 Intel Quick Sync 或 VAAPI/NVENC 等选项，可明显降低转码 CPU 占用，提升播放流畅度（需服务器与驱动支持）。

四 常见问题与排查

• 插件不生效或报错
  • 确认插件与当前 Jellyfin 版本兼容；在插件页检查是否启用；必要时执行 sudo systemctl restart jellyfin
  • 查看日志定位问题：Jellyfin 日志通常位于 /var/log/jellyfin/，结合插件文档逐项核对依赖与配置项。
• 权限与目录访问
  • 若插件需要写入数据或缓存，确保运行 Jellyfin 的用户对相关目录具备 读写权限；必要时使用 chown/chmod 调整，或把插件数据目录归属到 Jellyfin 运行用户。
• 仓库与网络
  • 添加第三方 存储库 URL 时，确保网络可达且源可信；安装失败可更换镜像源或改用 RPM 本地安装 方式。