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

Запуск Localtonet в виде службы

Помощь по этой странице
На этой странице 8 разделов
  1. Перед началом
  2. Установите службу
  3. Windows
  4. Имя службы
  5. Что запускает служба
  6. Управление службой
  7. Windows
  8. Где зарегистрирована служба и где её журналы
  9. Смена токена
  10. Что нужно знать
  11. Устранение неполадок
  12. Связанные страницы

Установите клиент 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, и выполните:

Командная строка или PowerShell (от имени администратора)
localtonet --install-service --authtoken <YOUR_TOKEN>

Клиент создаёт службу Windows с автоматическим запуском и запускает её. Служба видна в services.msc с описанием Localtonet Service. Если служба завершается сбоем, Windows перезапускает её через одну минуту.

macOS

Bash
sudo localtonet --install-service --authtoken <YOUR_TOKEN>

Клиент записывает задание launchd в /Library/LaunchDaemons/<SERVICE_NAME>.plist, загружает его и запускает. Задание запускается при загрузке, а launchd запускает его снова, если оно завершилось с ошибкой.

Linux

Bash
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

Bash
sudo launchctl print system/<SERVICE_NAME>

Linux

Bash
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

Служба не выводит таблицу туннелей, которую клиент показывает в терминале. Состояние устройства и его туннелей смотрите в панели управления.

Смена токена #

Чтобы сменить токен устройства, удалите службу со старым токеном и установите её снова с новым:

Bash
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, но устройство офлайн в панели управленияПроверьте токен: скопируйте его заново из раздела Мои токены, удалите службу и установите её снова. Также убедитесь, что тот же токен не использует другой клиент.
Поддержка