跳到内容
Localtonet Localtonet 控制台

在 macOS 上安装 Localtonet

获取本页帮助
本页内容 9 个章节
  1. 开始之前
  2. 使用 Homebrew 安装
  3. 添加 Localtonet tap 并安装
  4. 检查安装
  5. 手动安装
  6. 下载并解压
  7. 可选:把它移入 PATH
  8. 启动客户端
  9. 用你的令牌启动
  10. 检查会话
  11. 作为 launchd 服务运行
  12. 安装服务
  13. 检查它是否在运行
  14. 安装会创建什么
  15. 服务命令
  16. 升级
  17. 卸载
  18. 故障排除
  19. 相关页面

在 macOS 上,Localtonet 客户端是一个适用于 Intel 和 Apple Silicon Mac 的控制台程序。你可以用 Homebrew 或 ZIP 压缩包安装它,用你的 AuthToken 启动它;如果希望每次开机都自动启动,还可以把它安装为 launchd 服务。

开始之前 #

  • 一个 Localtonet 账户。如果还没有,请免费创建一个。
  • 你的 AuthToken。选择控制台AuthToken 卡片上的复制,或从我的令牌中复制一个令牌。
  • 使用 Homebrew 安装时:Homebrew。
  • 使用 launchd 服务时:一个可以使用 sudo 的账户。

使用 Homebrew 安装 #

  1. 添加 Localtonet tap 并安装 #

    tap 会向 Homebrew 添加一个第三方软件仓库,这样你就可以从中安装和更新 formula。

    终端
    brew tap localtonet/tap
    brew install localtonet
  2. 检查安装 #

    终端
    localtonet --version

    该命令会输出客户端的版本。

手动安装 #

如果你更喜欢直接下载,请选择适合你的 Mac 的压缩包。ZIP 中只有一个文件 localtonet。

Mac压缩包
Apple Silicon(ARM64)localtonet-osx-arm64.zip
Intel(x64)localtonet-osx-64.zip
  1. 下载并解压 #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -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
  2. 可选:把它移入 PATH #

    如果不执行这一步,你需要通过路径 ~/localtonet/localtonet 启动客户端。执行之后,你可以在任何文件夹中直接输入 localtonet。

    终端
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

启动客户端 #

  1. 用你的令牌启动 #

    终端
    localtonet --authtoken <YOUR_TOKEN>

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

  2. 检查会话 #

    终端中会显示 Session Status: Connected,其下方是一个表格,每个正在运行的隧道占一行:IP/Url、Protocol、Client IP、Client Port、Ping 和 Status。在你于控制台中启动隧道之前,该表格是空的,参见快速入门。

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

作为 launchd 服务运行 #

服务会在每次开机时启动 Localtonet,在你注销后仍保持运行,并且不需要打开终端。服务命令需要 root 权限,因此请用 sudo 运行它们。

  1. 安装服务 #

    终端
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    该命令会为这个令牌注册一个系统级的 launchd 任务,并立即启动它。它会返回该任务的名称:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

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

  2. 检查它是否在运行 #

    终端
    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 启动服务即可。作为服务运行介绍了这些命令。

卸载 #

  1. 如果你安装了服务,请先移除它:sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. 要删除已保存的令牌,请启动客户端并按 F12。
  3. 移除客户端。使用 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 会输出它,例如:

Bash
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 客户端在使用同一个令牌运行。请关闭它,或用不同的令牌启动这个客户端。每个令牌只运行一个客户端。

支持