设备终端
免费 桌面版 v8.6+ Windows、Linux 和 macOS
本页内容 13 个章节
“我的设备”会列出你的计算机及其 CPU、内存和磁盘使用情况,并可在浏览器中打开其中任意一台的真实 Shell。你只需在该机器上运行一条命令即可启用;计算机上无需监听任何公网端口。
工作原理 #
你在机器上运行 localtonet --terminal enable,并在控制台中批准它打印出的短代码。此后,终端按钮即可在浏览器标签页中打开该机器的 Shell。你也可以在任意终端中使用控制台显示的 ssh 命令访问同一个 Shell。
- 设备只发起出站连接。无需开放任何入站端口,也无需安装 SSH 服务器。
- 每次从浏览器打开 Shell,都需要验证器应用中的最新代码。
- 只有本地命令才能开启终端,无法在控制台中启用。
开始之前 #
- 机器上的 Localtonet。使用此功能所需的 Localtonet 应用最低版本:桌面版 v8.6。请从下载页面获取。
- 该机器专用的 AuthToken。请为每台计算机使用各自的令牌:在第二台计算机上运行同一个令牌,会使第一台断开连接。终端适用于你个人账户的令牌,不适用于团队令牌。参见 AuthToken。
- 双重验证。打开 Shell 需要你的账户已设置验证器应用。如果尚未设置,“我的设备”会显示开启双重身份验证。参见账户与安全。
“我的设备”位于个人控制台的菜单中。选择团队时不会显示。
添加设备 #
-
打开“添加设备” #
打开 我的设备,然后选择添加设备。
-
选择令牌 #
选择一个现有令牌,或选择生成新令牌创建一个并放入命令中。如果这台计算机上已经运行着 Localtonet,请选择它所用的令牌。列表会标出在线的或已在其他设备上使用的令牌。当前已连接的令牌会显示警告:仅当 Localtonet 正运行在这同一台计算机上时才使用它。
-
在计算机上运行命令 #
从对话框中复制命令,并在你要添加的计算机的终端中运行。如果 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 将以运行该命令的账户身份运行。
-
输入代码并批准 #
回到对话框,在2. 输入它显示的代码下输入批准码。大写字母和短横线会自动补上,你也可以粘贴命令打印的整行内容。输入验证器应用中的 6 位代码,然后选择批准设备。
随后,计算机上的命令会打印 Terminal enabled. Shells will run as …,设备也会出现在列表中。只要 Localtonet 在其上运行,它就显示为在线。
批准码的有效期为 15 分钟。它由 8 个字符组成,不含 I、L、O、U、0 和 1。如果过期,命令会提示:请重新运行。
批准后,如果你是在控制台中手动启动的命令,它会作为普通的 Localtonet 运行继续执行。在脚本中,或者设备上已经用该令牌运行着 Localtonet 时,命令会在终端启用后退出。
无人在计算机前 #
对于没有人能看到代码的机器,例如你用脚本部署的服务器,请使用一次性密钥代替批准码。
- 在添加设备对话框中,选择令牌并输入验证器代码。
- 打开那台计算机上没人能看到代码?,然后选择创建一次性密钥。该密钥有效期为一小时,且只能使用一次。
- 复制命令,并将
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 | 当前处理器负载。设备在线时显示。 |
| 内存 | 已用内存与总内存。设备在线时显示。 |
| 磁盘 | 已用磁盘空间与总空间。设备在线时显示。 |
| 操作 | 终端、密钥、连接历史、重命名和移除。 |
在浏览器中打开终端 #
-
选择“终端” #
在设备所在行选择终端。该按钮仅在设备在线时可用。对话框会告诉你 Shell 以哪个账户运行。
-
输入验证器代码 #
输入验证器应用中的 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 连接时就无需在浏览器中批准。
- 在我的设备中,选择SSH 密钥。
- 输入名称,并将公钥文件(例如
~/.ssh/id_ed25519.pub)中的一行粘贴到公钥。切勿粘贴私钥。 - 输入验证器代码,然后选择添加密钥。
支持的密钥类型有 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 代理无需浏览器即可访问某台计算机。持有它的人都能在那里运行命令,因此请妥善保密。
- 在设备所在行选择密钥。
- 输入名称,设置有效期(天),并输入验证器代码。密钥在这么多天后失效,最长 3650 天。
- 选择创建密钥,并立即复制密钥。它不会再次显示。
使用密钥的方式:
- 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。