Установка Localtonet на macOS
На этой странице 9 разделов
- Перед началом
- Установка через Homebrew
- Добавьте tap Localtonet и установите
- Проверьте установку
- Установка вручную
- Скачайте и распакуйте
- Необязательно: переместите его в PATH
- Запустите клиент
- Запустите его с вашим токеном
- Проверьте сессию
- Запуск как службы launchd
- Установите службу
- Проверьте, что она работает
- Что создаёт установка
- Команды службы
- Обновление
- Удаление
- Устранение неполадок
- Связанные страницы
В macOS клиент Localtonet — это консольная программа для компьютеров Mac с процессорами Intel и Apple Silicon. Установите его через Homebrew или из ZIP-архива, запустите со своим AuthToken и установите как службу launchd, если он должен запускаться при каждой загрузке.
Перед началом #
- Аккаунт Localtonet. Если его у вас нет, создайте его бесплатно.
- Ваш AuthToken. Нажмите Копировать на карточке AuthToken в разделе Панель управления или скопируйте токен из раздела Мои токены.
- Для установки через Homebrew: Homebrew.
- Для службы launchd: учётная запись, которая может использовать
sudo.
Установка через Homebrew #
-
Добавьте tap Localtonet и установите #
Tap добавляет в Homebrew сторонний репозиторий, из которого можно устанавливать и обновлять формулы.
Терминал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!
Другой клиент Localtonet на этом Mac уже работает с тем же токеном. Закройте его или запустите этот клиент с другим токеном. На один токен должен приходиться один работающий клиент.