如何把Jellyfin、Plex、Emby连进Scrob?媒体库双向同步完全指南
如何把Jellyfin、Plex、Emby连进Scrob?媒体库双向同步完全指南
刚部署好 Scrob 却不知道从哪下手?这篇文章手把手教你把 Jellyfin、Plex、Emby 接入 Scrob——这款自托管的观影记录应用(相当于你的私人 Letterboxd + Trakt),能从三大媒体服务器双向同步媒体库、观看历史和评分。全程只需 10 分钟,无需编写任何代码。
为什么需要媒体库双向同步?
很多人用 Jellyfin / Plex / Emby 管理本地影片,但看完一部电影后:
- 想看"上次看到第几分钟",得翻播放器历史
- 想看自己打过分的全部影片,得手动记笔记
- 换设备继续看时,进度和"已看"状态各设备不一致
Scrob 的解决方案:把媒体服务器里的内容拉取(Pull) 到自己的观影记录里,同时把在 Scrob 里标记的已看、评分、进度推送(Push) 回服务器——这就是所谓的双向同步。此外,Scrob 还支持 Trakt、Simkl、Stremio 等平台的同步,全部集中在一个界面管理。
第一步:快速部署 Scrob
官方推荐使用 Docker 部署(标准镜像或内置数据库的 omnibus 单容器镜像),核心步骤:
- 准备
docker-compose.yaml(仓库根目录提供了现成模板 docker-compose.yaml) - 修改两个必填项:数据库密码和
SECRET_KEY(可用openssl rand -hex 32生成) - 启动并打开
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 → 服务器),这就是双向同步的控制台。
拉取(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 配置
- 安装 Webhook 插件并重启
- 添加 Generic Destination,粘贴 Scrob 提供的 URL
- 勾选事件:
Playback Start、Playback Progress、Playback Stop、User Data Saved、Item Added、Item Deleted - 勾选
Movies和Episodes - ⚠️ Template 字段留空,并勾选 "Send all properties"(自定义模板会产生无效 JSON)
Plex Webhook 配置(需 Plex Pass)
- 在 plex.tv 账户页 → Webhooks → Add Webhook,粘贴 URL
- 回到 Scrob 的 Connections,填写你的 Plex 用户名,用于把事件归属到正确账户
Emby Webhook 配置
- 控制面板 → 通知 → 添加 Webhook,粘贴 URL
- 启用
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/用户名自动归属 |
参考资料
- 完整功能与部署文档:README.md
- 连接数据模型:backend/models/connections.py
- 连接管理前端页面:frontend/src/pages/connections.astro
- Webhook 处理后端:backend/routers/webhooks.py
- 各服务器适配器实现:backend/core/jellyfin.py、backend/core/plex.py、backend/core/emby.py
- 同步任务逻辑:backend/routers/sync.py
按以上步骤操作,你的 Jellyfin、Plex、Emby 就都接进 Scrob 了——从此一处记录,多端同步,观影历史不再散落各处。🍿

