跳到内容
Localtonet Localtonet 控制台

在 Windows 上安装 Localtonet

获取本页帮助
本页内容 9 个章节
  1. 开始之前
  2. 选择版本
  3. 使用应用
  4. 安装并打开应用
  5. 使用令牌登录
  6. 启动隧道
  7. 使用控制台客户端
  8. 下载并解压
  9. 用你的令牌启动
  10. 检查会话
  11. 作为 Windows 服务运行
  12. 安装服务
  13. 检查它是否在运行
  14. 服务命令
  15. 更新
  16. 卸载
  17. 故障排除
  18. 相关页面

在 Windows 上,你可以使用 Microsoft Store 中的 Localtonet 应用、同一应用的便携版,或者控制台客户端。控制台客户端还可以把自己安装为 Windows 服务,在每次开机时启动。

开始之前 #

  • 一个 Localtonet 账户。如果还没有,请免费创建一个。
  • 你的 AuthToken。在控制台的 AuthToken 卡片上选择复制,或者从我的令牌中复制一个令牌。
  • 对于 Windows 服务:以管理员身份运行的命令提示符或 PowerShell 窗口。

选择版本 #

版本下载说明
Microsoft Store 应用Microsoft Store 中的 Localtonet带登录界面的应用窗口。需要 Windows 10 版本 1809(内部版本 17763)或更高版本。
桌面应用,便携 ZIPx64、x86、ARM64同一个应用,但不经过 Store。解压 ZIP,然后从解压出的文件夹中启动应用。
控制台客户端64 位、32 位、ARM64一个只包含 localtonet.exe 一个文件的 ZIP。只有这个版本提供服务命令。

下载页面在二进制文件下提供 Microsoft Store 应用和三个控制台版本。

使用应用 #

  1. 安装并打开应用 #

    从 Microsoft Store 安装 Localtonet,或者解压便携 ZIP 并启动应用。应用会打开 Sign in to Localtonet 界面。

  2. 使用令牌登录 #

    把你的 AuthToken 粘贴到 Authtoken or PIN 字段中,然后选择 Connect。如果界面打开时令牌在剪贴板中,应用会自动为你填入。你也可以不输入令牌,而是输入我的令牌中某个令牌所显示的 6 位 PIN。PIN 的有效期为一分钟。

    如果应用回复 Pin or authtoken is not valid.,请重新复制令牌,并检查 33 个字符是否完整。

  3. 启动隧道 #

    登录后,应用会列出在这台设备上运行的隧道。当列表显示 No active tunnels 时,请在控制台中创建并启动隧道,参见快速开始。Sign Out 会从应用中移除令牌,Quit Localtonet 会关闭应用。

使用控制台客户端 #

  1. 下载并解压 #

    下载与你的 CPU 对应的 ZIP,并解压到一个位置固定的文件夹,例如 C:\Localtonet。你之后安装的服务会从这个文件夹启动 localtonet.exe。

  2. 用你的令牌启动 #

    在该文件夹中打开命令提示符或 PowerShell,然后运行:

    命令提示符
    localtonet --authtoken <YOUR_TOKEN>

    PowerShell 只有在你写出路径时才会运行当前文件夹中的程序,因此在 PowerShell 中命令是:

    PowerShell
    .\localtonet --authtoken <YOUR_TOKEN>

    客户端会在本地保存令牌。下次你只需运行 localtonet 即可启动。如果在没有已保存令牌的情况下启动,它会询问 Please Enter AuthToken or PIN。

  3. 检查会话 #

    窗口中会显示 Session Status: Connected,下方的表格每个正在运行的隧道占一行:IP/Url、Protocol、Client IP、Client Port、Ping 和 Status。在你于控制台中启动隧道之前,表格是空的。你的令牌名称显示在表格下方。

    按 Ctrl + C 停止客户端。按 F12 移除已保存的令牌并退出。

作为 Windows 服务运行 #

