常见问题

1. 启动与登录

启动失败 / 授权过期

检查 EMAIL（或 DJANGO_SUPERUSER_EMAIL）和 TOKEN 环境变量是否正确填写
检查授权文件是否生成并放入 db 文件夹

这两项都必须填写才能启动 Docker 容器。

参考安装教程中的 Compose 和 .env 配置。

下载授权文件失败

Docker 容器内部一直下载授权文件失败的，可以使用下面的命令手动下载授权文件：

curl -s -D - "https://repeat.ptools.fun/api/user/auth/file" --data-raw "{\"email\":\"你的邮箱\",\"token\":\"你的授权码\"}" -o encrypted_key.bin

# 例子
curl -s -D - "https://repeat.ptools.fun/api/user/auth/file" --data-raw "{\"email\":\"100000@qq.com\",\"token\":\"eyJhbGciOiJIUzI1NiIpXVCJ9.eyJNzM5ODh9.XIu9p-CAk8x0R-LE\"}" -o encrypted_key.bin

登录失败

检查：

服务器地址是否包含 http:// 或 https://。
后端服务是否可访问。
后端是否已完成初始化。
账号和密码是否正确。
Web 端是否被 CORS 或 HTTPS 混合内容限制。
Web 端是否部署在正确的后端地址下。

APP 一直报 401 错误

这种是 Docker 验证 auth 失败，直接在 APP 端退出重新登录即可。

APP 一直报 404 错误

APP 端报 404 错误多数是后端地址填写错误、反向代理路径错误、服务未启动或访问到了旧端口导致。Go Harvest 默认 WebUI / API 端口是 5173。

解决方案：

检查 APP 中填写的服务器地址是否为 Go Harvest 地址，例如 http://192.168.1.2:5173。
浏览器访问 http://服务器IP:5173/api.json，确认后端 OpenAPI JSON 能正常返回。
检查 Compose 是否映射了 5173:5173，如果改过宿主机端口，以左侧端口为准。
检查容器日志：docker logs -f go-harvest。
如果使用反向代理，确认代理同时转发 WebUI、API、WebSocket / SSE 请求。

如果日志中出现 Redis 相关异常，可以配置外置 Redis：

CACHE_REDIS_CONNECTION=redis://192.168.1.2:6379/15

2. 站点问题

站点刷新或签到失败

检查：

Cookie 是否过期。
User-Agent 是否与 Cookie 来源一致。
站点配置是否正确。
站点是否启用。
站点是否需要代理。
后端是否能访问该站点。
服务端日志中的站点错误。

签到失败

部分站点有盾，目前无法签到：
- 红叶、我堡、优宝、农场、猪猪
北洋军阀站点限制，抓到自动签到会 BAN，故不支持自动签到
限时签到（有可能是服务器时间设置不准确）：U2、海胆均设置在上午 9 点以后才执行签到

天空、皇后如何自动签到

在 APP 系统设置中添加百度 OCR 信息。

百度 OCR 获取方式

做种体积拿不到

请检查 UID 是否正确。

注册时间不正确

请安装并登录浏览器插件后，访问控制面板，看到站点添加成功或者更新成功后刷新站点数据。

皇后拿不到时魔

检查 Cookie 中是否有 c_lang_folder= 这个字段，如果有 c_lang_folder=cht 请修改为 c_lang_folder=chs 后保存重试。

数据更新失败 / 注册日期异常

检查代理地址
检查 Cookie
检查 UID 是否填写

如何自己添加站点

映射 /app/sites 文件夹，然后里面会有配置文件，你可以参照相似的站点尝试处理规则，也可以发站点给我进行适配。详细教程见自行适配。

`Invalid scheme component` 错误

更新站点数据时报错：Invalid scheme component

这种一般都是代理地址不完整导致的，代理地址必须带上协议，也就是 scheme：http:// 或者 socks5://。

如果你在环境变量里面设置了错误的代理地址，可以修改环境变量后，在 APP 右上角的加号里选择批量设置修改站点信息中错误的代理地址。

Cannot connect to host xxxxxx.xxx

网络问题，请稍后重试，尝试增删代理。

