W

Watcharr

1.3k stars·影音下载·已提供 SHA-256 校验码,下载后可自行核对文件完整性

自托管的影视动漫与游戏追踪器,支持状态管理和评分。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

自己搭个影音打卡本,支持电影、剧集、动漫和游戏。

核心功能

  • 自托管,数据完全掌握在自己手里
  • 支持电影、电视剧、动漫、游戏四种内容类型
  • 可设置“已看/在看/计划/搁置”等状态并评分
  • 内置发现页和用户资料页,支持暗色主题
  • 通过 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 端口上没有任何服务在监听。

来源 Issue #994
故障排除
为什么 Watcharr 在 Trakt 导入过程中会因 "database is locked" 错误而将我登出?

出现这种情况是因为 Trakt 导入器将您的全部观看历史批量写入 SQLite 数据库,导致数据库被锁定,从而使身份验证查询失败(出现 401 'not authorized' 错误、被强制登出)。修复方法:将 Watcharr 更新到最新版本,新版本以 WAL (Write-Ahead Logging) 模式运行 SQLite,允许在导入期间进行并发读取。旧版本的临时解决办法:即使进度弹窗看起来卡住了,导入仍会在后台继续进行,因此请让它彻底完成(大量历史记录可能需要数小时),然后在数据库写入完成后重新登录。

来源 Issue #675

标签

self-hostedmovietvanimegamingtrackerdockerprivacy

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

步骤1:安装 Docker 和 Docker Compose

4

步骤2:下载项目根目录的 docker-compose.yml 文件

5

步骤3:在终端运行 docker-compose up -d

安装指引
  1. 步骤1:安装 Docker 和 Docker Compose
  2. 步骤2:下载项目根目录的 docker-compose.yml 文件
  3. 步骤3:在终端运行 docker-compose up -d
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

停止容器(docker-compose down),删除对应数据卷(docker volume rm watcharr_data)以清除所有数据。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议GPL-3.0
最后更新2026-10-26 22:36:28
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

2 FAQs

相似推荐