如何把Jellyfin、Plex、Emby连进Scrob?媒体库双向同步完全指南

原创2026-11-15 10:44:491,700 阅读

如何把Jellyfin、Plex、Emby连进Scrob?媒体库双向同步完全指南

刚部署好 Scrob 却不知道从哪下手?这篇文章手把手教你把 Jellyfin、Plex、Emby 接入 Scrob——这款自托管的观影记录应用(相当于你的私人 Letterboxd + Trakt),能从三大媒体服务器双向同步媒体库、观看历史和评分。全程只需 10 分钟,无需编写任何代码。

Scrob 电影详情页:同步后的媒体库展示观看状态、评分和继续观看进度

为什么需要媒体库双向同步?

很多人用 Jellyfin / Plex / Emby 管理本地影片,但看完一部电影后:

  • 想看"上次看到第几分钟",得翻播放器历史
  • 想看自己打过分的全部影片,得手动记笔记
  • 换设备继续看时,进度和"已看"状态各设备不一致

Scrob 的解决方案:把媒体服务器里的内容拉取(Pull) 到自己的观影记录里,同时把在 Scrob 里标记的已看、评分、进度推送(Push) 回服务器——这就是所谓的双向同步。此外,Scrob 还支持 Trakt、Simkl、Stremio 等平台的同步,全部集中在一个界面管理。

第一步:快速部署 Scrob

官方推荐使用 Docker 部署(标准镜像或内置数据库的 omnibus 单容器镜像),核心步骤:

  1. 准备 docker-compose.yaml(仓库根目录提供了现成模板 docker-compose.yaml)
  2. 修改两个必填项:数据库密码和 SECRET_KEY(可用 openssl rand -hex 32 生成)
  3. 启动并打开 http://localhost:7330 注册账号
docker compose up -d

⚠️ 关键前提:连接媒体服务器前,先进 Settings → General 填入免费的 TMDB Read Access Token。Scrob 靠它把服务器里的影片匹配到元数据,缺失时同步效果会大打折扣。

第二步:把 Jellyfin、Plex、Emby 连进 Scrob

登录后进入 Connections → Media Players 页面(对应源码 frontend/src/pages/connections.astro),点击添加连接,三台服务器的连接方式如下:

服务器 需要填写 说明
Jellyfin 服务器地址 + API Key 在 Jellyfin 的 用户 → 高级 → API 密钥 中创建;另需填写 Jellyfin 用户 ID
Emby 服务器地址 + API Key 与 Jellyfin 流程一致,同样需要用户 ID
Plex 服务器地址 + Token 支持"Login with Plex" 账号登录;Webhook 功能需要 Plex Pass

保存后点 Test 验证连接。每个连接会单独存储地址、令牌和各类同步开关,数据模型定义在 backend/models/connections.py 中,方便理解各字段的含义。

第三步:配置同步方向(核心环节)

每添加一个连接,右侧会出现两块开关区:拉取方向(服务器 → Scrob) 和 推送方向(Scrob → 服务器),这就是双向同步的控制台。

Scrob 连接配置面板:勾选 Collection status、Watched status 等同步方向并设置拉取/推送间隔

拉取(Pull)可勾选的项目

  • Collection status:导入服务器里的全部电影/剧集到你的库
  • Watched status:导入已观看记录(含时间戳)
  • Ratings:导入评分(仅 Plex / Jellyfin / Emby 支持)
  • Playback progress:导入"继续观看"进度

推送(Push)可勾选的项目

  • Watched status:在 Scrob 里标记已看/未看,回写到服务器
  • Collection status:在 Scrob 里加入/移出收藏时同步到服务器
  • Playback progress / Ratings:进度与评分回写

💡 新手建议:先只开拉取项跑一次 Sync now / Pull 完成首导,确认无误后再开启推送项,避免误覆盖服务器数据。推送采用合并语义——只写入差异项,不会删除你在服务器里手动添加的其他内容。

进阶:用 Webhook 实现实时 Scrobbling

定时同步之外,Scrob 还支持实时记录:播放开始、进度、停止时,服务器通过 Webhook 立即通知 Scrob,你的"正在看"进度条和历史记录秒级更新。每个连接的专属 Webhook URL 直接显示在 Connections 卡片上,点一下即可复制。

Jellyfin Webhook 配置

  1. 安装 Webhook 插件并重启
  2. 添加 Generic Destination,粘贴 Scrob 提供的 URL
  3. 勾选事件:Playback Start、Playback Progress、Playback Stop、User Data Saved、Item Added、Item Deleted
  4. 勾选 Movies 和 Episodes
  5. ⚠️ Template 字段留空,并勾选 "Send all properties"(自定义模板会产生无效 JSON)

Plex Webhook 配置(需 Plex Pass)

  1. 在 plex.tv 账户页 → Webhooks → Add Webhook,粘贴 URL
  2. 回到 Scrob 的 Connections,填写你的 Plex 用户名,用于把事件归属到正确账户

Emby Webhook 配置

  1. 控制面板 → 通知 → 添加 Webhook,粘贴 URL
  2. 启用 Playback Start、Playback Stop、Item Added、Item Deleted

Emby 没有"播放进度"事件,Scrob 会在后台自动轮询 Emby 的 Sessions API 补齐实时进度,无需额外配置。

配置自动同步:真正的"双向"闭环

在连接卡片底部的 Auto Sync 区域分别设置:

  • Pull interval(拉取间隔):15 分钟 ~ 48 小时可选
  • Push interval(推送间隔):同上

开启后,你无论在服务器、手机 App 还是 Scrob 网页端操作,三端状态都会在间隔内自动对齐。

关于推送的几点安心设计(详见 README.md 的 Scheduling 章节):

  • 自动推送只发送上次推送以来的变化,服务器已接收且值相同的项会被跳过
  • 服务器上不存在的条目 24 小时内不会重复搜索
  • 手动点 Push 会全量对账一次;自动推送每周也会做一次全量对账,确保在服务器端直接改的值最多一周内被"纠正"回来

如果增量同步出现异常,点 Full resync 重建游标即可,不会清掉来自其他数据源(如 Trakt)的收藏记录。

常见问题速查

问题 解决方法
连接测试失败 检查 URL 是否带协议(http/https)、API Key 是否复制完整;Jellyfin/Emby 还需正确填写用户 ID
影片同步过来但没有海报/简介 确认 Settings → General 中已配置 TMDB Read Access Token
想重建某台的同步状态 点 Full resync,全量重读服务器
多用户各自连服务器 每个 Scrob 用户独立管理自己的连接,Webhook 事件按用户 ID/用户名自动归属

参考资料

按以上步骤操作,你的 Jellyfin、Plex、Emby 就都接进 Scrob 了——从此一处记录,多端同步,观影历史不再散落各处。🍿

登录后查看全文
scrob