Перейти к содержимому
Localtonet Localtonet Панель управления

Установка Localtonet на macOS

Помощь по этой странице
На этой странице 9 разделов
  1. Перед началом
  2. Установка через Homebrew
  3. Добавьте tap Localtonet и установите
  4. Проверьте установку
  5. Установка вручную
  6. Скачайте и распакуйте
  7. Необязательно: переместите его в PATH
  8. Запустите клиент
  9. Запустите его с вашим токеном
  10. Проверьте сессию
  11. Запуск как службы launchd
  12. Установите службу
  13. Проверьте, что она работает
  14. Что создаёт установка
  15. Команды службы
  16. Обновление
  17. Удаление
  18. Устранение неполадок
  19. Связанные страницы

В macOS клиент Localtonet — это консольная программа для компьютеров Mac с процессорами Intel и Apple Silicon. Установите его через Homebrew или из ZIP-архива, запустите со своим AuthToken и установите как службу launchd, если он должен запускаться при каждой загрузке.

Перед началом #

Установка через Homebrew #

  1. Добавьте tap Localtonet и установите #

    Tap добавляет в Homebrew сторонний репозиторий, из которого можно устанавливать и обновлять формулы.

    Терминал
    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!

Другой клиент Localtonet на этом Mac уже работает с тем же токеном. Закройте его или запустите этот клиент с другим токеном. На один токен должен приходиться один работающий клиент.

Поддержка