Jellyfin在Ubuntu上的备份与恢复方法

Jellyfin在Ubuntu上的备份与恢复方法

一备份与恢复总览

二原生备份与恢复（APT安装）

备份步骤
1. 停止服务：sudo systemctl stop jellyfin
2. 打包配置与数据：sudo tar -czvf jellyfin_backup_$(date +%F).tar.gz -C /var/lib/jellyfin .
3. 备份媒体库（示例）：sudo rsync -avz /path/to/media /path/to/backup/
4. 如需远程/云端存储，可将归档复制到外部介质或对象存储。
恢复步骤
1. 先安装同版本Jellyfin（如通过APT），再停止服务：sudo systemctl stop jellyfin
2. 恢复配置：sudo tar -xzvf jellyfin_backup_YYYY-MM-DD.tar.gz -C /var/lib/jellyfin
3. 恢复媒体：sudo rsync -avz /path/to/backup/media/ /path/to/media/
4. 启动服务：sudo systemctl start jellyfin
5. 登录Web管理端（默认端口8096）检查用户、插件与库是否正常。

三 Docker部署的备份与恢复

备份步骤
1. 停止容器：docker stop jellyfin
2. 备份配置目录：docker cp jellyfin:/config /path/to/backup/jellyfin-config
3. 备份媒体（宿主机路径）：rsync -avz /path/to/media /path/to/backup/media
恢复步骤
1. 启动新容器并挂载已备份的配置与媒体（注意路径映射保持一致）：
```
docker run -d --name jellyfin \
  -p 8096:8096 \
  -v /path/to/backup/jellyfin-config:/config \
  -v /path/to/media:/media \
  jellyfin/jellyfin
```
2. 首次启动后检查控制台与日志，确认插件、用户与库加载正常。

四跨系统或路径变更的迁移增强

当从Windows迁移到Linux、或更改了媒体库路径时，可使用开源迁移工具Jellyfin-Migrator自动处理路径差异与ID映射，尽量保留用户、观看记录与插件数据。
基本流程
1. 在新服务器安装同版本Jellyfin并可达Web界面。
2. 克隆并配置脚本中的源/目标路径映射（支持Docker内外路径替换）。
3. 运行迁移脚本，完成后在新环境启动Jellyfin并核对日志与功能。

五自动化与注意事项

自动化与系统级备份
- 可用Timeshift做系统级快照（含配置与程序），适合回滚系统状态；对媒体库建议单独用rsync做周期性增量备份。
关键注意事项
- 备份前尽量停止Jellyfin，减少数据库不一致风险；恢复后确保**/var/lib/jellyfin**与媒体目录的所有权和权限正确（Jellyfin运行用户需可读写）。
- 迁移或恢复后如出现媒体“未找到/扫不到”，多为路径映射不一致，需在Jellyfin控制台重新检查媒体库路径或在迁移工具中完善路径替换规则。
- 若使用Docker，务必保持卷挂载路径与备份时一致；变更挂载路径通常需要重新配置库路径或借助迁移工具修正。

最新问答