bellamy/scrob

Scrob - 开源自托管媒体追踪工具

Scrob可同步Jellyfin、Plex、Emby的媒体库，追踪你的观看历史、评分和个人列表，并将活动推回Trakt — 所有功能通过简洁的Web界面实现，且支持作为PWA安装到任意设备。

核心功能

• 多源同步：从Jellyfin/Plex/Emby导入完整库、观看历史和评分，增量同步保持更新。
• 实时追踪：通过Webhook自动更新观看状态，无需手动同步。
• Trakt集成：双向同步观看历史和评分。
• 观看记录与评分：追踪所有影视内容，支持10分制评分及评论。
• 季节评分：单独为剧集季节评分。
• 个人列表：创建影视列表，支持公开分享。
• 社交功能：关注其他用户并查看其活动。
• TMDB集成：获取丰富元数据（海报、演员、预告片等）。
• 搜索：跨影视、人物、合集的全局搜索。
• PWA支持：在安卓、iOS或桌面设备上安装为原生应用。
• 单容器部署：前后端打包为单个镜像，无需管理多个服务。

使用场景

• 个人/家庭用户管理本地媒体库，追踪观看进度和评分。
• 希望将本地观看活动同步到Trakt的用户。
• 需要自托管解决方案保护隐私的用户。
• 整合Radarr/Sonarr实现影视添加的用户。

部署与配置

前置条件

• Docker及Docker Compose
• TMDB API密钥（免费获取：https://www.themoviedb.org/settings/api%EF%BC%89

Docker Compose部署

1. 下载配置文件：

bash
curl -o docker-compose.yaml https://raw.githubusercontent.com/ellite/scrob/main/docker-compose.yaml

2. 编辑文件替换必填项：

yaml
services:
  scrob-db:
    container_name: scrob-db
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: scrob
      POSTGRES_PASSWORD: 替换为自定义密码        # ← 修改
      POSTGRES_DB: scrob
    volumes:
      - db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U scrob -d scrob"]
      interval: 5s
      timeout:5s
      retries:10

  scrob:
    container_name: scrob
    image: bellamy/scrob:latest
    restart: unless-stopped
    depends_on:
      scrob-db:
        condition: service_healthy
    ports:
      - "7330:7330"
    environment:
      DATABASE_URL: postgresql+asyncpg://scrob:替换为上述密码@scrob-db:5432/scrob   # ← 匹配密码
      SECRET_KEY: 替换为随机密钥               # ← 生成：openssl rand -hex 32
      TZ: UTC

volumes:
  db_data:

3. 启动服务：

bash
docker compose up -d

Docker Run部署

bash
# 创建网络
docker network create scrob-net

# 启动数据库
docker run -d \
  --name scrob-db \
  --network scrob-net \
  --restart unless-stopped \
  -e POSTGRES_USER=scrob \
  -e POSTGRES_PASSWORD=自定义密码 \
  -e POSTGRES_DB=scrob \
  -v scrob_db:/var/lib/postgresql/data \
  postgres:16-alpine

# 启动Scrob
docker run -d \
  --name scrob \
  --network scrob-net \
  --restart unless-stopped \
  -p 7330:7330 \
  -e DATABASE_URL="postgresql+asyncpg://scrob:自定义密码@scrob-db:5432/scrob" \
  -e SECRET_KEY="$(openssl rand -hex 32)" \
  -e TZ=UTC \
  bellamy/scrob:latest

首次设置

1. 访问http://localhost:7330创建账户。
2. 进入设置→集成添加TMDB API密钥及Jellyfin/Plex/Emby连接。
3. 选择同步的库，从设置→同步触发首次同步。

关键配置变量

Webhook配置（实时追踪）

• Jellyfin：安装Webhook插件，添加Scrob的Jellyfin Webhook URL，启用播放相关事件。
• Plex：需Plex Pass，添加Webhook URL并在Scrob设置中填写Plex用户名。
• Emby：添加Webhook URL，启用播放事件。

许可证

Scrob基于GNU General Public License v3.0开源，详见https://github.com/ellite/scrob/blob/main/LICENSE%E3%80%82