常见问题

主辅分离

首先，要保证，要辅种的和下载的两个下载器映射的下载路径一致

这是下载器的路径映射

下载器 A下载器 B
种子路径/volume1/docker/download1/volume1/docker/download1这个可以不一致
物理路径（NAS 路径）/volume1/downloads/volume1/downloads保持一致
资源映射路径/downloads/downloads保持一致

收割机中的路径映射

下载器 A[qb]下载器 B[tr]
种子路径/volume1/docker/download1/config/qBittorrent/volume1/docker/download1/config
收割机内路径/downloaders/qbt1/downloaders/tr1各自映射
添加下载器时选择种子路径/downloaders/qbt1/downloaders/qbt1保持一致

然后，负责下载的，勾选刷流，保证不会对其辅种

img.png

然后，辅种的下载器的种子路径选择负责下载的下载器的种子路径 然后执行辅种任务即可

担心出问题的，可以使用下载器菜单上的辅种操作

抓不到发种数据

发种是技术活，很多人都没发过种，我发过种的几个站点都适配过了，如果你发过种的站点没抓到数据，找到你的发种历史，拷贝发种历史那一块的 HTML 代码给我，你给我 html 我才能去写 Xpath，或者参考自行适配搞一下，然后给 xpath 发我

步骤如下：

  1. F12打开开发工具窗口，

  2. 访问个人页面=> 点击发布种子

    img_1.png

  3. 在开发者工具=>网络，里面找到getusertorrentlistajax.php，点击，在右侧找到响应 img_2.png

  4. 如果你懂 xpath，直接提取发种数，不懂的可以拷贝所有内容发给我处理

    img_3.png

城市无法辅种

城市的 passkey 有问题，需要到种子列表页拷贝种子下载链接，然后提取 cuhash，填到 passkey 里面

img_4.png

在上图中左下角的小云朵上右键点击，复制链接，会得到一个如下所示的种子链接，提取 xxxx 部分，在收割机中填写到 passkey 部分保存即可

https://hdcity.city/download?id=62599&cuhash={xxxxxxxxxxxxxxxxxx}

下载授权文件失败

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

Invalid scheme component

更新站点数据时报错：Invalid scheme componentimg_5.png

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

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

做种体积拿不到的

请检查 uid 是否正确

注册时间不正确的

请在浏览器安装油猴脚本后，访问控制面板，看到站点添加成功或者更新成功后刷新站点数据

皇后拿不到时魔

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

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通知：

img_6.png

日志页面

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 连接失败：检查数据库服务健康状态、库名、用户名和密码。

img_7.png

打开调试日志

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

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

environment:
  LOGGER_LEVEL: "debug"

或者在 db/.env 中写入：

LOGGER_LEVEL=debug

然后重启容器：

docker compose up -d

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

隐私模式进入

在仪表盘页面长按，会跳出菜单，下拉可以看到隐私模式，勾选隐私模式，首页站点名称会显示为*

启动失败/授权过期

  1. 检查授权文件是否生成并放入 db 文件夹
  2. 检查环境变量中的 Token 与 Email 是否填写

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

签到失败

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

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

  1. 检查代理地址
  2. 检查 Cookie
  3. 检查 UID 是否填写

油猴不显示操作按钮

油猴安全验证已修复并生效，请按油猴教程添加油猴 Token

辅种时出现不再本下载器的种子

下载器种子目录映射必须是一对一的，请检查下载器种子目录是否映射并正确选择

默认代理设置

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

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

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

批量替换 UA

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

Cannot connect to host xxxxxx.xxx

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

每次辅种都有很多失败的，全部卡在校验0%动不了，怎么回事？

校验 0%，可能的原因：

  1. 种子文件夹映射或者选择错误 => 检查映射，并确认选择了正确的种子文件夹
  2. 种子资源文件被修改过文件加名字或者路径 => 只修改资源最外部文件或者文件夹名称的，程序已做了自动修正，其余的程序方面无能为力，可以手动修正资源名称或者报告站点

辅种结果解释

本次获取辅种数据，共31条辅种数据，耗时35.23秒。当前下载器:tr下载器 本次辅种成功推送195个种子，失败84个种子，等待校验的种子数量:1，本次辅种校验种子22个。
  1. 可能是站点已删种 => 从 IYUU 获取的数据，站点删种并不会通知 IYUU 删除对应种子，可以反馈给 IYUU
  2. 种子链接生成出错 => 部分站点种子下载链接生成非常规 PASSKEY 方式，已有部分站点做了处理，
    1. 海豹海豚，必须填写 AuthKey和 Passkey（可以在种子下载地址中获取对应 key）
    2. 馒头需要在线获取，程序已自动处理
    3. 城市的种子下载链接所用并非 PASSKEY，需要在种子列表页的种子下载链接中获取 https://hdcity.city/download?id={种子 id}&cuhash={所需 Key}

可以用WatchTower更新Docker吗

可以，镜像本身没有做任何限制

天空，皇后如何自动签到啊？

在App系统设置中添加百度ocr信息

百度ocr获取方式

如何自己添加站点

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

APP一直报401错误

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

img_8.png

APP一直报404错误

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

解决方案

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

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

CACHE_REDIS_CONNECTION=redis://192.168.1.2:6379/15
最近更新:
Contributors: ngfchl