服务会在每次开机时启动 Localtonet,在你退出登录后保持运行,并且不需要打开终端。请使用控制台客户端,在以管理员身份运行的命令提示符或 PowerShell 中运行这些命令。

  1. 安装服务 #

    命令提示符(管理员)
    localtonet --install-service --authtoken <YOUR_TOKEN>

    该命令会为此令牌注册一个 Windows 服务,把启动类型设为自动,并立即启动它。它会回复服务的名称:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> 是你令牌的前 9 个字符。每个令牌都有自己的服务,因此其他服务命令需要使用相同的 --authtoken 才能找到它。

  2. 检查它是否在运行 #

    命令提示符(管理员)
    localtonet --status-service --authtoken <YOUR_TOKEN>

    服务正在运行时,会回复 [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running。你也可以在 services.msc 中以相同名称看到该服务,说明为 Localtonet Service。在控制台的我的令牌下,该令牌显示为在线。

服务命令 #

请在每条命令中加上 --authtoken <YOUR_TOKEN>。

命令作用需要管理员权限
--install-service创建启动类型为自动的服务并启动它。服务失败一分钟后,Windows 会重新启动它。是
--start-service启动已安装的服务,例如在你停止它之后。是
--stop-service停止服务。它会在下次开机时再次启动。是
--status-service输出状态:Running、Stopped、服务正在启动时的 Installing、Paused、此令牌不存在服务时的 NotFound、Error 或 Unknown。否
--remove-service停止服务并删除它。是

服务会使用你与 --install-service 一起传入的选项来安装,因此请把 --net 和 --ip 等客户端选项加到该命令中。这些选项列在 CLI 参考中。

服务会运行你安装服务时 localtonet.exe 所在文件夹中的文件,令牌是其启动命令的一部分。服务安装期间,请不要移动或删除该文件。

更新 #

  • Microsoft Store 应用:由 Microsoft Store 更新应用。
  • 控制台客户端和便携应用:从下载页面下载最新的 ZIP,并替换旧文件。Windows 不允许在 localtonet.exe 运行时替换它,因此请先关闭客户端。如果它作为服务运行,请运行 --stop-service,替换文件,然后运行 --start-service。

localtonet --version 会输出已安装的版本。在我的令牌下,客户端列显示设备最近一次上报的版本,当有更新版本可用时会显示需要更新徽标。

卸载 #

  1. 如果你安装了服务,请先移除它:以管理员身份运行 localtonet --remove-service --authtoken <YOUR_TOKEN>。
  2. 要移除已保存的令牌,请启动控制台客户端并按 F12。
  3. 删除包含 localtonet.exe 的文件夹,或者在 Windows 设置中卸载 Store 应用。

故障排除 #

'localtonet' is not recognized

终端不在包含 localtonet.exe 的文件夹中,或者你在使用 PowerShell。请先切换到该文件夹。在 PowerShell 中,用 .\localtonet 启动客户端。

Install failed: 'Windows service installation' requires elevated (admin/root) privileges.

终端不是以管理员身份运行的。请用以管理员身份运行打开命令提示符或 PowerShell,然后重复该命令。--start-service、--stop-service 和 --remove-service 也会回复同类的消息。

Install failed: Service 'Localtonet_…' already exists.

此令牌的服务已经安装。请用 --status-service 检查。如果要重新安装它,例如使用其他选项或从另一个文件夹安装,请先运行 --remove-service。

Start failed: Service could not be started

该消息包含 Windows sc 工具的回复。错误 1056 表示服务已在运行。如果你在 --install-service 之后紧接着运行 --start-service,这是正常的,因为安装命令已经启动了服务。错误 1060 表示此令牌不存在服务。

状态是 NotFound,但我已经安装了服务

服务名称由令牌生成。如果你传入的令牌与安装服务时使用的令牌不同,客户端会去查找另一个服务。请使用相同的令牌,或者在 services.msc 中查找以 Localtonet_ 开头的服务。

Service installation cannot persist proxy passwords.

你把 --install-service 与 --proxy-user 或带密码的代理 URL 组合使用了。服务不能带着代理密码安装。请使用 --proxy env,并在服务的环境中提供凭据。参见 CLI 参考。

Wrong Token!

客户端需要来自我的令牌的 33 个字符的 AuthToken,或者一个尚未过期的 6 位 PIN。请重新复制令牌,并在提示处输入。

This token is used in another localtonet application!

这台电脑上的另一个 Localtonet 窗口已经在使用相同的令牌运行。请关闭它,或者用另一个令牌启动当前这个。每个令牌只运行一个客户端。

令牌在控制台中一直显示为离线

离线表示设备已断开连接。请检查客户端窗口是否仍然打开,或者服务状态是否为 Running,并确认客户端是用你正在查看的这个令牌启动的。

支持