Перейти до вмісту
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 у команді встановлення зберігаються в службі й використовуються під час кожного запуску. Див. Довідник CLI.

Керування службою #

Використовуйте той самий токен з одним із цих параметрів. У 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, але на панелі керування пристрій офлайнПеревірте токен: скопіюйте його ще раз зі сторінки Мої токени, видаліть службу та встановіть її знову. Також переконайтеся, що жоден інший клієнт не використовує той самий токен.
Підтримка