Canlah Connector

Canlah Connector 是一个前台运行的命令行连接器：它把 Canlah Hive 下发的明确任务交给这台电脑上的 AdsPower Profile 执行。没有独立桌面界面，也不会在电脑上开放入站端口。

使用前准备

• Node.js 22.13 或更高版本
• AdsPower 已启动
• Reddit 账号已在各自的 AdsPower Profile 中手动登录
• 从 Canlah Hive 账号页自动生成的 6 位一次性配对码

启动

在 AdsPower 所在电脑打开终端，运行：

npx -y @canlah/connector@latest start

每次运行时，Connector 都会询问网页当前显示的 6 位配对码。首次运行还会询问：

1. AdsPower Local API key
2. 仅在默认端口无法连接时询问 AdsPower Local API 端口

完成后终端会显示 Hive、AdsPower 和可用 Profile 的连接状态，并等待任务。

Connector 始终在当前终端前台运行：

• 关闭终端，Connector 就停止。
• 关闭后本次 Hive 会话失效；下次启动需要网页生成的新配对码。
• 按一次 Ctrl+C 会停止领取新任务，并等待当前原子动作结束。
• 再按一次 Ctrl+C 会立即退出。

本地数据

AdsPower 配置、日志、任务恢复记录和待回报事件保存在：

~/.canlah/connector/

上传到 Hive 的内容包括：

• Connector 版本和安全的 CPU/内存指标
• AdsPower Profile ID、显示名称、分组、可用状态
• 任务和动作状态
• 点赞、评论、加入社区成功后的截图证据

以下内容不会离开这台电脑：

• AdsPower Local API key
• Reddit Cookie、密码和登录会话
• 代理地址、代理密码和出口 IP

常见问题

AdsPower 无法连接

确认 AdsPower 已启动、Local API 已启用，并检查 API key。若 Local API 不使用默认端口 50325，首次连接失败后按提示输入实际端口。

Hive 提示连接已失效

当前运行会话已结束。在 Hive 账号页刷新出新的 6 位配对码，然后再次启动 Connector。

提示必须升级

当前协议版本已不受服务端支持。退出后重新运行相同命令；npx 会下载最新发布版本：

npx -y @canlah/connector@latest start