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

Установка Localtonet на OpenWrt

Экспериментально OpenWrt 24.10 и 25.12+ x64 и ARM64

Помощь по этой странице
На этой странице 12 разделов
  1. Перед началом
  2. Поддерживаемые версии и архитектуры
  3. Что не поддерживается
  4. Проверьте архитектуру
  5. OpenWrt 24.10 (opkg)
  6. Хранилище и память
  7. Что устанавливает пакет
  8. Файл токена и конфигурация
  9. Файл токена
  10. Конфигурация UCI
  11. Служба
  12. Журналы
  13. Обновление и удаление
  14. OpenWrt 24.10 (opkg)
  15. VPN на OpenWrt
  16. Устранение неполадок
  17. Связанные страницы

Запустите клиент Localtonet прямо на маршрутизаторе с OpenWrt. Пакет устанавливает клиент, файл токена, конфигурацию UCI и службу, которая запускается вместе с маршрутизатором.

Пакеты для OpenWrt экспериментальные. Это неподписанные файлы, которые вы устанавливаете вручную, а не пакеты из подписанного репозитория OpenWrt. Прежде чем на них полагаться, проверьте совместимость прошивки, свои туннели и VPN на собственном устройстве.

Перед началом #

  • Маршрутизатор с поддерживаемой версией OpenWrt и архитектурой процессора (см. следующий раздел).
  • Доступ к маршрутизатору с правами root по SSH.
  • Доступ маршрутизатора в интернет во время установки. Менеджер пакетов загружает зависимости из репозиториев пакетов вашей прошивки.
  • Достаточно свободного места в хранилище и памяти (см. Хранилище и память).
  • AuthToken из раздела Мои токены, который не использует больше ни одно устройство.

Поддерживаемые версии и архитектуры #

В OpenWrt менеджер пакетов менялся между выпусками, поэтому есть два формата пакетов. Выберите тот, что подходит вашей прошивке:

Версия OpenWrtФормат пакетаМенеджер пакетовАрхитектуры
24.10IPKopkgx64, ARM64
25.12 и новееAPK v3apkx64, ARM64

Здесь APK — это пакет OpenWrt. Эти файлы .apk не являются приложениями Android и не устанавливаются на телефон. Для Android см. Android.

Что не поддерживается #

  • Маршрутизаторы MIPS, MIPSEL и ARMv7. Для этих архитектур пакетов нет.
  • Установка из репозитория пакетов. Пакеты — это локальные файлы; маршрутизатор не находит и не обновляет их через opkg update или apk update.
  • Принудительная установка пакета для другой архитектуры. Никогда не отключайте проверку архитектуры в менеджере пакетов.

Проверьте архитектуру #

Архитектура пакета должна совпадать с вашей прошивкой. Узнайте у маршрутизатора, какие архитектуры он принимает:

OpenWrt 24.10 (opkg) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

Маршрутизатор x64 сообщает x86_64. Маршрутизаторы ARM64 сообщают имя, которое начинается с aarch64_ и различается между сборками прошивки. К каждому пакету прилагается короткий файл с инструкциями, в котором указана точная архитектура пакета, для которой он собран, например x86_64 или aarch64_generic. На странице Загрузки выберите свой пакет в разделе OpenWrt и откройте Инструкция по установке пакета, чтобы её прочитать. Сравните эту архитектуру с тем, что сообщает маршрутизатор. Если они не совпадают, не устанавливайте пакет.

Хранилище и память #

Пакет содержит клиент вместе с собственной средой выполнения, поэтому он намного больше типичного пакета OpenWrt. Проверьте маршрутизатор перед установкой:

Bash
df -h
free
  • Флеш-память (overlay). Файлы программы устанавливаются в /usr/lib/localtonet. Маршрутизатору с небольшим флеш-чипом для них может понадобиться extroot (внешнее хранилище в качестве корневого overlay).
  • ОЗУ и /tmp. При запуске клиент распаковывает свои нативные библиотеки в /tmp/localtonet/bundle. В OpenWrt /tmp находится в ОЗУ, поэтому это место занимает память маршрутизатора.

Что устанавливает пакет #

ПутьЧто это
/usr/bin/localtonetКоманда localtonet.
/usr/lib/localtonetФайлы программы.
/etc/localtonet/auth-tokenФайл токена. Пока вы его не замените, он содержит заполнитель DUMMY_AUTH_TOKEN. Доступен для чтения только root.
/etc/config/localtonetКонфигурация службы в UCI.
/etc/init.d/localtonetСкрипт службы (procd).

