Watcharr 是一款开源自托管追剧观影追踪系统,统一管理电影、剧集、动漫和游戏的观看清单、评分与状态。Go + Svelte 全栈架构 Docker 一键部署,内置热门发现、深色主题、海报墙布局、多用户认证、演员档案与个性化统计,GPLv3 协议完全免费。

🎤 引言

追剧党的日常痛点:Netflix 一部剧、IMDb 一部电影、Steam 一个游戏、B站几部番——散落在七八个平台里的「想看列表」永远对不上号。更崩溃的是,想跟朋友安利「我最近看了啥」时,自己都记不清进度和评分。

Trakt 这类云端服务虽然好用,但免费版阉割严重、订阅年年涨价、还时不时改 API 规则把第三方客户端搞崩。能不能有个一次搞定电影、剧集、动漫、游戏,开源免费、数据归自己、UI 还过得去的方案?

Watcharr 就是冲着这个需求来的——自托管追剧观影追踪系统,GitHub 1.4k Stars(截至 2026-07-26),Go + Svelte 全栈架构,Docker 一键起跑。


⭐ 核心功能

1. 四大类内容统一管理

Watcharr 把电影、电视剧、动漫、游戏四类内容塞进同一个清单,不再切换四五个 App。添加时直接搜索,刮削器自动拉封面、演员表、类型、片长等元数据,手动录入字段的苦活儿省了。

每条内容都支持以下状态流转:

  • 想看 (Planned)
  • 在看 (Watching)
  • 已看完 (Watched)
  • Dropped (弃坑)

打分系统内置 1-10 分制,配合评论功能做私人观影笔记。

2. 内置热门发现 (Discovery)

不用打开 IMDb 找新片,Watcharr Dashboard 直接集成 Trending / Popular 模块,按日/周筛选当下热门电影和剧集。看到感兴趣的一键「加入清单」,从发现到入库一条龙。

最新 v4.1.1(2026-07-26 发布)版本对 Discovery 卡片展示做了优化,封面加载和点击响应都更顺滑。

3. 多用户认证 + 个人统计

每个用户独立账号,追踪记录互不干扰。个人页内置统计面板:

  • 年度观看总数
  • 类型偏好饼图(动作 / 喜剧 / 科幻占比)
  • 月度观看趋势图
  • 平均评分曲线

对数据控来说,光看自己一年追了多少部剧就够上头。

4. 深色主题 + 现代 UI

基于 SvelteKit 写的界面,响应速度快、动效克制,提供完整的深色主题。原生支持 Plex 风格海报墙布局,海报按宽高比自动适配,不会出现拉伸变形的惨案。

UI 设计参考了 Jellyfin / Sonarr 那一挂的现代媒体栈审美,对自托管玩家极其友好。

5. 演员 / 制作团队档案

点进任意演员或导演的详情页,能看到他/她参演或执导的所有作品(按你的清单过滤)。适合「我喜欢这个导演,下一部要不要追」的场景。


📥 安装与使用

环境要求

  • Docker + Docker Compose(推荐方式)
  • 或 Node.js 18+ / Go 1.21+ 自行编译
  • 数据库:内置 SQLite,零外部依赖
  • 资源占用:实测 256MB 内存即可运行

Docker Compose 一键部署

官方 README 提供了开箱即用的 docker-compose.yml:

version: "3"
services:
  watcharr:
    image: ghcr.io/sbondco/watcharr:latest
    container_name: watcharr
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/config
    ports:
      - 9494:9494
    restart: unless-stopped

启动后浏览器访问 http://your-ip:9494,首次进入按引导创建管理员账号即可。

快速上手

  1. 注册 / 登录账号
  2. 点击「+ Add」按钮,搜索想加入清单的内容(支持中文/英文片名)
  3. 选择状态(想看 / 在看 / 已看完)和评分
  4. 在 Dashboard 查看个人统计和热门发现

官方文档:https://watcharr.app

项目仓库:GitHub - sbondCo/Watcharr


