跳到正文
菜单

分步指南:把运行 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. 创建账户

  1. 打开 app.subnera.com,选择 创建账户(Create account)。
  2. 输入电子邮件地址、密码和确认密码,然后提交。
  3. 可选:之后可以在账户页面使用 添加通行密钥(Add passkey),通过指纹、面容或设备 PIN 登录。您的密码仍然有效。

注册默认是开放的,但运营方可以在某个控制台上关闭它。此时页面会显示“此控制台已关闭注册。”(Sign-up is closed on this hub.)

2. 选择或创建机器池

机器池是在同一个仪表板上一起查看的一组 Mac。创建账户时会同时创建一个名为 个人(Personal)的机器池,所以您可以跳过这一步。若要再创建一个,请前往 新建机器池(New pool),输入 机器池名称(Pool name),然后点击 创建机器池(Create pool)。角色与共享请参阅机器池与角色指南(英文)。

3. 生成安装令牌

  1. 打开机器池的页面。仪表板会打开您偏好的机器池。
  2. 点击 + 添加机器(+ Add machine)。面板会显示控制台 URL 和一个以 tok_ 开头的令牌。
  3. 把两者都复制下来。在这台 Mac 连接成功之前,请保持面板打开。

令牌有效期为一小时(面板会显示它的到期时间),且只能使用一次。持有令牌的人可以向该机器池添加 Mac,所以请不要公开发布。只有当您在机器池中的角色允许管理机器(管理员或所有者)时,才会出现这个按钮。如果您关闭了面板并弄丢了令牌,请重新生成一个。

4. 把它粘贴到菜单栏应用中

  1. 在这台 Mac 上,点击 subnera 的菜单栏图标,选择 Settings ▸ Fleet Hub Settings…(1.0.17 之前为 Remote Dashboard Settings…)。
  2. 在 Hub URL 中输入面板里显示的地址。它必须以 https:// 开头(只有 localhost 才接受纯 http://)。
  3. 在 Install token 中粘贴令牌。
  4. 点击 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 已连接但看起来卡住了,请参阅注册状态指南(英文)和故障排查指南(英文)。

想在自己的 Mac 上看到这些吗?

subnera 在您的菜单栏中显示真实的排队位置和阶段。

安装 subnera