Пакет зависит от libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft и ip6tables-nft. Менеджер пакетов устанавливает недостающие из репозиториев вашей прошивки, поэтому инструкция по установке сначала обновляет списки пакетов. kmod-tun должен соответствовать ядру установленной прошивки, поэтому всегда берите его из репозиториев этой прошивки.

Файл токена и конфигурация #

Установка пакета ничего не подключает. Служба остаётся выключенной, пока вы не сделаете две вещи: впишете токен в файл токена и включите службу в UCI. Точные команды для вашего пакета приведены в его разделе Инструкция по установке в конце этой страницы; здесь объясняется, что они делают.

Файл токена #

В /etc/localtonet/auth-token хранится ваш AuthToken в одной строке и больше ничего. Замените заполнитель DUMMY_AUTH_TOKEN своим токеном, например с помощью vi. Файл должен быть доступен для чтения только root (режим 600).

Затем инструкция по установке один раз запускает клиент с --headless --authtoken-file /etc/localtonet/auth-token --check-config. Так проверяется файл без подключения к Localtonet:

ВыводЗначение
Localtonet headless configuration OK.Файл содержит корректно оформленный токен: 33 символа, без пробелов. Проверка не доказывает, что токен действителен для вашего аккаунта.
Invalid Localtonet headless configuration. Check the token file or environment settings.Файл отсутствует, всё ещё содержит заполнитель или токен не состоит из 33 символов.

Конфигурация UCI #

Служба читает настройки из /etc/config/localtonet. Свежая установка содержит:

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
ПараметрЧто делаетЗначения
enabledОпределяет, запускает ли служба клиент. Пока значение 0, запуск службы ничего не делает.0 (по умолчанию) или 1
token_fileПуть к файлу, из которого клиент читает токен.По умолчанию /etc/localtonet/auth-token

Показать текущие значения можно в любой момент:

Bash
uci show localtonet

Служба #

Клиент работает как служба procd с именем localtonet. Установка пакета регистрирует её для запуска при загрузке, но клиент запускается, только когда enabled равно 1, а файл токена не пуст. После того как вы задали enabled равным 1 и применили изменение, один раз перезапустите службу; дальше она запускается вместе с маршрутизатором.

КомандаЧто делает
/etc/init.d/localtonet restartОстанавливает и запускает клиент. Выполняйте после изменения файла токена или конфигурации.
/etc/init.d/localtonet stopОстанавливает клиент до следующего перезапуска или перезагрузки.
/etc/init.d/localtonet disableБольше не запускает службу при загрузке.
/etc/init.d/localtonet enableСнова запускает службу при загрузке.

Чтобы выключить клиент, но оставить пакет установленным:

Bash
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restart

Если клиент неожиданно останавливается, procd запускает его снова.

Когда клиент подключён, создавайте и запускайте туннели в панели управления с токеном маршрутизатора. В поле Локальный IP-адрес туннеля может быть 127.0.0.1 для сервиса на самом маршрутизаторе или LAN-адрес любого устройства за маршрутизатором, например 192.168.1.20.

Журналы #

Клиент пишет в системный журнал OpenWrt. Показать его строки или следить за ними в реальном времени:

Bash
logread -e localtonet
logread -f -e localtonet
СтрокаЗначение
Localtonet - headless logКлиент запущен.
Connection: …Состояние соединения с Localtonet.
AuthTokenName: …Имя токена, с которым маршрутизатор выполнил вход.
OPEN …, ADDED …, STATUS …, CLOSED …Туннель этого токена найден, добавлен, изменил статус или удалён.
Authentication failed: AuthToken was rejected.Localtonet не принял токен из файла токена.
AuthToken file missingСлужба включена, но файла токена нет или он пуст.

Обновление и удаление #

Чтобы обновиться, установите более новый пакет поверх старого и перезапустите службу. Файл токена и конфигурация UCI сохраняются. Оба файла также входят в список файлов, которые OpenWrt сохраняет при обновлении прошивки, но сам пакет после прошивки нужно установить заново.

Чтобы удалить клиент:

OpenWrt 24.10 (opkg) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

Удаление пакета останавливает службу и убирает её из последовательности загрузки.

VPN на OpenWrt #

Пакет подтягивает всё, что нужно функции VPN на маршрутизаторе: kmod-tun, ip-full, bash, iptables-nft и ip6tables-nft. Маршрутизация и поведение брандмауэра зависят от вашей прошивки и ваших правил брандмауэра, поэтому проверьте VPN на своём устройстве, прежде чем на него полагаться. Саму функцию описывает Менеджер VPN.

Устранение неполадок #

Менеджер пакетов отклоняет пакет из-за архитектуры

