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，数据库将恢复至备份时的状态。