跳到内容
Localtonet Localtonet 控制台

设备终端

免费 桌面版 v8.6+ Windows、Linux 和 macOS

获取本页帮助
本页内容 13 个章节
  1. 工作原理
  2. 开始之前
  3. 添加设备
  4. 打开“添加设备”
  5. 选择令牌
  6. 在计算机上运行命令
  7. 输入代码并批准
  8. 无人在计算机前
  9. 命令选项
  10. 设备列表
  11. 在浏览器中打开终端
  12. 选择“终端”
  13. 输入验证器代码
  14. 使用 ssh 连接
  15. SSH 密钥
  16. 使用 Localtonet 客户端
  17. 供脚本和 AI 代理使用的访问密钥
  18. Elio
  19. 连接历史
  20. 重命名、移除或禁用设备
  21. 安全说明
  22. 故障排除
  23. 相关页面

“我的设备”会列出你的计算机及其 CPU、内存和磁盘使用情况,并可在浏览器中打开其中任意一台的真实 Shell。你只需在该机器上运行一条命令即可启用;计算机上无需监听任何公网端口。

工作原理 #

你在机器上运行 localtonet --terminal enable,并在控制台中批准它打印出的短代码。此后,终端按钮即可在浏览器标签页中打开该机器的 Shell。你也可以在任意终端中使用控制台显示的 ssh 命令访问同一个 Shell。

  • 设备只发起出站连接。无需开放任何入站端口,也无需安装 SSH 服务器。
  • 每次从浏览器打开 Shell,都需要验证器应用中的最新代码。
  • 只有本地命令才能开启终端,无法在控制台中启用。

开始之前 #

  • 机器上的 Localtonet。使用此功能所需的 Localtonet 应用最低版本:桌面版 v8.6。请从下载页面获取。
  • 该机器专用的 AuthToken。请为每台计算机使用各自的令牌:在第二台计算机上运行同一个令牌,会使第一台断开连接。终端适用于你个人账户的令牌,不适用于团队令牌。参见 AuthToken。
  • 双重验证。打开 Shell 需要你的账户已设置验证器应用。如果尚未设置,“我的设备”会显示开启双重身份验证。参见账户与安全。

“我的设备”位于个人控制台的菜单中。选择团队时不会显示。

添加设备 #

  1. 打开“添加设备” #

    打开 我的设备,然后选择添加设备。

  2. 选择令牌 #

    选择一个现有令牌,或选择生成新令牌创建一个并放入命令中。如果这台计算机上已经运行着 Localtonet,请选择它所用的令牌。列表会标出在线的或已在其他设备上使用的令牌。当前已连接的令牌会显示警告:仅当 Localtonet 正运行在这同一台计算机上时才使用它。

  3. 在计算机上运行命令 #

    从对话框中复制命令,并在你要添加的计算机的终端中运行。如果 Localtonet 在那里作为服务运行,请使用管理员终端或 sudo。

    在计算机上
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    命令会打印一个批准码并等待:

    输出
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    以管理员或 root 身份运行时,它会先询问 Run shells as user:,并建议使用你自己的账户。没有这些权限时,Shell 将以运行该命令的账户身份运行。

  4. 输入代码并批准 #

    回到对话框,在2. 输入它显示的代码下输入批准码。大写字母和短横线会自动补上,你也可以粘贴命令打印的整行内容。输入验证器应用中的 6 位代码,然后选择批准设备。

    随后,计算机上的命令会打印 Terminal enabled. Shells will run as …,设备也会出现在列表中。只要 Localtonet 在其上运行,它就显示为在线。

批准码的有效期为 15 分钟。它由 8 个字符组成,不含 I、L、O、U、0 和 1。如果过期,命令会提示:请重新运行。

批准后,如果你是在控制台中手动启动的命令,它会作为普通的 Localtonet 运行继续执行。在脚本中,或者设备上已经用该令牌运行着 Localtonet 时,命令会在终端启用后退出。

无人在计算机前 #

对于没有人能看到代码的机器,例如你用脚本部署的服务器,请使用一次性密钥代替批准码。

  1. 在添加设备对话框中,选择令牌并输入验证器代码。
  2. 打开那台计算机上没人能看到代码?,然后选择创建一次性密钥。该密钥有效期为一小时,且只能使用一次。
  3. 复制命令,并将 ACCOUNT 替换为 Shell 在那台计算机上应使用的用户账户。
