centos下jellyfin的插件怎么安装

CentOS下Jellyfin插件安装方法汇总

在CentOS系统中，Jellyfin插件的安装方式主要分为图形界面（Web）、命令行（YUM仓库/手动RPM）、Docker环境及手动编译四类，以下是详细步骤及注意事项：

一、前置准备

1. 更新系统包：确保系统软件包为最新版本，避免兼容性问题。

   sudo yum update -y
   

2. 添加EPEL仓库（可选但推荐）：部分插件依赖EPEL仓库中的软件包。

   sudo yum install epel-release -y
   

3. 添加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
   

4. 安装Jellyfin（若未安装）：

   sudo yum install jellyfin -y
   sudo systemctl start jellyfin
   sudo systemctl enable jellyfin
   

二、通过Web界面安装（最常用）

1. 访问Web界面：在浏览器输入http://your_server_ip:8096，使用管理员账号登录。
2. 进入插件管理：点击左侧菜单设置→插件管理。
3. 浏览并安装插件：
   • 在“可用插件” tab 中，通过搜索框查找所需插件（如“MetaShark”“Plexamp”等）。
   • 点击插件右侧的安装按钮，等待安装进度完成。
4. 启用插件：安装完成后，找到插件并点击其右侧的开关，切换至“启用”状态。
5. 重启服务（可选）：部分插件需要重启Jellyfin才能生效，可通过以下命令重启：

   sudo systemctl restart jellyfin
   

三、通过命令行安装（YUM仓库）

若插件已收录至Jellyfin官方YUM仓库，可直接通过yum命令安装：

# 搜索插件（以“metashark”为例）
sudo yum search jellyfin-plugin-metashark

# 安装插件（替换为实际插件名称）
sudo yum install jellyfin-plugin-metashark -y

# 重启Jellyfin服务
sudo systemctl restart jellyfin

注意：安装前需确认插件与Jellyfin版本兼容（如CentOS 7对应el7架构，CentOS 8对应el8）。

四、Docker环境安装

若使用Docker运行Jellyfin，需通过Docker Hub拉取插件镜像并关联主容器：

1. 拉取插件镜像：

   docker pull jellyfin/plugin-name:tag  # 替换为实际插件名称（如jellyfin/plugin-metashark）及标签（如latest）
   

2. 运行插件容器：

   docker run -d \
     --name jellyfin-plugin \
     --link jellyfin:jellyfin \  # 关联Jellyfin主容器（需提前运行）
     -e JELLYFIN_PORT=8096 \     # 替换为Jellyfin主容器的端口
     -e JELLYFIN_BASE_URL=http://your_server_ip:8096 \  # 替换为Jellyfin主容器的访问地址
     jellyfin/plugin-name:tag
   

3. 配置插件：登录Jellyfin Web界面→设置→插件管理，找到插件并启用，根据需求调整配置。

五、手动安装（适用于无仓库的插件）

1. 下载插件：从插件官方网站（如GitHub Releases）下载ZIP包（如jellyfin-plugin-example.zip）。
2. 上传至服务器：使用scp或FTP工具将ZIP包上传至Jellyfin插件目录（默认路径为/usr/share/jellyfin/plugins）。
3. 解压插件：

   cd /usr/share/jellyfin/plugins
   sudo unzip /path/to/jellyfin-plugin-example.zip -d jellyfin-plugin-example
   

4. 重启服务：

   sudo systemctl restart jellyfin
   

5. 启用插件：登录Web界面→设置→插件管理，找到插件并启用。

六、注意事项

1. 兼容性检查：安装前务必确认插件版本与Jellyfin版本匹配（如Jellyfin 10.x需对应插件10.x版本）。
2. 依赖项安装：部分插件需要额外依赖（如ffmpeg、libicu），可通过yum安装：

   sudo yum install ffmpeg libicu fontconfig -y
   

3. 权限问题：手动安装时需使用sudo提升权限，避免目录权限不足导致安装失败。
4. 日志排查：若安装失败，可查看Jellyfin日志（/var/log/jellyfin/jellyfin.log）定位问题。
5. 备份数据：安装前备份Jellyfin配置文件（/etc/jellyfin）及媒体库数据，防止意外丢失。

通过以上方法，可根据实际需求选择合适的安装方式。若遇到问题，建议参考插件官方文档或Jellyfin社区论坛获取进一步支持。