Пакет собран для другой архитектуры, чем ваша прошивка. Сравните вывод opkg print-architecture или apk --print-arch с архитектурой, указанной в файле инструкций пакета (Инструкция по установке пакета на странице Загрузки). Не устанавливайте принудительно. Маршрутизаторы MIPS, MIPSEL и ARMv7 не поддерживаются.

apk отказывается устанавливать файл как ненадёжный

Пакеты APK — это неподписанные локальные файлы. Для их установки нужна опция --allow-untrusted, как показано в инструкции по установке пакета.

Установка завершается ошибкой, потому что не найдена зависимость

Сначала обновите списки пакетов (opkg update или apk update) и убедитесь, что у маршрутизатора есть доступ в интернет. Зависимости берутся из репозиториев вашей прошивки.

Служба включена, но в журнале ничего нет

Проверьте uci show localtonet. Если enabled всё ещё равно 0, задайте 1, примените изменение и перезапустите службу. Если в журнале есть AuthToken file missing, впишите токен в файл, указанный в token_file.

Клиент не запускается или у маршрутизатора заканчивается память

Проверьте свободное место во флеш-памяти и объём памяти с помощью df -h и free. Клиенту нужно место в /usr/lib/localtonet и в /tmp.

OpenWrt

Экспериментально. Выберите IPK для OpenWrt 24.10 или APK v3 для 25.12+. Эти APK-файлы — пакеты OpenWrt, а не приложения для Android.

Только x64 и ARM64. Архитектура пакета должна совпадать с архитектурой прошивки: сверьтесь с инструкцией по установке пакета и выводом opkg print-architecture или apk --print-arch. MIPS, MIPSEL и ARMv7 этими пакетами не поддерживаются. Перед установкой проверьте свободное место и объём RAM.

  • OpenWrt 24.10 · x64 · IPK
    Инструкция по установке

    1. Установите скачанный пакет. Откройте терминал в папке с файлом localtonet-openwrt-24.10-x64.ipk.

    Выполните эти команды на роутере от имени root. Перед установкой убедитесь, что архитектура пакета совпадает с архитектурой прошивки.

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-x64.ipk

    2. Укажите AuthToken. Отредактируйте /etc/localtonet/auth-token от имени root и замените DUMMY_AUTH_TOKEN своим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Для обновления установите новый пакет и выполните /etc/init.d/localtonet restart. Конфигурация сохранится.

  • OpenWrt 24.10 · ARM64 · IPK
    Инструкция по установке

    1. Установите скачанный пакет. Откройте терминал в папке с файлом localtonet-openwrt-24.10-arm64.ipk.

    Выполните эти команды на роутере от имени root. Перед установкой убедитесь, что архитектура пакета совпадает с архитектурой прошивки.

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-arm64.ipk

    2. Укажите AuthToken. Отредактируйте /etc/localtonet/auth-token от имени root и замените DUMMY_AUTH_TOKEN своим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Для обновления установите новый пакет и выполните /etc/init.d/localtonet restart. Конфигурация сохранится.

  • OpenWrt 25.12+ · x64 · APK v3
    Инструкция по установке

    1. Установите скачанный пакет. Откройте терминал в папке с файлом localtonet-openwrt-25.12-x64.apk.

    Выполните эти команды на роутере от имени root. Перед установкой убедитесь, что архитектура пакета совпадает с архитектурой прошивки.

    Этот локальный APK-пакет не подписан, поэтому для установки нужен флаг --allow-untrusted.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk

    2. Укажите AuthToken. Отредактируйте /etc/localtonet/auth-token от имени root и замените DUMMY_AUTH_TOKEN своим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Для обновления установите новый пакет и выполните /etc/init.d/localtonet restart. Конфигурация сохранится.

  • OpenWrt 25.12+ · ARM64 · APK v3
    Инструкция по установке

    1. Установите скачанный пакет. Откройте терминал в папке с файлом localtonet-openwrt-25.12-arm64.apk.

    Выполните эти команды на роутере от имени root. Перед установкой убедитесь, что архитектура пакета совпадает с архитектурой прошивки.

    Этот локальный APK-пакет не подписан, поэтому для установки нужен флаг --allow-untrusted.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk

    2. Укажите AuthToken. Отредактируйте /etc/localtonet/auth-token от имени root и замените DUMMY_AUTH_TOKEN своим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Для обновления установите новый пакет и выполните /etc/init.d/localtonet restart. Конфигурация сохранится.

Перед установкой прочитайте инструкцию для вашего пакета. Пакеты не подписаны; совместимость прошивки, работу туннелей и VPN нужно проверить на целевом устройстве. Никогда не устанавливайте принудительно пакет с неподходящей архитектурой.

Поддержка