在计算机上
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

密钥有效时,设备会立即获得批准,不会显示代码。

命令选项 #

选项作用
--terminal enable为这台计算机开启远程终端并开始配对。
--terminal disable在这台计算机上将其关闭,并从你的账户中移除该设备。
--terminal status打印终端是否已启用,以及 Shell 以哪个账户运行。
--terminal-user <ACCOUNT>以 root 或管理员身份启用时,Shell 所使用的账户。在这种情况下,如果命令在没有控制台的环境下运行(例如通过脚本),则必须提供。
--pairing-key <PAIRING_KEY>来自控制台的一次性密钥,因此无需批准码。

设备列表 #

页面打开期间,列表会自动刷新。

列显示内容
设备计算机的名称、操作系统和架构,以及 Shell 使用的账户。
状态在线表示 Localtonet 正在计算机上运行并已连接。
CPU当前处理器负载。设备在线时显示。
内存已用内存与总内存。设备在线时显示。
磁盘已用磁盘空间与总空间。设备在线时显示。
操作终端、密钥、连接历史、重命名和移除。

在浏览器中打开终端 #

  1. 选择“终端” #

    在设备所在行选择终端。该按钮仅在设备在线时可用。对话框会告诉你 Shell 以哪个账户运行。

  2. 输入验证器代码 #

    输入验证器应用中的 6 位代码,然后选择打开终端。Shell 会在新的浏览器标签页中打开。

使用 ssh 连接 #

终端对话框还会在或者在任意终端中使用,无需安装任何东西:下显示一条命令。任何装有 ssh 客户端的计算机都可使用。命令的格式如下,其中 <DEVICE> 是你的设备名称,<NODE> 是它所连接的 Localtonet 服务器:

任意终端
ssh -p 24 <DEVICE>@<NODE>

从对话框中复制命令:它会显示适用于你设备的确切命令。

  • 对话框会显示服务器指纹。首次连接时 ssh 也会显示一个指纹。如果两者一致,说明你连接到的是 Localtonet。
  • 如果你没有添加 SSH 密钥,ssh 会显示一个链接,供你在浏览器中批准。批准连接页面会列出设备名称和发起请求的 IP 地址。输入验证器代码并选择允许连接,然后回到你的终端。该请求 5 分钟后过期。

只有在你刚刚亲自运行了 ssh 命令时,才批准连接。发起请求的人将获得那台计算机上的 Shell。

SSH 密钥 #

添加你自己计算机的 SSH 公钥,这样 ssh、scp 和 sftp 连接时就无需在浏览器中批准。

  1. 在我的设备中,选择SSH 密钥。
  2. 输入名称,并将公钥文件(例如 ~/.ssh/id_ed25519.pub)中的一行粘贴到公钥。切勿粘贴私钥。
  3. 输入验证器代码,然后选择添加密钥。

支持的密钥类型有 ssh-ed25519、ecdsa-sha2-nistp256、ecdsa-sha2-nistp384、ecdsa-sha2-nistp521 和 ssh-rsa。一个密钥适用于你账户的所有设备。在密钥旁选择移除即可使其失效。对话框还会显示一个针对你某台设备的 scp 示例:

任意终端
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

使用 Localtonet 客户端 #

如果你用来连接的计算机上安装了 Localtonet,localtonet ssh 同样可以连接,并且会话全程加密直到设备。

任意终端
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

没有密钥时,它会打印 Approve this connection in your browser 和一个链接,并在你批准后继续。-- 之后的所有内容会作为一条命令在设备上运行,而不是打开 Shell。

供脚本和 AI 代理使用的访问密钥 #

访问密钥让脚本或 AI 代理无需浏览器即可访问某台计算机。持有它的人都能在那里运行命令,因此请妥善保密。

  1. 在设备所在行选择密钥。
  2. 输入名称,设置有效期(天),并输入验证器代码。密钥在这么多天后失效,最长 3650 天。
  3. 选择创建密钥,并立即复制密钥。它不会再次显示。

