ubuntu中jellyfin的备份与恢复方法

Ubuntu系统中Jellyfin的备份与恢复方法

一、备份方法

1. 使用Jellyfin自带备份功能（推荐）

这是最便捷的方式，可一键备份配置、数据库及媒体元数据。

• 操作步骤：
  ① 登录Jellyfin管理界面（http://your_server_ip:8096），使用管理员账号进入；
  ② 点击左侧菜单栏系统→备份；
  ③ 选择完整备份（包含所有必要数据），设置备份文件存储路径（本地目录或外接存储）；
  ④ 点击开始备份，等待进度条完成；
  ⑤ 备份完成后，可直接从界面下载备份文件（.tar.gz格式）到本地保存。

2. 手动备份数据目录（基础方法）

适用于需要自定义备份范围或无管理界面的场景，核心是备份/var/lib/jellyfin目录（包含媒体元数据、用户信息等）。

• 操作步骤：
  ① 停止Jellyfin服务，避免数据不一致：sudo systemctl stop jellyfin；
  ② 使用tar命令打包备份目录：sudo tar -czvf jellyfin_backup.tar.gz -C /var/lib/jellyfin .；
  ③ 将备份文件复制到安全位置（如外接U盘、NAS）：sudo cp jellyfin_backup.tar.gz /mnt/external_drive/；
  ④ 启动Jellyfin服务：sudo systemctl start jellyfin。

3. 使用rsync同步备份（实时/增量备份）

适合需要定期同步到远程存储（如群晖NAS）的场景，支持增量备份（仅同步变化部分）。

• 操作步骤：
  ① 安装rsync（若未安装）：sudo apt update && sudo apt install rsync；
  ② 执行同步命令（将本地Jellyfin目录同步到远程服务器）：sudo rsync -avz -e ssh /var/lib/jellyfin user@remote_host:/path/to/backup/（替换user、remote_host为实际用户名和服务器地址）；
  ③ 如需排除某些文件（如临时文件），可添加--exclude='temp/'参数。

4. Docker容器备份（适用于Docker部署）

若Jellyfin通过Docker运行，可备份容器内的/config目录（包含配置文件）及媒体文件。

• 操作步骤：
  ① 停止Jellyfin容器：sudo docker stop jellyfin；
  ② 备份容器数据到本地：sudo docker cp jellyfin:/config /mnt/backup/jellyfin_config；
  ③ 备份媒体文件（若媒体目录在容器外，需单独同步）；
  ④ 恢复时，重新创建容器并挂载备份的/config目录：sudo docker run -d --name jellyfin -p 8096:8096 -v /mnt/backup/jellyfin_config:/config -v /path/to/media:/media jellyfin/jellyfin。

二、恢复方法

1. 使用Jellyfin自带恢复功能（推荐）

若之前使用自带工具备份，可直接通过界面恢复。

• 操作步骤：
  ① 登录Jellyfin管理界面，进入系统→备份；
  ② 点击选择文件，上传之前下载的备份文件（.tar.gz）；
  ③ 选择恢复类型（如完整恢复），点击开始恢复；
  ④ 等待恢复完成，重启Jellyfin服务即可。

2. 手动恢复数据目录（基础方法）

适用于手动备份的场景，需覆盖原有数据目录。

• 操作步骤：
  ① 停止Jellyfin服务：sudo systemctl stop jellyfin；
  ② 删除或备份原有/var/lib/jellyfin目录（避免冲突）：sudo mv /var/lib/jellyfin /var/lib/jellyfin_old；
  ③ 解压备份文件到目标目录：sudo tar -xzvf jellyfin_backup.tar.gz -C /var/lib/；
  ④ 启动Jellyfin服务：sudo systemctl start jellyfin；
  ⑤ 检查数据完整性（如媒体库是否正常加载）。

3. 使用rsync恢复（同步远程备份）

若备份在远程服务器，可通过rsync反向同步恢复数据。

• 操作步骤：
  ① 停止Jellyfin服务；
  ② 执行同步命令（将远程备份同步到本地）：sudo rsync -avz -e ssh user@remote_host:/path/to/backup/jellyfin /var/lib/；
  ③ 启动Jellyfin服务；
  ④ 验证数据是否恢复。

4. Docker容器恢复（适用于Docker部署）

若之前备份了Docker容器的/config目录，可重新创建容器并挂载备份目录。

• 操作步骤：
  ① 停止并删除旧容器：sudo docker stop jellyfin && sudo docker rm jellyfin；
  ② 重新运行容器，挂载备份的/config目录和媒体目录：sudo docker run -d --name jellyfin -p 8096:8096 -v /mnt/backup/jellyfin_config:/config -v /path/to/media:/media jellyfin/jellyfin；
  ③ 启动容器后，检查配置是否恢复（如媒体库、用户设置）。