centos上jellyfin插件安装

CentOS上安装Jellyfin插件的常见方法

一、前期准备

在安装插件前，需完成以下基础配置以避免依赖问题：

1. 更新系统包：运行sudo yum update -y确保系统软件包为最新版本。
2. 安装EPEL仓库：执行sudo yum install epel-release -y，部分插件依赖EPEL仓库中的软件包。
3. 添加Jellyfin官方YUM仓库：创建仓库配置文件/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安装Jellyfin，确保服务正常运行（sudo systemctl start jellyfin && sudo systemctl enable jellyfin）。

二、通过Web界面安装（推荐新手）

这是最便捷的方式，适合大多数用户：

1. 访问Web界面：在浏览器输入http://your_server_ip:8096，使用管理员账号登录。
2. 进入插件管理：点击左侧菜单栏「设置」→「插件管理」。
3. 浏览并安装插件：
   • 在「可用插件」 tab 中，可通过搜索框查找所需插件（如「Jellyfin Intros」）。
   • 找到目标插件后，点击右侧「安装」按钮，等待进度条完成。
4. 启用并配置插件：安装完成后，插件会显示在「已安装」 tab 中，点击开关启用。部分插件需进入「设置」→「插件」进一步配置（如输入API密钥）。

三、通过命令行安装（适合自动化管理）

若需批量或远程安装，可使用命令行工具：

1. 使用插件管理器：安装jellyfin-plugin-manager工具（sudo yum install jellyfin-plugin-manager -y），然后通过命令安装插件（替换<plugin_name>为实际名称，如jellyfin-intros）：

   sudo jellyfin-plugin-manager install <plugin_name>
   

2. 通过YUM直接安装RPM包：若插件提供了RPM包（如从官方仓库下载的plugin-name.rpm），可运行以下命令安装：

   sudo yum localinstall /path/to/plugin-name.rpm -y
   

3. 重启服务生效：安装完成后，重启Jellyfin服务：

   sudo systemctl restart jellyfin
   

四、手动安装（适用于自定义或第三方插件）

若插件未提供仓库或RPM包，可手动部署：

1. 下载插件文件：从插件官方网站或GitHub页面下载ZIP包（如jellyfin-plugin-intros.zip）。
2. 上传并解压：使用SCP/FTP将ZIP包上传至服务器，解压至Jellyfin插件目录（默认路径为/usr/share/jellyfin/plugins）：

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

3. 设置权限：确保插件目录所属用户为jellyfin（Jellyfin服务默认用户）：

   sudo chown -R jellyfin:jellyfin /usr/share/jellyfin/plugins/
   

4. 重启服务：重启Jellyfin使插件生效：

   sudo systemctl restart jellyfin
   

五、Docker环境安装（适用于容器化部署）

若使用Docker运行Jellyfin，需通过容器方式安装插件：

1. 拉取插件镜像：从Docker Hub获取插件镜像（如jellyfin/plugin-intros）：

   docker pull jellyfin/plugin-intros
   

2. 运行插件容器：将插件容器连接到Jellyfin主容器（假设Jellyfin主容器名为jellyfin）：

   docker run -d \
     --name jellyfin-plugin-intros \
     --link jellyfin:jellyfin \
     -e JELLYFIN_PORT=8096 \
     -e JELLYFIN_BASE_URL=http://localhost:8096 \
     jellyfin/plugin-intros
   

3. 配置插件：登录Jellyfin Web界面→「设置」→「插件管理」，找到「已安装」 tab 中的插件并进行配置。

注意事项

• 兼容性检查：安装前务必确认插件版本与Jellyfin版本匹配（如Jellyfin 10.x需对应插件10.x版本），避免因版本冲突导致无法运行。
• 依赖项处理：部分插件需要额外依赖（如.NET SDK、ffmpeg），需提前通过sudo yum install安装（参考插件官方文档）。
• 日志排查：若安装失败，可通过journalctl -u jellyfin -f查看Jellyfin服务日志，或检查插件目录下的logs文件夹获取详细错误信息。
• 备份数据：手动修改插件目录或配置文件前，建议备份/usr/share/jellyfin/和/var/lib/jellyfin/目录，防止数据丢失。