使用密钥的方式:

  • ssh。运行对话框显示的 ssh 命令。ssh 提示时,粘贴密钥。
  • Localtonet 客户端。使用 --key 选项传入密钥,如下例所示。
  • MCP。连接到 Localtonet MCP 服务器的 AI 代理,可以将密钥传给 RunDeviceCommand 工具。
脚本
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

对话框会列出该设备的密钥及其到期日期。选择移除即可撤销某个密钥。

Elio #

“我的设备”上的 Elio 按钮对应 Elio,即 Localtonet 推出的免费开源 SSH 客户端。你可以从 elio.sh 下载它,在 Elio 中登录,并在控制台中用你的双重验证码批准该请求。之后 Elio 就能看到你设备的名称和状态。要在设备上打开 Shell,仍需要该设备的访问密钥或一次批准。对话框会列出已登录的 Elio 副本;移除某个副本即可将其退出登录。

连接历史 #

在设备所在行选择时钟按钮,即可查看它最近的连接。每一行显示发生时间、连接方式以及来源 IP 地址。连接方式包括:浏览器终端、使用你的 SSH 密钥的 ssh、使用访问密钥的 ssh、在浏览器中批准的 ssh、使用访问密钥或在浏览器中批准的 localtonet ssh,以及通过 MCP 使用访问密钥的 AI 代理。列表保留最近的 50 次连接。

Localtonet 只保留这条记录。你输入的命令及其输出不会被保存。请通过该列表发现不是你本人发起的连接:如果发现,请移除你不再需要的访问密钥和 SSH 密钥。

重命名、移除或禁用设备 #

操作位置结果
重命名所在行中的铅笔按钮。更改列表中显示并用于 ssh 命令的名称。请使用字母、数字、点、短横线或下划线。
移除所在行中的垃圾桶按钮。将该计算机从你的账户中移除。它的密钥会失效,需要重新批准才能恢复。
禁用在计算机本机上。在本地关闭终端,并将设备从你的账户中移除。
在计算机上
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

禁用操作始终可以在计算机上执行,即使无法访问控制台也是如此。这种情况下,命令会提示你也在控制台中移除该设备。

安全说明 #

  • 机器上的 Shell 拥有其账户所能做的一切权限。请谨慎选择 Shell 所使用的账户;使用无特权账户可以限制会话能更改的内容。
  • 任何可能获得 Shell 的操作都会要求输入最新的验证器代码:批准设备、打开终端、创建访问密钥、添加 SSH 密钥和批准 ssh 连接。
  • 访问密钥或已添加的 SSH 密钥无需该代码即可连接。请为密钥设置较短的有效期,像保管密码一样保管它们,并移除不再使用的密钥。
  • 短时间内尝试次数过多后,控制台会回复尝试次数过多。请等待一分钟后重试。
  • 请不时查看连接历史。出现你不认识的连接,意味着有人使用了你未预期的密钥或批准。
  • 移除设备,或在设备上运行 --terminal disable,会终止其所有密钥的访问权限。

故障排除 #

该批准码有误或已过期。

请将代码与命令打印的代码核对。代码有效期为 15 分钟,并且属于命令中令牌所属的账户。重新运行命令即可获得新代码。

Remote terminal is available on personal tokens only

命令中的令牌属于某个团队。请在你的个人账户中创建一个令牌并使用它。

The pairing key is not valid or has expired

一次性密钥只能使用一次,有效期为一小时。请在添加设备对话框中创建新的密钥。

Choose the account for shells with --terminal-user

该命令以 root 或管理员身份在没有控制台的环境下运行,因此无法询问。请添加 --terminal-user <ACCOUNT>。

“终端”按钮被禁用,或“此设备已离线”

终端仅在设备在线时才能打开。请使用同一个令牌在那台计算机上启动 Localtonet。

该验证器代码不正确。

请输入验证器应用为 Localtonet 显示的 6 位代码。它不是你的密码,也不是计算机上显示的代码,并且每 30 秒变化一次。

此请求已过期。请从“我的设备”重新开始。

打开终端或批准 ssh 连接的请求有效期很短。请再次选择终端,或重新运行 ssh 命令。

这看起来不是 SSH 公钥。

请粘贴 .pub 文件中的整行内容,从密钥类型开始。

The terminal is already enabled on this device

无需任何操作。若要重新配对该机器,请先运行 --terminal disable,再运行 --terminal enable。

支持