Watcharr
自托管的影视动漫与游戏追踪器,支持状态管理和评分。
智能下载
前往项目主页
该项目暂未提供安装包,请直接访问源代码仓库
自己搭个影音打卡本,支持电影、剧集、动漫和游戏。
核心功能
- 自托管,数据完全掌握在自己手里
- 支持电影、电视剧、动漫、游戏四种内容类型
- 可设置“已看/在看/计划/搁置”等状态并评分
- 内置发现页和用户资料页,支持暗色主题
- 通过 Docker 一键部署,附带 docker-compose.yml
避坑指南
- •默认使用 TMDB 和 IGDB 获取元数据,需自行申请 API Key;首次启动需完成初始用户创建;游戏支持需额外配置 IGDB,否则仅显示影视内容。
适用场景
- 替代 Trakt 等第三方影音管理服务,保护观看记录隐私
- 家庭或小团队共享影视进度,比如追番、刷剧
- 游戏玩家同时记录游戏进程(需配置 IGDB)
详细介绍
Watcharr 是一款可轻松自托管的影音追踪工具,用于管理你看过、在看或计划观看的电影、电视剧、动漫,还能通过 IGDB 配置追踪电子游戏。基于 Go 和 Svelte 构建,提供现代响应式界面,支持暗色主题、用户主页、发现页和 Docker 一键部署。社区提供了 Kodi 插件等扩展。相比 Trakt 等第三方服务,它完全自托管,数据隐私可控。
常见问题与排障 (2)
故障排除为什么即使 Docker 映射了端口 3080,Nginx 反向代理到 Watcharr 仍然会超时?
Watcharr 在 **容器内部监听 3000 端口**,而不是 3080。在 Docker 端口映射中,格式为 HOST:CONTAINER,因此将主机端口 3080 映射到容器端口 3000:
services:
watcharr:
image: ghcr.io/sbondco/watcharr:latest
container_name: watcharr
ports:
- "3080:3000"
volumes:
- ./data:/data
restart: unless-stopped
应用更改:
docker compose up -d
如果 Nginx 运行在主机上,代理到已发布的主机端口:
location / {
proxy_pass http://127.0.0.1:3080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
如果 Nginx 运行在容器中,将两个容器放在同一个 Docker 网络上,并直接代理到容器端口:
proxy_pass http://watcharr:3000;
使用以下命令验证内部监听:
docker logs watcharr
你应该看到 Listening on http://0.0.0.0:3000。使用 3080:3080 会导致反向代理超时,因为 Watcharr 容器内部的 3080 端口上没有任何服务在监听。
故障排除为什么 Watcharr 在 Trakt 导入过程中会因 "database is locked" 错误而将我登出?
出现这种情况是因为 Trakt 导入器将您的全部观看历史批量写入 SQLite 数据库,导致数据库被锁定,从而使身份验证查询失败(出现 401 'not authorized' 错误、被强制登出)。修复方法:将 Watcharr 更新到最新版本,新版本以 WAL (Write-Ahead Logging) 模式运行 SQLite,允许在导入期间进行并发读取。旧版本的临时解决办法:即使进度弹窗看起来卡住了,导入仍会在后台继续进行,因此请让它彻底完成(大量历史记录可能需要数小时),然后在数据库写入完成后重新登录。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
步骤1:安装 Docker 和 Docker Compose
步骤2:下载项目根目录的 docker-compose.yml 文件
步骤3:在终端运行 docker-compose up -d
- 步骤1:安装 Docker 和 Docker Compose
- 步骤2:下载项目根目录的 docker-compose.yml 文件
- 步骤3:在终端运行 docker-compose up -d
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载,并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器(docker-compose down),删除对应数据卷(docker volume rm watcharr_data)以清除所有数据。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
2 FAQs