centos上jellyfin的插件如何安装和管理

CentOS上Jellyfin插件安装与管理指南

一、插件安装前准备

1. 系统更新与依赖安装
   运行sudo yum update -y更新系统包；安装EPEL仓库（可选但推荐，部分插件依赖其软件包）：sudo yum install epel-release -y。
2. Jellyfin基础环境配置
   若未安装Jellyfin，需先添加官方YUM仓库并安装：
   • 创建仓库文件：sudo vi /etc/yum.repos.d/jellyfin.repo，内容如下：

     [jellyfin]
     name=Jellyfin Repository
     baseurl=https://download.jellyfin.org/repository/yum/
     enabled=1
     gpgcheck=1
     gpgkey=https://download.jellyfin.org/repository/yum/RPM-GPG-KEY-jellyfin
     

   • 安装Jellyfin：sudo yum install jellyfin -y；启动并启用服务：sudo systemctl start jellyfin && sudo systemctl enable jellyfin。

二、常见插件安装方法

1. 通过Web界面安装（推荐新手）

• 登录Jellyfin Web界面（http://服务器IP:8096），进入设置 > 插件管理。
• 在可用插件 tab中，搜索目标插件（如“MetaShark”“Danmu”），点击安装即可。安装完成后，插件会自动出现在已安装插件列表中，需手动启用（切换开关）。

2. 通过插件管理器安装（命令行便捷方式）

• 安装插件管理器：sudo yum install jellyfin-plugin-manager -y。
• 使用管理器安装插件（以“MetaShark”为例）：sudo jellyfin-plugin-manager install metashark。
• 安装完成后，重启Jellyfin服务：sudo systemctl restart jellyfin，使插件生效。

3. 手动安装（适用于无仓库的插件）

• 下载插件：从官方插件页面（如GitHub Releases）或可信源下载ZIP包（如jellyfin-plugin-metashark.zip）。
• 上传并解压：将ZIP包上传至Jellyfin插件目录（默认/usr/share/jellyfin/plugins），运行sudo unzip jellyfin-plugin-metashark.zip -d /usr/share/jellyfin/plugins/解压。
• 重启服务：sudo systemctl restart jellyfin，完成安装。

4. Docker环境安装（若使用Docker运行Jellyfin）

• 拉取插件镜像（以“jellyfin/plugin-metashark”为例）：docker pull jellyfin/plugin-metashark:latest。
• 运行插件容器，链接至Jellyfin主容器：

  docker run -d --name jellyfin-metashark \
    --link jellyfin:jellyfin \
    -e JELLYFIN_PORT=8096 \
    -e JELLYFIN_BASE_URL=http://your-domain.com \
    jellyfin/plugin-metashark:latest
  

• 登录Web界面插件管理，找到并启用插件。

三、插件管理操作

1. 启用/禁用插件
   登录Web界面→设置 > 插件管理，在已安装插件列表中找到目标插件，切换启用/禁用开关即可。

2. 配置插件参数
   启用插件后，点击插件右侧的齿轮图标进入配置页，根据需求设置参数（如MetaShark需配置豆瓣Cookie、TMDB API密钥；Danmu需设置弹幕服务器地址）。

3. 删除插件
   登录Web界面→设置 > 插件管理，在已安装插件列表中找到目标插件，点击删除按钮，确认后即可卸载。删除后需重启Jellyfin服务：sudo systemctl restart jellyfin。

四、注意事项

1. 兼容性检查
   安装前务必确认插件版本与Jellyfin版本匹配（如Jellyfin 10.x需对应插件10.x版本），避免因版本不兼容导致安装失败或功能异常。

2. 依赖项处理
   部分插件需要额外依赖（如ffmpeg、python3），需提前通过sudo yum install安装；若安装过程中提示缺少依赖，根据错误信息补充对应软件包。

3. 权限与日志排查

   • 若手动安装时遇到权限问题，使用sudo提升权限；
   • 若插件无法正常工作，查看Jellyfin日志（/var/log/jellyfin/jellyfin.log）定位错误原因（如网络连接失败、配置错误）。

4. 备份与恢复
   安装插件前备份Jellyfin配置文件（/etc/jellyfin）和媒体库数据库（/var/lib/jellyfin），避免插件安装导致数据丢失。