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,首次进入按引导创建管理员账号即可。
快速上手
- 注册 / 登录账号
- 点击「+ Add」按钮,搜索想加入清单的内容(支持中文/英文片名)
- 选择状态(想看 / 在看 / 已看完)和评分
- 在 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 体验还是更胜一筹。
⚠️ 注意事项
- TMDB API Key 必需:内容元数据依赖 TMDB,注册账号 → 申请 API Key → 填入配置。首次启动没填会卡在搜索步骤。
- 公网访问需自备反向代理:官方只暴露 9494 端口,HTTPS 需要 Nginx / Caddy 反代,Let's Encrypt 自动签证书。
- 数据备份:所有数据存在本地 SQLite 文件(
/config/db.sqlite),定期备份这个文件即可,丢了等于清单全没。 - 1.4k Stars 但仍在快速迭代:当前 1924 commits,14 个 open PR,v4.1.1 刚发布,功能 API 可能小范围调整,部署前看 changelog。
- 中文搜索偶发匹配不到:TMDB 英文数据为主,纯中文标题(如《三体》)建议搜索英文名
Three-Body再添加。 - 游戏追踪较基础:游戏分类只支持元数据展示,没有 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