在 macOS 上安装 Localtonet
本页内容 9 个章节
在 macOS 上,Localtonet 客户端是一个适用于 Intel 和 Apple Silicon Mac 的控制台程序。你可以用 Homebrew 或 ZIP 压缩包安装它,用你的 AuthToken 启动它;如果希望每次开机都自动启动,还可以把它安装为 launchd 服务。
开始之前 #
- 一个 Localtonet 账户。如果还没有,请免费创建一个。
- 你的 AuthToken。选择控制台AuthToken 卡片上的复制,或从我的令牌中复制一个令牌。
- 使用 Homebrew 安装时:Homebrew。
- 使用 launchd 服务时:一个可以使用
sudo的账户。
使用 Homebrew 安装 #
-
添加 Localtonet tap 并安装 #
tap 会向 Homebrew 添加一个第三方软件仓库,这样你就可以从中安装和更新 formula。
终端brew tap localtonet/tap brew install localtonet -
检查安装 #
终端localtonet --version该命令会输出客户端的版本。
手动安装 #
如果你更喜欢直接下载,请选择适合你的 Mac 的压缩包。ZIP 中只有一个文件 localtonet。
| Mac | 压缩包 |
|---|---|
| Apple Silicon(ARM64) | localtonet-osx-arm64.zip |
| Intel(x64) | localtonet-osx-64.zip |
-
下载并解压 #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip unzip localtonet-osx-64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
可选:把它移入 PATH #
如果不执行这一步,你需要通过路径
~/localtonet/localtonet启动客户端。执行之后,你可以在任何文件夹中直接输入localtonet。终端sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
启动客户端 #
-
用你的令牌启动 #
终端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 删除已保存的令牌并退出。
作为 launchd 服务运行 #
服务会在每次开机时启动 Localtonet,在你注销后仍保持运行,并且不需要打开终端。服务命令需要 root 权限,因此请用 sudo 运行它们。
-
安装服务 #
终端sudo localtonet --install-service --authtoken <YOUR_TOKEN>该命令会为这个令牌注册一个系统级的 launchd 任务,并立即启动它。它会返回该任务的名称:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>是你令牌的前 9 个字符。每个令牌都有自己的任务,因此其他服务命令需要使用相同的--authtoken才能找到它。 -
检查它是否在运行 #
终端sudo localtonet --status-service --authtoken <YOUR_TOKEN>运行中的任务会返回
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running。在控制台的我的令牌下,该令牌显示为在线。
安装会创建什么 #
| 项目 | 位置 |
|---|---|
| launchd 任务定义 | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| 客户端的标准输出 | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| 客户端的错误输出 | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
该任务在 Mac 开机时启动,当客户端因错误退出时,launchd 会再次启动它。该任务运行的是你安装服务时 localtonet 文件所在的路径,并把令牌作为参数的一部分。
服务命令 #
每条命令都用 sudo 运行,并加上 --authtoken <YOUR_TOKEN>。
| 命令 | 作用 |
|---|---|
--install-service | 写入任务定义,加载它并启动客户端。 |
--start-service | 启动任务。如果它已在运行,launchd 会重启它。 |
--stop-service | 停止客户端。任务仍保持已安装状态,并在下次开机时再次启动。 |
--status-service | 输出状态,例如 Running、Stopped、NotFound 或 Error。 |
--remove-service | 停止任务,卸载它,并删除任务定义。 |
服务会按你在 --install-service 旁边一并传入的选项来安装。这些选项列在 CLI 参考中。
升级 #
- Homebrew:
brew upgrade localtonet - 手动安装:下载最新的压缩包,并替换
localtonet文件。
如果 Localtonet 作为服务运行,则在通过 Homebrew 升级之后,请重新安装该服务:先移除它,再用相同的令牌安装。安装时也会启动它。
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>任务会记住它安装时所用文件的路径。如果手动升级后客户端仍在原来的位置,只需用 --stop-service 停止服务,替换文件,再用 --start-service 启动服务即可。作为服务运行介绍了这些命令。
卸载 #
- 如果你安装了服务,请先移除它:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - 要删除已保存的令牌,请启动客户端并按 F12。
- 移除客户端。使用 Homebrew 时:
brew uninstall localtonet,再用brew untap localtonet/tap移除 tap。手动安装的话,删除localtonet文件即可。
故障排除 #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
该命令没有以 root 权限运行。请加上 sudo 重新执行。
sudo: localtonet: command not found
sudo 在它自己的搜索路径中找不到客户端。请改为给出完整路径。command -v localtonet 会输出它,例如:
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>如果手动安装时没有执行 PATH 这一步,则路径是 ~/localtonet/localtonet。
Install failed: Plist already exists for 'Localtonet_…'
这个令牌的服务已经安装。请用 --status-service 检查它。如果要重新安装,请先运行 --remove-service。
服务已安装,但令牌仍然是离线状态
请查看该任务的错误日志 /var/log/Localtonet_<TOKEN_PREFIX>.err.log,并检查 localtonet 文件是否仍在你安装服务时所用的路径上。
Wrong Token!
客户端需要来自我的令牌的 33 个字符的 AuthToken,或一个尚未过期的 6 位 PIN。请重新复制令牌,并在提示处输入。
This token is used in another localtonet application!
这台 Mac 上已有另一个 Localtonet 客户端在使用同一个令牌运行。请关闭它,或用不同的令牌启动这个客户端。每个令牌只运行一个客户端。