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