3. 下载器问题

下载器连接失败

检查：

下载器主机、端口、协议是否正确。
用户名和密码是否正确。
下载器 Web UI 是否启用。
后端服务器是否能访问下载器地址。
qBittorrent / Transmission 类型是否选择正确。
是否需要配置 External Host。

辅种相关问题

详见下载器与种子 - 辅种。

4. 代理设置

默认代理设置

站点代理建议在 APP / WebUI 中按站点配置，或使用批量替换功能统一调整。

如果导入站点后因为代理配置错误导致无法抓取数据和签到，可以在 APP 右上角打开批量功能，选择代理，填入正确代理地址，例如 http://xxxxx.xxxxx:xxx，点击执行即可批量替换。

代理地址必须带协议，例如 http:// 或 socks5://。

批量替换 UA

在 APP 右上角有个批量功能，点击打开窗口，选择 UserAgent，填入新的 UA，点击执行即可批量替换。

5. 搜索问题

搜索资源没有结果

检查：

是否已有可搜索的站点。
搜索设置中是否关闭了站点参数。
最大站点数是否过小。
关键词是否过于严格。
站点 Cookie 是否可用。
后端资源搜索接口是否正常。

6. 通知问题

通知收不到

检查：

设置中心中的通知 WebHook 和 Token 是否正确。
通知开关是否启用。
系统通知权限是否允许。
后端任务是否实际产生通知。

微信机器人通知如果返回 ret=-2，通常需要先给微信机器人发送一条消息以激活会话。

更多通知通道排查见通知配置。

7. Emby 联动

假如，你的收割机访问地址是：http://192.168.1.2:5173，那么，你的 Emby 联动地址就是：

http://192.168.1.2:5173/api/option/emby/webhook

然后打开 Emby，进入设置，在首选项中找到通知：

# 当下仅支持这几种事件，不在列表的会发送一条 Emby 事件内容的消息
event_map = {
        "library.new": "媒体入库",
        "library.deleted": "资源删除",
        "system.notificationtest": "通知测试",
        "user.authenticated": "用户登录",
        'playback.start': "开始播放",
        'playback.pause': "暂停播放",
        'playback.unpause': "恢复播放",
        'playback.stop': "停止播放",
    }

添加通知 => WebHooks 通知：

8. 日志与调试

日志页面

Go Harvest 日志主要通过 APP / WebUI 的「日志中心」和「日志浮窗」查看。遇到登录失败、站点刷新失败、下载器连接失败或任务异常时，优先查看服务端日志。

Docker 侧也可以直接查看容器日志：

docker logs -f go-harvest

如果容器名不是 go-harvest，以你的 Compose container_name 为准。

常见异常方向：

授权失败：检查 EMAIL 或 DJANGO_SUPERUSER_EMAIL，以及 TOKEN。
WebUI 无法访问：检查 Compose 是否映射 5173:5173，以及容器健康检查是否通过。
端口占用：修改 Compose 左侧宿主机端口，例如 18080:5173。
PostgreSQL 连接失败：检查数据库服务健康状态、库名、用户名和密码。

打开调试日志

需要排查站点解析、下载器连接、辅种目录、任务执行等问题时，可以临时打开调试日志。

在 Compose 的 harvest 服务中添加或修改环境变量：

environment:
  LOGGER_LEVEL: "debug"

或者在 db/.env 中写入：

LOGGER_LEVEL=debug

然后重启容器：

docker compose up -d

排查完成后建议改回 info，避免日志过多。

日志浮窗一直显示连接中

检查：

服务端日志接口是否可访问。
Token 是否有效。
浏览器网络面板中 SSE 是否持续连接。
服务端是否返回标准 SSE 或单行 data: {...} 日志事件。

9. APP 问题

Web 端布局异常

Web 端没有本地窗口按钮，也不会预留窗口控制空间。如果出现 header 偏移，刷新页面或检查是否使用了桌面客户端构建。

桌面端窗口尺寸没有恢复

窗口尺寸只在桌面端保存。最大化、最小化、全屏时不会覆盖保存尺寸。请先恢复到普通窗口状态并调整大小，再关闭和重新打开 APP。