jellyfin在centos上的插件安裝與管理

Jellyfin在CentOS上的插件安裝與管理指南

一、插件安裝前準備

1. 安裝Jellyfin基礎服務
   確保CentOS系統已安裝Jellyfin服務器及依賴項。若未安裝，可通過以下命令完成：

   sudo yum update -y
   sudo yum install epel-release -y
   sudo yum install jellyfin -y
   sudo systemctl start jellyfin
   sudo systemctl enable jellyfin
   

2. 安裝必要依賴
   部分插件需要libicu（國際化支持）、fontconfig（字體渲染）等依賴，通過以下命令安裝：

   sudo yum install -y libicu fontconfig
   

3. 添加Jellyfin官方YUM倉庫（可選但推薦）
   為方便后續通過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
   

二、常用插件安裝方法

1. 通過YUM倉庫安裝（推薦）

適用于官方或第三方提供的YUM格式插件，操作簡便且便于管理：

sudo yum install jellyfin-plugin-name -y  # 替換為實際插件名（如jellyfin-plugin-ffmpeg）
sudo systemctl restart jellyfin

2. 通過Web界面安裝

適用于大多數圖形化管理需求：

• 登錄Jellyfin Web界面（http://服務器IP:8096）。
• 進入「設置」→「插件管理」→「可用插件」。
• 點擊「瀏覽」搜索插件（如“Intros”“PVR IPTV Simple Client”），找到后點擊「安裝」。
• 安裝完成后，在「已安裝插件」中啟用插件，部分插件需重啟服務生效。

3. 手動安裝ZIP插件

適用于無YUM包的第三方插件：

• 從插件官方頁面（如GitHub Releases）下載ZIP文件。
• 上傳至服務器，解壓至Jellyfin插件目錄（通常為/usr/share/jellyfin/plugins或/opt/jellyfin/plugins）：

  sudo unzip plugin-name.zip -d /usr/share/jellyfin/plugins/
  

• 重啟Jellyfin服務：

  sudo systemctl restart jellyfin
  

4. 通過插件管理器安裝

使用Jellyfin官方提供的jellyfin-plugin-manager工具，簡化安裝流程：

sudo yum install jellyfin-plugin-manager -y
sudo jellyfin-plugin-manager install 插件名  # 如jellyfin-plugin-ffmpeg
sudo systemctl restart jellyfin

5. Docker方式安裝（可選）

若通過Docker運行Jellyfin，可使用插件鏡像：

docker pull jellyfin/plugin-name:tag  # 替換為實際插件名和標簽（如jellyfin-plugin-ffmpeg:latest）
docker run -d --name jellyfin-plugin \
  --link jellyfin:jellyfin \
  -e JELLYFIN_PORT=8096 \
  -e JELLYFIN_BASE_URL=http://your-server-ip \
  jellyfin/plugin-name:tag

三、插件管理操作

1. 啟用/禁用插件
   登錄Web界面→「設置」→「插件管理」→「已安裝插件」，找到目標插件，點擊開關即可切換狀態。

2. 更新插件

   • 通過YUM安裝的插件：sudo yum update jellyfin-plugin-name -y
   • 通過Web界面：進入「可用插件」，檢查更新并安裝。
   • 更新后需重啟服務：sudo systemctl restart jellyfin

3. 卸載插件

   • YUM安裝：sudo yum remove jellyfin-plugin-name -y
   • 手動安裝：刪除插件目錄下的文件夾，重啟服務。

四、注意事項

1. 兼容性檢查
   安裝前確認插件版本與Jellyfin版本匹配（如Jellyfin 10.x插件不兼容11.x），避免功能異常。

2. 依賴項確認
   部分插件需要額外依賴（如ffmpeg、mediainfo），需提前通過YUM或插件文檔安裝。

3. 權限問題
   手動安裝時若遇權限錯誤，使用sudo提升權限；避免將插件放在系統關鍵目錄（如/root）。

4. 日志排查
   若插件無法正常工作，查看Jellyfin日志定位問題：

   tail -f /var/log/jellyfin/jellyfin.log
   

5. 備份數據
   安裝插件前備份Jellyfin配置文件（/etc/jellyfin）和媒體庫數據，防止意外丟失。

通過以上步驟，可在CentOS系統上完成Jellyfin插件的安裝與管理，擴展媒體中心功能（如流媒體轉碼、PVR錄制、第三方源支持等）。建議優先使用YUM倉庫或官方插件管理器，確保插件安全性和兼容性。