🎯 适用场景

  • 追剧量大的多平台用户:Netflix + 迪士尼+ + HBO + B站 + Steam 用户,一个清单统管所有内容。
  • 数据隐私敏感党:不愿把观看记录交给 Trakt / Letterboxd 这类 SaaS,希望数据掌握在自己手里。
  • NAS / Home Lab 玩家:已经在跑 Jellyfin / Sonarr / *arr 套件,加个 Watcharr 补齐「追踪」环节很合理。
  • 影视博主 / 评论人:需要一个本地化的私人影评库,按类型 / 评分 / 演员维度快速检索。
  • 朋友 / 情侣共享清单:多用户认证让两人各看各的统计,又能看到对方最近追了什么。

不太适合:纯手机端轻量用户(自托管需要公网 IP 或内网穿透,移动 App 暂未提供,需用浏览器访问)。


🔍 对比 / 替代方案

工具部署方式内容类型评分系统统计面板多用户费用
Watcharr自托管 Docker电影/剧集/动漫/游戏1-10免费
Trakt云端 SaaS电影/剧集1-10✅ 基础订阅 $5/月
Letterboxd云端 SaaS仅电影1-5免费带广告
SIMKL云端 SaaS电影/剧集/动漫1-10免费 + Premium
Taiga自托管电影/剧集1-10基础免费

Watcharr 的优势很明显:自托管 + 四类内容 + 完整统计 + 多用户,这个组合在同类里很少见。Trakt 免费版阉割统计,Letterboxd 只管电影,SIMKL 没多用户——Watcharr 把这些痛点一次性补齐。

缺点也很诚实:GitHub Issues 显示当前 125 个 open issues,缺少官方移动端 App,依赖 TMDB 刮削(TMDB API Key 需要自己申请)。如果你只想要最轻量的电影记录,Letterboxd 的 App 体验还是更胜一筹。


⚠️ 注意事项

  1. TMDB API Key 必需:内容元数据依赖 TMDB,注册账号 → 申请 API Key → 填入配置。首次启动没填会卡在搜索步骤。
  2. 公网访问需自备反向代理:官方只暴露 9494 端口,HTTPS 需要 Nginx / Caddy 反代,Let's Encrypt 自动签证书。
  3. 数据备份:所有数据存在本地 SQLite 文件(/config/db.sqlite),定期备份这个文件即可,丢了等于清单全没。
  4. 1.4k Stars 但仍在快速迭代:当前 1924 commits,14 个 open PR,v4.1.1 刚发布,功能 API 可能小范围调整,部署前看 changelog。
  5. 中文搜索偶发匹配不到:TMDB 英文数据为主,纯中文标题(如《三体》)建议搜索英文名 Three-Body 再添加。
  6. 游戏追踪较基础:游戏分类只支持元数据展示,没有 Steam 库自动同步,未来版本可能会加。

✅ 总结

Watcharr 是当下自托管追剧观影追踪领域里,少有的「四类内容 + 多用户 + 完整统计」三合一方案。Go + Svelte 的技术栈决定了它跑得轻、对机器要求低,Docker 部署一分钟搞定。深色主题 + 现代 UI 审美也跟得上时代,不是那种上古 PHP 风的老旧界面。

推荐指数 ⭐⭐⭐⭐(4/5):自托管 + 数据自主 + 功能完整的吸引力很大,扣一星是因为还在快速迭代、移动端体验缺失、中文搜索偶发匹配不到。

适合:追剧量大的多平台用户、Home Lab 玩家、影视博主、隐私敏感党。

不太适合:纯手机端用户、只追电影且不需要统计的人(直接用 Letterboxd App 更省事)。

如果你已经在跑 Jellyfin / Sonarr 套件,加个 Watcharr 几乎零成本——同一个 Docker 网络,端口暴露做反代,整个媒体生态就更完整了。

官方文档:https://watcharr.app
GitHub:https://github.com/sbondCo/Watcharr