在 Windows 上安装 Localtonet
本页内容 9 个章节
在 Windows 上,你可以使用 Microsoft Store 中的 Localtonet 应用、同一应用的便携版,或者控制台客户端。控制台客户端还可以把自己安装为 Windows 服务,在每次开机时启动。
开始之前 #
- 一个 Localtonet 账户。如果还没有,请免费创建一个。
- 你的 AuthToken。在控制台的 AuthToken 卡片上选择复制,或者从我的令牌中复制一个令牌。
- 对于 Windows 服务:以管理员身份运行的命令提示符或 PowerShell 窗口。
选择版本 #
| 版本 | 下载 | 说明 |
|---|---|---|
| Microsoft Store 应用 | Microsoft Store 中的 Localtonet | 带登录界面的应用窗口。需要 Windows 10 版本 1809(内部版本 17763)或更高版本。 |
| 桌面应用,便携 ZIP | x64、x86、ARM64 | 同一个应用,但不经过 Store。解压 ZIP,然后从解压出的文件夹中启动应用。 |
| 控制台客户端 | 64 位、32 位、ARM64 | 一个只包含 localtonet.exe 一个文件的 ZIP。只有这个版本提供服务命令。 |
下载页面在二进制文件下提供 Microsoft Store 应用和三个控制台版本。
使用应用 #
-
安装并打开应用 #
从 Microsoft Store 安装 Localtonet,或者解压便携 ZIP 并启动应用。应用会打开 Sign in to Localtonet 界面。
-
使用令牌登录 #
把你的 AuthToken 粘贴到 Authtoken or PIN 字段中,然后选择 Connect。如果界面打开时令牌在剪贴板中,应用会自动为你填入。你也可以不输入令牌,而是输入我的令牌中某个令牌所显示的 6 位 PIN。PIN 的有效期为一分钟。
如果应用回复
Pin or authtoken is not valid.,请重新复制令牌,并检查 33 个字符是否完整。 -
启动隧道 #
登录后,应用会列出在这台设备上运行的隧道。当列表显示 No active tunnels 时,请在控制台中创建并启动隧道,参见快速开始。Sign Out 会从应用中移除令牌,Quit Localtonet 会关闭应用。
使用控制台客户端 #
-
下载并解压 #
下载与你的 CPU 对应的 ZIP,并解压到一个位置固定的文件夹,例如
C:\Localtonet。你之后安装的服务会从这个文件夹启动localtonet.exe。 -
用你的令牌启动 #
在该文件夹中打开命令提示符或 PowerShell,然后运行:
命令提示符localtonet --authtoken <YOUR_TOKEN>PowerShell 只有在你写出路径时才会运行当前文件夹中的程序,因此在 PowerShell 中命令是:
PowerShell.\localtonet --authtoken <YOUR_TOKEN>客户端会在本地保存令牌。下次你只需运行
localtonet即可启动。如果在没有已保存令牌的情况下启动,它会询问Please Enter AuthToken or PIN。 -
检查会话 #
窗口中会显示
Session Status: Connected,下方的表格每个正在运行的隧道占一行:IP/Url、Protocol、Client IP、Client Port、Ping和Status。在你于控制台中启动隧道之前,表格是空的。你的令牌名称显示在表格下方。按 Ctrl + C 停止客户端。按 F12 移除已保存的令牌并退出。
作为 Windows 服务运行 #
服务会在每次开机时启动 Localtonet,在你退出登录后保持运行,并且不需要打开终端。请使用控制台客户端,在以管理员身份运行的命令提示符或 PowerShell 中运行这些命令。
-
安装服务 #
命令提示符(管理员)localtonet --install-service --authtoken <YOUR_TOKEN>该命令会为此令牌注册一个 Windows 服务,把启动类型设为自动,并立即启动它。它会回复服务的名称:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>是你令牌的前 9 个字符。每个令牌都有自己的服务,因此其他服务命令需要使用相同的--authtoken才能找到它。 -
检查它是否在运行 #
命令提示符(管理员)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 会输出已安装的版本。在我的令牌下,客户端列显示设备最近一次上报的版本,当有更新版本可用时会显示需要更新徽标。
卸载 #
- 如果你安装了服务,请先移除它:以管理员身份运行
localtonet --remove-service --authtoken <YOUR_TOKEN>。 - 要移除已保存的令牌,请启动控制台客户端并按 F12。
- 删除包含
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,并确认客户端是用你正在查看的这个令牌启动的。