cdzombak/plex-meta-migrator

plex-meta-migrator

该镜像提供的工具可在Plex媒体服务器的不同库之间迁移锁定的元数据字段或播放列表。工具通过文件名匹配源库和目标库中的媒体项，复制锁定元数据或重建播放列表。

核心功能

元数据迁移（默认）

复制源库项到目标库项的锁定元数据字段，包括：

• 简单字段：标题、摘要、标语、排序标题、工作室、内容评级等
• 标签字段：收藏集、类型、导演、编剧、标签、情绪、风格等
• 图片：海报（缩略图）和背景图

播放列表迁移（--playlist参数）

通过文件名匹配目标库中的项，将播放列表从一个服务器复制到另一个。不支持智能播放列表。

使用场景

• Plex服务器迁移时，保留媒体元数据和播放列表
• 调整Plex库结构（如拆分或合并库）时，迁移元数据
• 跨Plex服务器同步指定库的元数据或播放列表

配置说明

Docker运行方式

镜像可从Docker Hub获取：cdzombak/plex-meta-migrator

带持久化凭证运行

工具将凭证存储在/data/.creds.json，挂载卷到/data以持久化凭证：

bash
# 创建本地凭证目录
mkdir -p ~/.plex-meta-migrator

# 交互式运行，保留凭证
docker run -it --rm \
  -v ~/.plex-meta-migrator:/data \
  cdzombak/plex-meta-migrator

首次运行会提示输入Plex.tv凭证，认证后令牌保存到挂载卷，后续自动复用。

直接连接方式

bash
docker run -it --rm \
  cdzombak/plex-meta-migrator \
  --source-url http://192.168.1.100:32400 \
  --source-token YOUR_SOURCE_TOKEN \
  --dest-url http://192.168.1.101:32400 \
  --dest-token YOUR_DEST_TOKEN

命令行选项

-v, --version          显示版本并退出
--playlist             迁移播放列表而非元数据

源服务器（直接连接）：
  --source-url URL       源Plex服务器URL
  --source-token TOKEN   源Plex认证令牌

目标服务器（直接连接）：
  --dest-url URL         目标Plex服务器URL
  --dest-token TOKEN     目标Plex认证令牌

MyPlex认证：
  -u, --username USER    Plex.tv用户名
  -p, --password PASS    Plex.tv密码

许可证

GNU GPL v3；详见仓库中的LICENSE文件。

作者

Chris Dzombak

• dzombak.com
• https://github.com/cdzombak