温馨提示×

centos jellyfin如何迁移

小樊
38
2026-08-03 20:40:43
栏目: 智能运维

CentOS 上迁移 Jellyfin,通常分为 同机迁移(换目录/磁盘)跨服务器迁移 两种场景。下面按最常用、最稳妥的方式给你一个完整流程。


一、迁移前准备

1️⃣ 确认 Jellyfin 安装方式

先确认你是怎么装的(影响路径):

rpm -qa | grep jellyfin

常见情况:

  • RPM 安装(官方仓库) ✅ 最常见
  • Docker 安装
  • 手动编译

下面以 RPM 安装 为主说明。


2️⃣ 停止 Jellyfin 服务

systemctl stop jellyfin
systemctl disable jellyfin   # 可选

二、Jellyfin 关键目录说明(CentOS)

目录 说明
/etc/jellyfin 配置文件
/var/lib/jellyfin 数据库、元数据、用户数据
/var/log/jellyfin 日志
/usr/share/jellyfin 程序文件(一般不用迁移)
/var/cache/jellyfin 缓存(可不清)

核心迁移目录:

/etc/jellyfin
/var/lib/jellyfin

三、迁移方式一:同服务器迁移(换磁盘/目录)

1️⃣ 创建新目录(例如新磁盘)

mkdir -p /data/jellyfin/config
mkdir -p /data/jellyfin/data

2️⃣ 复制数据(保留权限)

cp -a /etc/jellyfin/* /data/jellyfin/config/
cp -a /var/lib/jellyfin/* /data/jellyfin/data/

⚠️ 一定要用 -a,否则权限会乱


3️⃣ 修改 Jellyfin systemd 配置

编辑 service 文件:

systemctl edit jellyfin

或者:

vi /usr/lib/systemd/system/jellyfin.service

修改以下两项:

Environment=JELLYFIN_CONFIG_DIR=/data/jellyfin/config
Environment=JELLYFIN_DATA_DIR=/data/jellyfin/data

保存后:

systemctl daemon-reload
systemctl start jellyfin

四、迁移方式二:跨服务器迁移(最推荐)

✅ 原服务器操作

1️⃣ 打包数据

tar czvf jellyfin-backup.tar.gz \
  /etc/jellyfin \
  /var/lib/jellyfin

2️⃣ 传输到新服务器

scp jellyfin-backup.tar.gz root@新服务器IP:/root/

✅ 新服务器操作

1️⃣ 安装 Jellyfin(先别启动)

dnf install jellyfin -y
# 或 yum

2️⃣ 解压覆盖

systemctl stop jellyfin

tar xzvf jellyfin-backup.tar.gz -C /

systemctl start jellyfin

五、迁移后常见问题

❌ 1. 权限错误(最常见)

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

❌ 2. 媒体库路径不一致

如果新服务器媒体路径变了:

  • 登录 Jellyfin Web
  • 控制台 → 媒体库
  • 修改文件夹路径
  • 重新扫描

不会丢失播放记录


❌ 3. SELinux 阻止访问

setenforce 0

或放行:

semanage fcontext -a -t httpd_sys_rw_content_t "/data/jellyfin(/.*)?"
restorecon -Rv /data/jellyfin

六、Docker 版迁移(如果你用的是 Docker)

docker stop jellyfin
cp -a /var/lib/docker/volumes/jellyfin-config /new/path

或修改 docker-compose.yml 中的 volume 路径。


七、迁移检查清单 ✅

  • [ ] 用户、密码正常
  • [ ] 媒体库识别
  • [ ] 播放记录、收藏保留
  • [ ] 插件正常
  • [ ] 元数据完整

八、我可以继续帮你

你可以直接告诉我:

  1. CentOS 7 还是 8 / Stream?
  2. RPM 还是 Docker?
  3. 同服务器还是换服务器?
  4. 是否换媒体路径?

我可以给你 精确到命令级别 的迁移方案。

0