Встановлення Localtonet із пакета DEB або RPM
На цій сторінці 9 розділів
Пакети DEB і RPM встановлюють клієнт Localtonet разом із двома службами systemd: одна для тунелів, друга для тунелів і VPN. Служби беруть ваш AuthToken із файлу та працюють без терміналу, тож клієнт запускається під час кожного завантаження системи.
Перш ніж почати #
- 64-бітна система Linux: пакети є для x64 і ARM64.
- systemd 247 або новіший і OpenSSL 3, як-от Debian 12, Ubuntu 22.04+ або RHEL 9.
- Доступ root (
sudo). - Ваш AuthToken. Натисніть Копіювати на картці AuthToken у розділі Панель керування або скопіюйте токен із розділу Мої токени.
На інших дистрибутивах, на 32-бітному ARM або якщо вам не потрібен системний пакет, скористайтеся скриптом встановлення чи архівами, описаними на сторінці Linux.
Що встановлює пакет #
| Шлях | Що це |
|---|---|
/usr/bin/localtonet | Команда localtonet. |
/usr/lib/localtonet/ | Сам клієнт. |
/usr/lib/systemd/system/localtonet.service | Служба тунелів. |
/usr/lib/systemd/system/localtonet-vpn.service | Служба VPN і тунелів. |
/etc/localtonet/auth-token | Файл токена. Читати його може лише root. Встановлюється із заповнювачем DUMMY_AUTH_TOKEN. |
Пакет називається localtonet. Його залежності, зокрема OpenSSL 3, iproute2 (iproute в RPM), iptables і kmod, встановлює ваш менеджер пакетів. Встановлення пакета не вмикає й не запускає службу: спершу ви задаєте токен, а потім вмикаєте потрібну службу.
Кроки #
-
Завантажте та встановіть пакет #
Виберіть пакет для вашого дистрибутива й процесора зі списку в кінці цієї сторінки, а потім встановіть завантажений файл за допомогою
apt(DEB) абоdnf(RPM). Інструкції з налаштування під кожним пакетом показують точні команди для цього файлу. -
Задайте свій AuthToken #
Відредагуйте
/etc/localtonet/auth-tokenвід імені root у текстовому редакторі й замінітьDUMMY_AUTH_TOKENсвоїм токеном в одному рядку. Потім переконайтеся, що файл може читати лише root:Терміналsudo chmod 600 /etc/localtonet/auth-token -
Перевірте конфігурацію #
Терміналsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configПеревірка читає файл токена без підключення. Вона відповідає
Localtonet headless configuration OK., коли файл містить 33-символьний токен без пробілів. Вона не запитує в серверів Localtonet, чи дійсний токен для вашого облікового запису. -
Увімкніть службу #
Для тунелів увімкніть службу тунелів і прочитайте її журнал:
Терміналsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceЯкщо цей пристрій також приєднується до мережі VPN, натомість увімкніть службу VPN. Див. Служба тунелів або служба VPN.
-
Запустіть тунель #
Тепер токен показує Онлайн у розділі Мої токени. Створіть і запустіть для нього тунель у панелі керування, див. Швидкий старт.
Служба тунелів або служба VPN #
Обидві служби запускають той самий клієнт і обидві обслуговують ваші тунелі. Вони відрізняються правами, з якими працюють. Увімкніть одну з них: ці дві служби конфліктують, і запуск однієї зупиняє іншу.
localtonet.service | localtonet-vpn.service | |
|---|---|---|
| Для чого | Тунелі | VPN і тунелі |
| Працює від імені | Непривілейованого користувача, якого systemd створює для служби | root, обмеженого мережевими можливостями CAP_NET_ADMIN і CAP_NET_RAW |
| Модуль TUN | Не використовується | Завантажується командою modprobe tun перед запуском клієнта |
| Робоча директорія | /var/lib/localtonet | /var/lib/localtonet-vpn |
Щоб перемкнути пристрій зі служби тунелів на службу VPN:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.serviceЩоб повернутися, так само вимкніть localtonet-vpn.service і увімкніть localtonet.service. Самі мережі VPN налаштовуються в панелі керування, див. Менеджер VPN.
Як працюють служби #
| Поведінка | Подробиці |
|---|---|
| Headless-режим | Обидві служби запускають localtonet --headless. У цьому режимі клієнт ніколи не показує запитів і не зберігає токен у власних налаштуваннях. |
| Токен | systemd передає /etc/localtonet/auth-token службі. Служба не запускається, поки файлу немає. |
| Запуск під час завантаження | Увімкнена служба запускається після появи мережі. |
| Перезапуск | systemd перезапускає клієнт через десять секунд після збою. Він не перезапускає його, якщо клієнт зупинився через недійсний файл токена. Виправте файл і перезапустіть службу самостійно. |
Читання журналу #
У headless-режимі клієнт записує в журнал просто рядки, по одному на кожну зміну:
sudo journalctl -u localtonet.service -f| Рядок | Значення |
|---|---|
Connection: Connected | Стан сеансу. Інші значення: Connecting і Disconnected. |
AuthTokenName: … | Назва токена, з яким клієнт виконав вхід. |
OPEN …, ADDED … | Тунель, що працює на цьому пристрої, з його публічною адресою, протоколом і локальною ціллю. |
STATUS … | Тунель змінив свій статус. |
CLOSED … | Тунель було зупинено або видалено. |
Authentication failed: AuthToken was rejected. | Токен у файлі не приймається. Знову скопіюйте його з розділу «Мої токени». |
Якщо один із цих рядків містив би токен, клієнт замість нього записує [redacted].
Оновлення #
Завантажте новий пакет і встановіть його так само, як і вперше, а потім перезапустіть службу, яку ви використовуєте. Ваш файл токена зберігається.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceУ розділі Мої токени стовпець Клієнт показує версію, яку пристрій повідомив востаннє, і позначку Потрібне оновлення, коли доступна новіша.
Видалення #
sudo apt remove localtonetsudo dnf remove localtonetВидалення пакета зупиняє й вимикає обидві служби. Файл токена є конфігураційним файлом, а менеджери пакетів поводяться з такими обережно: після видалення перевірте, чи /etc/localtonet/auth-token або його збережена копія ще на місці, і видаліть їх, якщо не хочете, щоб токен залишався на комп’ютері.
Усунення несправностей #
Invalid Localtonet headless configuration. Check the token file or environment settings.
Файл токена непридатний. Перевірте, що /etc/localtonet/auth-token існує, що заповнювача DUMMY_AUTH_TOKEN більше немає і що файл містить лише 33-символьний токен без пробілів в одному рядку. Виконуйте перевірку через sudo, бо читати файл може лише root.
Службу ввімкнено, але вона не працює
Виконайте systemctl status localtonet.service. Служба не запускається, поки немає /etc/localtonet/auth-token, і не перезапускається після зупинки через недійсний файл токена. Виправте файл, виконайте перевірку конфігурації, а потім sudo systemctl restart localtonet.service.
У журналі: Authentication failed: AuthToken was rejected.
Файл має правильний формат, але токен не приймається. Знову скопіюйте токен із розділу Мої токени, збережіть його у файл токена й перезапустіть службу.
Служба тунелів зупинилася, коли я запустив службу VPN
Так задумано. Ці дві служби конфліктують, тому systemd зупиняє одну, коли запускається інша. Служба VPN обслуговує й ваші тунелі.
Пакет не встановлюється на моєму дистрибутиві
Пакетам потрібні systemd 247 або новіший і OpenSSL 3. На старіших випусках менеджер пакетів не може задовольнити ці залежності. Натомість скористайтеся скриптом встановлення або архівом зі сторінки Linux.
Пов’язані сторінки #
Пакети наведено нижче. Натисніть Інструкції з налаштування під пакетом, щоб побачити команди з назвою його файлу.
Пакети для Linux
Пакети DEB і RPM для x64 і ARM64. Потрібні systemd 247 або новіший і OpenSSL 3, наприклад Debian 12, Ubuntu 22.04+ або RHEL 9.
-
Debian / Ubuntu · x64
Інструкції з налаштування
1. Встановіть завантажений пакет. Відкрийте термінал у папці з
localtonet-linux-x64.deb.sudo apt install ./localtonet-linux-x64.deb2. Вкажіть свій AuthToken. Відредагуйте
/etc/localtonet/auth-tokenвід імені root і замінітьDUMMY_AUTH_TOKENсвоїм токеном в одному рядку. Потім захистіть файл і перевірте конфігурацію:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустіть службу. Коли перевірка конфігурації пройде успішно:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceДля VPN перейдіть на службу VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceДля оновлення встановіть новий пакет і виконайте
sudo systemctl restart localtonet. Ваша конфігурація збережеться.Якщо ви використовуєте VPN, натомість перезапустіть
localtonet-vpn.service. -
Debian / Ubuntu · ARM64
Інструкції з налаштування
1. Встановіть завантажений пакет. Відкрийте термінал у папці з
localtonet-linux-arm64.deb.sudo apt install ./localtonet-linux-arm64.deb2. Вкажіть свій AuthToken. Відредагуйте
/etc/localtonet/auth-tokenвід імені root і замінітьDUMMY_AUTH_TOKENсвоїм токеном в одному рядку. Потім захистіть файл і перевірте конфігурацію:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустіть службу. Коли перевірка конфігурації пройде успішно:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceДля VPN перейдіть на службу VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceДля оновлення встановіть новий пакет і виконайте
sudo systemctl restart localtonet. Ваша конфігурація збережеться.Якщо ви використовуєте VPN, натомість перезапустіть
localtonet-vpn.service. -
Fedora / RHEL · x64
Інструкції з налаштування
1. Встановіть завантажений пакет. Відкрийте термінал у папці з
localtonet-linux-x64.rpm.sudo dnf install ./localtonet-linux-x64.rpm2. Вкажіть свій AuthToken. Відредагуйте
/etc/localtonet/auth-tokenвід імені root і замінітьDUMMY_AUTH_TOKENсвоїм токеном в одному рядку. Потім захистіть файл і перевірте конфігурацію:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустіть службу. Коли перевірка конфігурації пройде успішно:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceДля VPN перейдіть на службу VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceДля оновлення встановіть новий пакет і виконайте
sudo systemctl restart localtonet. Ваша конфігурація збережеться.Якщо ви використовуєте VPN, натомість перезапустіть
localtonet-vpn.service. -
Fedora / RHEL · ARM64
Інструкції з налаштування
1. Встановіть завантажений пакет. Відкрийте термінал у папці з
localtonet-linux-arm64.rpm.sudo dnf install ./localtonet-linux-arm64.rpm2. Вкажіть свій AuthToken. Відредагуйте
/etc/localtonet/auth-tokenвід імені root і замінітьDUMMY_AUTH_TOKENсвоїм токеном в одному рядку. Потім захистіть файл і перевірте конфігурацію:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустіть службу. Коли перевірка конфігурації пройде успішно:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceДля VPN перейдіть на службу VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceДля оновлення встановіть новий пакет і виконайте
sudo systemctl restart localtonet. Ваша конфігурація збережеться.Якщо ви використовуєте VPN, натомість перезапустіть
localtonet-vpn.service.