温馨提示×

CentOS怎么迁移Jellyfin

小樊
40
2026-07-08 16:11:25
栏目: 智能运维

在 CentOS 上迁移 Jellyfin 主要包括:迁移配置文件、媒体库、元数据、缓存、数据库等。下面按最稳妥、通用的方式一步步说明(适合从一台 CentOS 迁移到另一台,或重装系统后恢复)。


一、确认当前 Jellyfin 安装方式

先确认你是哪种方式安装的 Jellyfin:

1️⃣ RPM / 官方仓库安装(最常见)

rpm -qa | grep jellyfin

默认路径:

  • 配置目录:/etc/jellyfin/
  • 数据目录:/var/lib/jellyfin/
  • 缓存目录:/var/cache/jellyfin/
  • 日志目录:/var/log/jellyfin/

2️⃣ Docker 安装

docker ps | grep jellyfin

Docker 迁移主要就是:

  • 容器配置
  • 挂载的数据卷(media + config)

二、CentOS → CentOS(物理/虚拟机迁移)

✅ 推荐方式:完整目录迁移


三、在“旧服务器”上备份

1️⃣ 停止 Jellyfin

systemctl stop jellyfin

2️⃣ 备份关键目录

mkdir -p /root/jellyfin_backup
cd /root/jellyfin_backup

tar czvf jellyfin_config.tar.gz /etc/jellyfin
tar czvf jellyfin_data.tar.gz /var/lib/jellyfin
tar czvf jellyfin_cache.tar.gz /var/cache/jellyfin

最重要/var/lib/jellyfin(包含数据库、元数据)


3️⃣ 备份媒体文件(如果有)

tar czvf media.tar.gz /data/media

或只记录路径(推荐)


四、在“新服务器”上安装 Jellyfin

1️⃣ 安装依赖

yum install -y epel-release

2️⃣ 添加 Jellyfin 官方仓库

rpm --import https://repo.jellyfin.org/jellyfin_team.gpg
cat > /etc/yum.repos.d/jellyfin.repo <<EOF
[jellyfin]
name=Jellyfin Repository
baseurl=https://repo.jellyfin.org/yum/stable/centos/\$releasever/\$basearch
enabled=1
gpgcheck=1
gpgkey=https://repo.jellyfin.org/jellyfin_team.gpg
EOF

3️⃣ 安装 Jellyfin

yum install -y jellyfin

五、恢复 Jellyfin 数据(关键步骤)

1️⃣ 停止新服务器上的 Jellyfin

systemctl stop jellyfin

2️⃣ 恢复配置和数据

tar xzvf jellyfin_config.tar.gz -C /
tar xzvf jellyfin_data.tar.gz -C /
tar xzvf jellyfin_cache.tar.gz -C /

确保目录权限正确:

chown -R jellyfin:jellyfin /etc/jellyfin
chown -R jellyfin:jellyfin /var/lib/jellyfin
chown -R jellyfin:jellyfin /var/cache/jellyfin

3️⃣ 恢复媒体文件(如有)

tar xzvf media.tar.gz -C /

六、启动并验证

systemctl enable jellyfin
systemctl start jellyfin

访问:

http://新服务器IP:8096

✅ 用户、媒体库、元数据、播放记录都会保留


七、如果是 Docker 迁移(简要)

1️⃣ 备份

docker stop jellyfin
cp -a /docker/jellyfin /backup/jellyfin

2️⃣ 新服务器恢复

docker run -d \
  --name jellyfin \
  -v /backup/jellyfin/config:/config \
  -v /data/media:/media \
  -p 8096:8096 \
  jellyfin/jellyfin

八、常见问题

❓ 迁移后无法播放

  • 检查媒体目录权限
chmod -R 755 /data/media

❓ 用户密码失效

  • 数据库已迁移,不会失效
  • 若异常,可重置密码

九、迁移清单(速查)

项目 是否必须
/var/lib/jellyfin ✅ 必须
/etc/jellyfin ✅ 必须
/var/cache/jellyfin 可选
媒体文件 可选
用户权限 ✅ 必须

如果你愿意,可以告诉我:

  • CentOS 7 还是 8 / Stream?
  • RPM 还是 Docker?
  • 是否跨服务器?

我可以给你一份完全针对你环境的迁移命令清单

0