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

Чтение журнала #

В безголовом режиме клиент пишет в журнал простые строки, по одной на каждое изменение:

Терминал
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.

Поддержка