分步指南:把运行 Train at Home 的 Mac 接入 subnera 控制台
已在 macOS 26.6.2 上使用 T@H 3.7.0 验证(2026年10月4日)
发布于 2026年10月4日 · 阅读约 5 分钟
本指南讲解把一台 Mac 链接到 subnera hub 的唯一流程:创建账户、获取一次性令牌,并把它粘贴到菜单栏应用中。连接之后控制台能提供什么,请参阅机群控制台概览(英文)。subnera 是非官方应用,与 IOTA、Macrocosmos 或 Bittensor 无关联。
您需要先让 subnera 在这台 Mac 上运行起来。如果还没有安装,请先阅读安装指南。
1. 创建账户
- 打开 app.subnera.com,选择 创建账户(Create account)。
- 输入电子邮件地址、密码和确认密码,然后提交。
- 可选:之后可以在账户页面使用 添加通行密钥(Add passkey),通过指纹、面容或设备 PIN 登录。您的密码仍然有效。
注册默认是开放的,但运营方可以在某个控制台上关闭它。此时页面会显示“此控制台已关闭注册。”(Sign-up is closed on this hub.)
2. 选择或创建机器池
机器池是在同一个仪表板上一起查看的一组 Mac。创建账户时会同时创建一个名为 个人(Personal)的机器池,所以您可以跳过这一步。若要再创建一个,请前往 新建机器池(New pool),输入 机器池名称(Pool name),然后点击 创建机器池(Create pool)。角色与共享请参阅机器池与角色指南(英文)。
3. 生成安装令牌
- 打开机器池的页面。仪表板会打开您偏好的机器池。
- 点击 + 添加机器(+ Add machine)。面板会显示控制台 URL 和一个以
tok_开头的令牌。 - 把两者都复制下来。在这台 Mac 连接成功之前,请保持面板打开。
令牌有效期为一小时(面板会显示它的到期时间),且只能使用一次。持有令牌的人可以向该机器池添加 Mac,所以请不要公开发布。只有当您在机器池中的角色允许管理机器(管理员或所有者)时,才会出现这个按钮。如果您关闭了面板并弄丢了令牌,请重新生成一个。
4. 把它粘贴到菜单栏应用中
- 在这台 Mac 上,点击 subnera 的菜单栏图标,选择 Settings ▸ Fleet Hub Settings…(1.0.17 之前为 Remote Dashboard Settings…)。
- 在 Hub URL 中输入面板里显示的地址。它必须以
https://开头(只有 localhost 才接受纯http://)。 - 在 Install token 中粘贴令牌。
- 点击 Connect。
状态行会变为“Connected as m_…”,这台 Mac 通常会在几秒内出现在机群网格中。之后这些字段会被锁定,直到您点击 Disconnect。
这台 Mac 会存储和报告什么
接入时,这台 Mac 会获得一个私钥,subnera 只会把它保存在这台设备的 macOS 钥匙串中。控制台 URL 和机器标识符保存在应用的偏好设置里。在您接入之前,应用不会向控制台发送任何内容。
连接之后,应用大约每 10 秒通过 HTTPS 发送一次报告。报告包含:
- 主机信息:机器名称、Mac 型号、macOS 版本和运行时间;
- subnera 和官方应用的版本,以及公开热键(hotkey);
- 官方应用是否在运行、是否存在孤立的工作进程,以及看门狗是否开启;
- 应用本来就在跟踪的状态:阶段、排队位置、层、每小时的 token 数和轮次、速度测试以及更新状态。
只有在您从控制台请求实时日志流时,才会发送日志行。钱包私钥永远不会被读取或发送。机器的最近一次报告距今不足 90 秒时,即视为在线。
可选:Allow remote control
在同一个窗口中,Allow remote control (start / stop / restart / watchdog) 在每次接入后都是关闭的,并且只有在这台 Mac 连接之后才能勾选。在您勾选之前,这台 Mac 会忽略来自控制台的命令。您可以随时取消勾选,无需重新连接即可生效。更多内容请参阅远程控制授权指南(英文)。
在控制台中管理机器
从网格中打开这台机器。在它页面的底部:
- 重命名(Rename):编辑 机器名称(Machine name,最多 60 个字符),然后点击 重命名。这需要管理员或所有者角色。
- 移至机器池(Move to pool):选择一个机器池并点击 移动(Move)。您需要在两个机器池中都有管理机器的权限。被出借的 Mac 可以通过 退回出借方(Back to lender)退回。
- 撤销(Revoke):确认之后,这台 Mac 会立即停止报告,它的密钥也会失效。
断开连接或撤销
在这台 Mac 上,打开 Settings ▸ Fleet Hub Settings…(1.0.17 之前为 Remote Dashboard Settings…),点击 Disconnect。这会从钥匙串中移除密钥、忘记这台机器并关闭远程控制,整个过程无需控制台参与。该机器仍会以离线状态显示在控制台上,直到有人在那里撤销它。
在控制台中,点击 撤销。这台 Mac 的菜单随后会显示“⚠ Fleet hub access revoked”(1.0.17 之前为:“Remote: revoked — reconnect in Remote Dashboard Settings…”)。它的子菜单提供 Fleet Hub Settings…。若要恢复,请生成新令牌并重新连接。
常见的接入失败
| Mac 上的提示 | 原因与解决办法 |
|---|---|
| Enter an https:// URL. | Hub URL 为空或不是 HTTPS。请从“添加机器”面板中复制。 |
| Paste the install token. | 令牌字段为空。 |
| Token invalid, already used or expired. | 令牌有效期一小时,且只能使用一次。请生成一个新的,粘贴时不要带多余的字符。 |
| Too many attempts — wait a minute and try again. | 控制台限制了接入尝试的次数。请等待后重试。 |
| Could not store the key in the Keychain. | macOS 拒绝了写入。请解锁登录钥匙串,允许访问,然后再次点击 Connect。 |
| This hub requires a newer version of subnera. Please update. | 控制台使用的协议比您的应用更新。请更新应用。 |
| Failed: Hub returned an unexpected error (HTTP 409). | 当账户达到机器数量上限时,控制台会返回 409。请撤销一台不再使用的 Mac,然后在令牌未过期的情况下重试同一个令牌。 |
| Failed: 后面跟着网络错误 | 请检查这台 Mac 的网络连接和控制台 URL。应用不会跟随重定向,所以请使用控制台显示的准确地址。 |
如果这台 Mac 已连接,但菜单显示“Keychain access denied”,请重新启动应用并允许访问,或者点击 Disconnect,再用新令牌重新接入。如果某台 Mac 已连接但看起来卡住了,请参阅注册状态指南(英文)和故障排查指南(英文)。