Linux Jellyfin更新與維護指南

一、更新前的準備工作

1. 備份關鍵數據：更新前務必備份Jellyfin的配置文件（通常位于/var/lib/jellyfin或/config）和媒體數據，防止更新過程中出現意外導致數據丟失。
2. 檢查系統要求：確保系統滿足Jellyfin的最低需求（推薦2GB RAM、2GHz CPU），避免因硬件不足導致更新后運行不穩定。
3. 確認安裝方式：明確Jellyfin的安裝方式（YUM/APT包管理、Docker容器、Snap包），不同方式的更新步驟差異較大。

二、基于包管理的更新（Debian/Ubuntu為例）

1. 添加Jellyfin官方倉庫（可選但推薦）

若未添加官方倉庫，需先導入GPG密鑰并添加倉庫文件，以確保獲取最新版本：

# 導入GPG密鑰
wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -
# 添加倉庫文件（根據Ubuntu版本調整lsb_release -cs）
echo "deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

2. 更新系統包列表

sudo apt update  # 更新包列表，確保獲取最新版本信息

3. 升級Jellyfin

• 升級所有已安裝軟件包（包括Jellyfin）：

  sudo apt upgrade -y
  

• 僅升級Jellyfin（推薦）：

  sudo apt install --only-upgrade jellyfin -y
  

4. 重啟服務并驗證

sudo systemctl restart jellyfin  # 重啟Jellyfin服務使更新生效
jellyfin --version  # 驗證版本是否更新

三、基于包管理的更新（CentOS/RHEL為例）

1. 添加EPEL倉庫（可選但推薦）

EPEL倉庫提供額外的依賴包，確保Jellyfin正常運行：

sudo yum install -y epel-release

2. 更新Jellyfin

• 使用YUM包管理器：

  sudo yum update jellyfin -y
  

• 手動下載RPM包（若官方倉庫無最新版本）：
  從Jellyfin官網下載對應版本的RPM包，然后執行：

  sudo yum localinstall jellyfin-*.rpm -y
  

3. 重啟服務并驗證

sudo systemctl restart jellyfin
jellyfin --version

四、Docker部署的更新方法

若使用Docker運行Jellyfin，更新步驟更簡單：

1. 拉取最新鏡像：

   docker pull jellyfin/jellyfin:latest
   

2. 停止并刪除舊容器：

   docker stop <container_name>  # 替換為實際容器名
   docker rm <container_name>
   

3. 運行新容器：
   保持數據卷掛載路徑一致（如/config、/data），避免數據丟失：

   docker run -d \
     --name jellyfin \
     -p 8096:8096 \
     -v /path/to/config:/config \
     -v /path/to/data:/data \
     jellyfin/jellyfin:latest
   

4. 重啟服務：

   sudo systemctl restart docker  # 若Docker設置為開機自啟，此步可省略
   

五、維護建議

1. 啟用自動更新（Ubuntu為例）：
   通過unattended-upgrades包實現自動更新，減少手動操作：

   sudo apt install unattended-upgrades -y
   sudo dpkg-reconfigure --priority=low unattended-upgrades
   

2. 定期監控系統資源：
   使用htop（CPU/內存）、nvidia-smi（GPU）等工具監控資源使用情況，避免因資源不足導致服務中斷。

3. 管理插件與依賴：

   • 僅安裝必要的插件（如Jellyfin Plugin Manager），避免插件沖突；
   • 定期檢查依賴包版本（如ffmpeg），確保與Jellyfin版本兼容。

4. 處理常見沖突：

   • 依賴沖突：使用yum check-update或apt-cache policy檢查沖突，通過yum remove <package>或apt remove <package>卸載沖突包；
   • 配置文件沖突：更新前備份配置文件，若更新后出現配置錯誤，可將備份文件覆蓋回原路徑。

5. 確保系統長期支持：
   若使用CentOS 7（已于2024年6月停止支持），建議升級到CentOS Stream、Rocky Linux或AlmaLinux，以獲得持續的安全更新和技術支持。