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

Встановлення Localtonet із пакета DEB або RPM

Допомога зі сторінкою
На цій сторінці 9 розділів
  1. Перш ніж почати
  2. Що встановлює пакет
  3. Кроки
  4. Завантажте та встановіть пакет
  5. Задайте свій AuthToken
  6. Перевірте конфігурацію
  7. Увімкніть службу
  8. Запустіть тунель
  9. Служба тунелів або служба VPN
  10. Як працюють служби
  11. Читання журналу
  12. Оновлення
  13. Видалення
  14. Усунення несправностей
  15. Пов’язані сторінки

Пакети 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, встановлює ваш менеджер пакетів. Встановлення пакета не вмикає й не запускає службу: спершу ви задаєте токен, а потім вмикаєте потрібну службу.

Кроки #

  1. Завантажте та встановіть пакет #

    Виберіть пакет для вашого дистрибутива й процесора зі списку в кінці цієї сторінки, а потім встановіть завантажений файл за допомогою apt (DEB) або dnf (RPM). Інструкції з налаштування під кожним пакетом показують точні команди для цього файлу.

  2. Задайте свій AuthToken #

    Відредагуйте /etc/localtonet/auth-token від імені root у текстовому редакторі й замініть DUMMY_AUTH_TOKEN своїм токеном в одному рядку. Потім переконайтеся, що файл може читати лише root:

    Термінал
    sudo chmod 600 /etc/localtonet/auth-token
  3. Перевірте конфігурацію #

    Термінал
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    Перевірка читає файл токена без підключення. Вона відповідає Localtonet headless configuration OK., коли файл містить 33-символьний токен без пробілів. Вона не запитує в серверів Localtonet, чи дійсний токен для вашого облікового запису.

  4. Увімкніть службу #

    Для тунелів увімкніть службу тунелів і прочитайте її журнал:

    Термінал
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Якщо цей пристрій також приєднується до мережі VPN, натомість увімкніть службу VPN. Див. Служба тунелів або служба VPN.

  5. Запустіть тунель #

    Тепер токен показує Онлайн у розділі Мої токени. Створіть і запустіть для нього тунель у панелі керування, див. Швидкий старт.

Служба тунелів або служба VPN #

Обидві служби запускають той самий клієнт і обидві обслуговують ваші тунелі. Вони відрізняються правами, з якими працюють. Увімкніть одну з них: ці дві служби конфліктують, і запуск однієї зупиняє іншу.

localtonet.servicelocaltonet-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 localtonet
Служба VPN
sudo systemctl restart localtonet-vpn.service

У розділі Мої токени стовпець Клієнт показує версію, яку пристрій повідомив востаннє, і позначку Потрібне оновлення, коли доступна новіша.

Видалення #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo 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.deb

    2. Вкажіть свій 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-config

    3. Запустіть службу. Коли перевірка конфігурації пройде успішно:

    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.deb

    2. Вкажіть свій 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-config

    3. Запустіть службу. Коли перевірка конфігурації пройде успішно:

    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.rpm

    2. Вкажіть свій 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-config

    3. Запустіть службу. Коли перевірка конфігурації пройде успішно:

    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.rpm

    2. Вкажіть свій 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-config

    3. Запустіть службу. Коли перевірка конфігурації пройде успішно:

    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.

Підтримка