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