Запуск Localtonet в виде службы
На этой странице 8 разделов
Установите клиент Localtonet как фоновую службу, чтобы он запускался вместе с устройством, продолжал работать после выхода из системы и не требовал открытого терминала. Одна команда регистрирует его в службах Windows, launchd на macOS или systemd на Linux.
Перед началом #
- Консольный клиент установлен на устройстве: Windows, macOS или Linux.
- AuthToken для этого устройства из раздела Мои токены.
- Права администратора: терминал, открытый через Запуск от имени администратора в Windows, или
sudoна macOS и Linux. - В Linux — дистрибутив с systemd. Termux не поддерживается; там используйте приложение Android.
Установили из пакета DEB или RPM, на OpenWrt или в Docker? У них свой способ запуска при загрузке. Вместо этой страницы см. Пакеты DEB и RPM, OpenWrt и Docker.
Установите службу #
Один раз запустите клиент с --install-service и своим токеном. Замените <YOUR_TOKEN> своим AuthToken. Всегда указывайте --authtoken в этой команде: служба подключается с тем токеном, с которым вы её установили.
Windows #
Откройте «Командную строку» или PowerShell от имени администратора в папке, где лежит localtonet, и выполните:
localtonet --install-service --authtoken <YOUR_TOKEN>Клиент создаёт службу Windows с автоматическим запуском и запускает её. Служба видна в services.msc с описанием Localtonet Service. Если служба завершается сбоем, Windows перезапускает её через одну минуту.
macOS
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Клиент записывает задание launchd в /Library/LaunchDaemons/<SERVICE_NAME>.plist, загружает его и запускает. Задание запускается при загрузке, а launchd запускает его снова, если оно завершилось с ошибкой.
Linux
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Клиент записывает юнит systemd в /etc/systemd/system/<SERVICE_NAME>.service, включает его и запускает. Юнит запускается при загрузке, а после сбоя systemd перезапускает его через пять секунд.
Если sudo не находит localtonet, запустите его с указанием пути, например sudo ./localtonet из папки, где он лежит.
При успехе клиент выводит имя службы:
[CLI] Installed service 'Localtonet_AbCdEfGhI'Установка также запускает службу, поэтому отдельная команда запуска не нужна. Теперь вы можете создавать и запускать туннели для этого токена в панели управления.
Имя службы #
Служба называется Localtonet_ и первые девять символов токена, например Localtonet_AbCdEfGhI. На этой странице оно обозначено как <SERVICE_NAME>. Поскольку имя берётся из токена, на одном устройстве можно установить по одной службе на каждый токен, и любой команде управления нужен тот же токен, чтобы найти свою службу.
Что запускает служба #
Служба запускает тот же файл localtonet из того же места с параметрами, которые вы указали в команде установки. Отсюда два вывода:
- Не перемещайте и не удаляйте файл. Определение службы содержит его полный путь. В Linux, если файл находится внутри
/root, установщик копирует его в/usr/local/lib/<SERVICE_NAME>/, и служба запускает эту копию. - Остальные параметры сохраняются. Параметры вроде
--netи--ipили--proxy envв команде установки сохраняются в службе и используются при каждом запуске. См. Справочник по командной строке.
Управление службой #
Используйте тот же токен с одним из этих параметров. На macOS и Linux ставьте перед командой sudo. В Windows для всего, кроме проверки состояния, используйте терминал администратора.
| Команда | Что делает | Вывод при успехе |
|---|---|---|
localtonet --status-service --authtoken <YOUR_TOKEN> | Показывает состояние службы. | [CLI] Service '<SERVICE_NAME>' status: Running |
localtonet --stop-service --authtoken <YOUR_TOKEN> | Останавливает службу. Её туннели переходят в офлайн. Она снова запустится при следующей загрузке. | [CLI] Stopped service '<SERVICE_NAME>'. |
localtonet --start-service --authtoken <YOUR_TOKEN> | Запускает остановленную службу. | [CLI] Started service '<SERVICE_NAME>'. |
localtonet --remove-service --authtoken <YOUR_TOKEN> | Останавливает службу и удаляет её регистрацию. Сам файл localtonet остаётся. | [CLI] Removed service '<SERVICE_NAME>'. |
Состояние — одно из этих значений:
| Состояние | Значение |
|---|---|
Running | Служба работает. |
Stopped | Служба установлена, но не работает. |
Installing | Служба запускается. |
NotFound | Для этого токена служба не установлена. |
Paused | Только в Windows: служба приостановлена. |
Error | Служба завершилась сбоем, или её состояние не удалось прочитать. |
Unknown | Диспетчер служб вернул состояние, которое клиент не распознаёт. |
Со службой можно работать и средствами операционной системы, используя имя службы:
Windows #
Откройте services.msc и найдите <SERVICE_NAME> либо используйте sc в терминале администратора:
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>macOS
sudo launchctl print system/<SERVICE_NAME>Linux
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>Где зарегистрирована служба и где её журналы #
| Система | Регистрация | Журналы |
|---|---|---|
| Windows | Служба Windows с именем <SERVICE_NAME>, тип запуска «автоматически», работает от учётной записи LocalSystem. | У службы нет окна консоли, а установщик не настраивает файл журнала. Проверяйте состояние службы, а устройство и его туннели — в панели управления. |
| macOS | /Library/LaunchDaemons/<SERVICE_NAME>.plist, общесистемное задание launchd. | /var/log/<SERVICE_NAME>.out.log и /var/log/<SERVICE_NAME>.err.log |
| Linux | /etc/systemd/system/<SERVICE_NAME>.service, включён для multi-user.target. | Журнал systemd: journalctl -u <SERVICE_NAME> -f |
Служба не выводит таблицу туннелей, которую клиент показывает в терминале. Состояние устройства и его туннелей смотрите в панели управления.
Смена токена #
Чтобы сменить токен устройства, удалите службу со старым токеном и установите её снова с новым:
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>Что нужно знать #
- Один клиент на токен. Пока служба работает, не запускайте другой клиент Localtonet с тем же токеном ни на этом устройстве, ни на другом. Второй клиент, подключившийся с токеном, отключает первый.
- Обновление клиента. Служба продолжает запускать файл, на который указывает её определение. Остановите службу, замените этот файл новой версией и снова запустите службу.
- Пароли прокси не сохраняются. Команда установки отклоняет URL прокси, содержащий пароль, и параметр
--proxy-user. Устанавливайте с--proxy envи задайте переменные прокси в окружении службы. - Терминал устройств. Если устройство запускает Localtonet как службу, выполните
localtonet --terminal enableв терминале администратора или сsudo, чтобы служба могла использовать результат. См. Терминал устройств.
Устранение неполадок #
| Сообщение | Причина и решение |
|---|---|
[CLI] Install failed: '…' requires elevated (admin/root) privileges. | Команда запущена без прав администратора. Откройте терминал от имени администратора в Windows или используйте sudo на macOS и Linux. В Windows и Linux то же сообщение появляется при запуске, остановке и удалении. |
[CLI] Install failed:, затем Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux) или Plist already exists for … (macOS) | Служба для этого токена уже установлена. Используйте --start-service, чтобы запустить её, или сначала --remove-service, если хотите установить её заново. |
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment. | Команда установки содержала --proxy-user или URL прокси с паролем. Используйте вместо этого --proxy env. |
[CLI] Start failed: … в Windows сразу после установки | Служба уже запущена, потому что установка её запускает. Проверьте командой --status-service. |
Состояние NotFound | Для переданного токена службы не существует. Убедитесь, что это тот токен, с которым вы устанавливали службу. |
Состояние Running, но устройство офлайн в панели управления | Проверьте токен: скопируйте его заново из раздела Мои токены, удалите службу и установите её снова. Также убедитесь, что тот же токен не использует другой клиент. |