Jellyfin在Linux上的備份與恢復方法

Jellyfin在Linux上的備份與恢復方法

一、備份方法

1. 使用Jellyfin自帶備份功能（推薦新手）

這是最便捷的方式，適合大多數用戶。操作步驟如下：

• 登錄Jellyfin管理界面（通常為http://服務器IP:8096），使用管理員賬號登錄。
• 點擊左側菜單欄系統→備份，進入備份設置頁面。
• 點擊創建備份按鈕，選擇完整備份（包含數據庫、配置文件和媒體元數據），設置備份文件的存儲位置（如本地/opt/backups或外接U盤）。
• 點擊開始備份，等待進度條完成。備份完成后，可直接從界面下載備份文件（.tar.gz格式）到本地保存。

2. 手動備份配置文件與數據目錄（靈活可控）

若需要更細粒度的控制（如僅備份配置或媒體文件），可通過命令行手動操作：

• 備份配置文件：Jellyfin的配置文件默認存放在/etc/jellyfin目錄（如config.xml、mediasettings.xml）。執行以下命令備份：

  sudo tar -czvf jellyfin_config_backup.tar.gz -C /etc/jellyfin .
  

• 備份數據目錄：媒體文件（視頻、音頻、圖片）默認存放在/var/lib/jellyfin/media目錄（若自定義過路徑，需替換為實際路徑）。執行以下命令備份：

  sudo tar -czvf jellyfin_media_backup.tar.gz -C /var/lib/jellyfin media
  

• 轉移備份文件：將生成的.tar.gz文件復制到外部存儲設備（如移動硬盤）或網絡存儲（如NFS、Samba），確保數據安全。

3. 使用Docker容器備份（適用于Docker部署）

若Jellyfin通過Docker容器運行，可通過docker cp命令備份容器內的配置文件：

• 停止Docker服務：避免數據不一致，執行sudo systemctl stop docker。
• 備份配置文件：Jellyfin容器內的配置文件默認存放在/config目錄。執行以下命令復制到宿主機：

  docker cp jellyfin:/config /path/to/backup/config
  

• 備份數據目錄：若數據目錄掛載在宿主機（如/var/lib/jellyfin），直接備份該目錄即可（參考手動備份方法）。

4. 使用文件系統備份工具（如rsync）

適合需要定期增量備份的用戶，可高效同步數據：

• 首次完整備份：執行以下命令將/var/lib/jellyfin目錄同步到外部驅動器（如/mnt/external_drive）：

  sudo rsync -avz /var/lib/jellyfin /mnt/external_drive/
  

• 增量備份：后續只需再次運行相同命令，rsync會自動同步新增或修改的文件，節省時間和存儲空間。

二、恢復方法

1. 使用Jellyfin自帶恢復功能（對應自帶備份）

若之前使用自帶功能創建了備份，可通過以下步驟恢復：

• 登錄Jellyfin管理界面，點擊系統→備份。
• 點擊選擇文件，上傳之前下載的備份文件（.tar.gz格式）。
• 點擊開始恢復，等待進度條完成?；謴瓦^程中請勿關閉服務或斷開網絡。

2. 手動恢復配置文件與數據目錄（對應手動備份）

若之前手動備份了配置文件或數據目錄，可通過以下步驟恢復：

• 停止Jellyfin服務：避免數據沖突，執行sudo systemctl stop jellyfin。
• 恢復配置文件：將備份的jellyfin_config_backup.tar.gz文件復制到/etc/jellyfin目錄并解壓：

  sudo tar -xzvf jellyfin_config_backup.tar.gz -C /etc/jellyfin
  

• 恢復數據目錄：將備份的jellyfin_media_backup.tar.gz文件復制到/var/lib/jellyfin目錄并解壓（若媒體目錄路徑不同，需替換為實際路徑）：

  sudo tar -xzvf jellyfin_media_backup.tar.gz -C /var/lib/jellyfin
  

• 啟動Jellyfin服務：執行sudo systemctl start jellyfin，等待服務啟動完成。

3. 使用Docker容器恢復（對應Docker備份）

若之前備份了Docker容器的配置文件，可通過以下步驟恢復：

• 刪除舊容器（可選）：若已存在舊容器，執行docker rm -f jellyfin刪除。
• 重新創建容器：使用之前備份的配置文件目錄掛載到新容器：

  docker run -d --name jellyfin -p 8096:8096 -v /path/to/backup/config:/config -v /var/lib/jellyfin:/media jellyfin/jellyfin
  

  其中，/path/to/backup/config為之前備份的配置文件目錄，/var/lib/jellyfin為媒體文件目錄（需與備份時一致）。

4. 手動恢復數據庫（針對SQLite數據庫）

若Jellyfin使用SQLite數據庫（默認存儲在/var/lib/jellyfin/data/jellyfin.db），可通過以下步驟恢復：

• 停止Jellyfin服務：執行sudo systemctl stop jellyfin。
• 替換數據庫文件：將備份的jellyfin.db.bak文件復制到/var/lib/jellyfin/data/目錄，覆蓋原文件：

  sudo cp /path/to/backup/jellyfin.db.bak /var/lib/jellyfin/data/jellyfin.db
  

• 啟動Jellyfin服務：執行sudo systemctl start jellyfin，數據庫將恢復至備份時的狀態。