怎样在ubuntu上迁移jellyfin数据

在Ubuntu上迁移Jellyfin数据的完整步骤

迁移Jellyfin数据的核心是备份现有环境的配置与媒体文件，然后在目标Ubuntu系统（或同一系统的升级环境）中恢复这些数据。以下是详细操作流程：

一、准备工作

1. 确认现有环境信息
   记录当前Jellyfin的安装方式（Docker/系统包）、配置文件路径（通常为/etc/jellyfin或容器内的/config）、媒体文件存储路径（通常为/var/lib/jellyfin/media或自定义路径）、数据库类型（默认使用SQLite，若使用MySQL/PostgreSQL需额外备份数据库）。
2. 准备目标系统
   确保目标Ubuntu系统已安装与现有环境相同版本的Jellyfin（避免版本差异导致兼容性问题），并安装必要依赖（如ffmpeg、libicu等）。可通过sudo apt install ffmpeg libicu安装基础依赖。

二、备份现有Jellyfin数据

1. 停止Jellyfin服务

为避免数据不一致，迁移前必须停止Jellyfin服务：

sudo systemctl stop jellyfin

2. 备份配置文件

Jellyfin的配置文件（含用户设置、插件、转码规则等）通常位于/etc/jellyfin目录。使用tar命令打包备份：

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

备份文件默认保存在当前目录，可复制到外部存储（如U盘、NAS）：

sudo cp jellyfin_config_backup.tar.gz /mnt/external_drive/

3. 备份媒体文件

媒体文件（电影、电视剧、音乐等）的存储路径可通过Jellyfin管理界面（http://your_server_ip:8096 → 左侧“系统”→“存储”）查看，通常为/var/lib/jellyfin/media。使用rsync命令备份（保留文件属性且支持增量备份）：

sudo rsync -av /var/lib/jellyfin/media /mnt/external_drive/media_backup

若媒体文件存储在自定义路径（如/opt/media），需替换上述命令中的路径。

4. 备份数据库（仅非SQLite用户需要）

若Jellyfin使用MySQL/PostgreSQL数据库（默认使用SQLite，无需备份），需通过mysqldump或pg_dump导出数据库：

• MySQL示例：

  mysql -u root -p -e "CREATE DATABASE jellyfin_backup; GRANT ALL PRIVILEGES ON jellyfin_backup.* TO 'jellyfin_user'@'localhost';"
  mysqldump -u jellyfin_user -p jellyfin > /mnt/external_drive/jellyfin_db_backup.sql
  

• PostgreSQL示例：

  pg_dump -U jellyfin_user jellyfin > /mnt/external_drive/jellyfin_db_backup.sql
  

三、在目标Ubuntu系统上恢复数据

1. 安装Jellyfin

若目标系统未安装Jellyfin，可通过以下命令安装（以Ubuntu 22.04为例）：

sudo apt update
sudo apt install jellyfin

2. 恢复配置文件

将备份的配置文件复制到目标系统的/etc/jellyfin目录：

sudo tar -xzvf /mnt/external_drive/jellyfin_config_backup.tar.gz -C /etc

若使用Docker部署，需将配置文件复制到容器的/config目录（通过docker cp命令）。

3. 恢复媒体文件

将备份的媒体文件复制到目标系统的媒体存储路径（需与现有环境一致）：

sudo rsync -av /mnt/external_drive/media_backup/ /var/lib/jellyfin/media

4. 恢复数据库（仅非SQLite用户需要）

若使用了MySQL/PostgreSQL数据库，需导入备份的SQL文件：

• MySQL示例：

  mysql -u jellyfin_user -p jellyfin < /mnt/external_drive/jellyfin_db_backup.sql
  

• PostgreSQL示例：

  psql -U jellyfin_user jellyfin < /mnt/external_drive/jellyfin_db_backup.sql
  

5. 启动Jellyfin服务

恢复完成后，启动Jellyfin服务并设置开机自启：

sudo systemctl start jellyfin
sudo systemctl enable jellyfin

6. 验证迁移结果

访问Jellyfin管理界面（http://your_server_ip:8096），检查以下内容：

• 用户设置、插件是否正常；
• 媒体库是否显示原有文件；
• 转码规则、播放设备是否兼容。

四、注意事项

• 版本一致性：迁移前后Jellyfin版本需保持一致（如现有环境为10.8.0，目标环境也需安装10.8.0），避免因版本升级导致的数据库结构变化。
• 数据完整性：备份前停止Jellyfin服务，防止数据写入冲突；恢复后检查备份文件的权限（如媒体文件需属于jellyfin用户）。
• Docker特殊处理：若使用Docker部署，需备份容器的/config、/cache目录及挂载的媒体卷，恢复时重新创建容器并挂载备份的目录。
• 数据库备份：若使用SQLite（默认），数据库文件位于/var/lib/jellyfin/database.db，可直接备份该文件；若使用MySQL/PostgreSQL，需单独备份数据库。

通过以上步骤，即可完成Ubuntu系统上Jellyfin数据的完整迁移。迁移过程中如遇问题，可参考Jellyfin官方文档或社区论坛获取支持。