收割机使用指南

1. 安装部署

当前推荐使用 Go Harvest 服务端，安装配置以安装教程为准。

安装前需要准备：

授权邮箱：EMAIL 或 DJANGO_SUPERUSER_EMAIL。
授权 token：TOKEN。
Docker 和 Docker Compose。

部署建议：

正式长期使用优先选择 PostgreSQL。
试用、轻量单机或临时环境可以选择 SQLite。
WebUI 默认访问端口为 5173。
辅种需要映射下载器种子元数据目录，容器内路径建议统一放在 /downloaders 下。

常用访问地址：

WebUI: http://127.0.0.1:5173
初始化页面: http://127.0.0.1:5173/setup
Swagger UI: http://127.0.0.1:5173/swagger

完整 Compose 示例、环境变量、初始化和目录映射见安装教程。

2. 登录收割机

打开WEBUI或者使用APP、桌面客户端登录

登录界面

1. 登录端口确认

默认 WebUI 端口为 5173。如果 Compose 中映射为 5173:5173，浏览器访问：

http://服务器IP:5173

如果你自行修改了宿主机端口，以 Compose 左侧端口为准，例如 18080:5173 对应访问 http://服务器IP:18080。

2. 添加服务器

WEBUI 或 APP 打开后，如果后端尚未初始化，会进入初始化流程。初始化时需要选择数据库类型、填写数据库连接信息、创建管理员账号并生成 JWT Secret。

选择数据库

初始化用户

初始化完成后，使用创建的管理员账号登录。APP 中添加服务器时需要填写后端地址、用户名和密码，只有连接测试通过的服务器才能保存。

登录历史

3. 修改服务器信息

服务器信息添加完成后，如果修改了账号密码，可以双击服务器进行修改，保存同样需要先通过连接测试。

3. 添加基础系统设置

a. 添加消息通知

个人觉得，登录后的第一件事就是添加一个自己用的顺手的消息通知，收割机支持多种消息通知渠道，任选其一即可。

通知渠道、通知测试、企业微信、微信机器人和 QQ 机器人的配置方式统一见通知配置。

b. 添加安全Token

安全 Token 是接口访问工具使用的验证密码，请妥善保存，这个 Token 会用在油猴脚本、收割机浏览器插件，以及企业微信验证。
添加方法：在 APP 中打开系统设置，并添加油猴 Token，后期会改为安全Token，可以自定义，也可以使用随机按钮生成 Token，没有此选项的请点击右下角➕添加

c. 添加OCR文字识别服务【空和皇后签到使用】

申请刚百度 OCR 免费服务：教程地址
在系统设置中添加百度 OCR 相关配置

4. 导入站点

参考文章：导入站点

5. 添加计划任务

可用的计划任务有：

1. CloudFlare 测速【PT 站点多使用 CF 进行代理，连接性不太好，测速后效果能好一点】
2. 阿里云盘签到【阿里云盘签到，每个月需要更新一次 Token】
3. 抓取站点信息【所有站点数据都依托此任务】
4. 站点签到【签到，不用多说】
5. RSS 订阅【扫描 添加的 RSS 信息，订阅你需要的影视内容】
6. 辅种任务【这个也不用多少是干啥的了】

添加任务：

计划任务列表计划任务记录

任务执行时间支持指定时间和 Cron 表达式，如果你是高阶用户，可以打开高级选项进行更精细的设定，一般来说，分钟和小时两个选项已经够用。

指定时间：直接指定任务要执行的时间，比如，你需要 9 点10 分执行任务，就分钟填写 10，小时填写 9 即可。

Cron 时间：一般 Cron 网站都提供 6 位表达式，我们使用的是 5 位表达式，省去了第一位的秒，比如，你希望每天的 1 点、3 点、9 点、19 点、23 点更新数据，就可以指定一个固定的分钟时间，这里我指定未 13 分钟，小时部分直接填写：1,3,9,19,23，中间用英文逗号隔开，保存即可，任务会在每天的 1 点、3 点、9 点、19 点、23 点的 13 分执行，以此类推。

辅种

辅种只需要三步

在部署docker时映射下载器种子文件夹
添加下载器时关闭刷流
添加辅种计划任务

种子迁移

好多小伙伴儿都喜欢QB下载，TR保种，所以需要将种子从QB转移到TR

与辅种一样，需要提前映射种子文件夹，如果辅种任务已经映射过了，不需要重复操作

1. 在计划任务页面点击 + 按钮，选择转种任务

2. 填写任务名称，并选择源下载器和目标下载器

选中源下载器后，目标下载器会自动筛选统一服务器上的下载器

3. 选定转种范围

选中下载器后，会生成从源下载器默认下载文件夹到目标下载器默认文件夹的映射，请自行修改
映射规则说明：

映射以->箭头分割，前面是源下载器路径，后面是目标下载器路径
任务执行时从源下载器读取设定路径下的所有种子，推送到目标下载器设定路径，请保证前后路径都可以正常读取资源文件

4. 其他说明

目标为QB下载器时支持跳过校验
支持转种完成后删除源种子
- 删除时校验未通过的种子会忽略
- 从QB转种到TR时有几率会丢失Tracker信息，收割机在种子推送完成后会对种子Tracker进行校验，丢失Tracker的会从源下载器重新读取并更新到目标种子上
- 删种时也会忽略自动修复Tracker失败的种子