Установка Localtonet на OpenWrt
Экспериментально OpenWrt 24.10 и 25.12+ x64 и ARM64
На этой странице 12 разделов
- Перед началом
- Поддерживаемые версии и архитектуры
- Что не поддерживается
- Проверьте архитектуру
- OpenWrt 24.10 (opkg)
- Хранилище и память
- Что устанавливает пакет
- Файл токена и конфигурация
- Файл токена
- Конфигурация UCI
- Служба
- Журналы
- Обновление и удаление
- OpenWrt 24.10 (opkg)
- VPN на OpenWrt
- Устранение неполадок
- Связанные страницы
Запустите клиент Localtonet прямо на маршрутизаторе с OpenWrt. Пакет устанавливает клиент, файл токена, конфигурацию UCI и службу, которая запускается вместе с маршрутизатором.
Пакеты для OpenWrt экспериментальные. Это неподписанные файлы, которые вы устанавливаете вручную, а не пакеты из подписанного репозитория OpenWrt. Прежде чем на них полагаться, проверьте совместимость прошивки, свои туннели и VPN на собственном устройстве.
Перед началом #
- Маршрутизатор с поддерживаемой версией OpenWrt и архитектурой процессора (см. следующий раздел).
- Доступ к маршрутизатору с правами root по SSH.
- Доступ маршрутизатора в интернет во время установки. Менеджер пакетов загружает зависимости из репозиториев пакетов вашей прошивки.
- Достаточно свободного места в хранилище и памяти (см. Хранилище и память).
- AuthToken из раздела Мои токены, который не использует больше ни одно устройство.
Поддерживаемые версии и архитектуры #
В OpenWrt менеджер пакетов менялся между выпусками, поэтому есть два формата пакетов. Выберите тот, что подходит вашей прошивке:
| Версия OpenWrt | Формат пакета | Менеджер пакетов | Архитектуры |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 и новее | APK v3 | apk | x64, ARM64 |
Здесь APK — это пакет OpenWrt. Эти файлы .apk не являются приложениями Android и не устанавливаются на телефон. Для Android см. Android.
Что не поддерживается #
- Маршрутизаторы MIPS, MIPSEL и ARMv7. Для этих архитектур пакетов нет.
- Установка из репозитория пакетов. Пакеты — это локальные файлы; маршрутизатор не находит и не обновляет их через
opkg updateилиapk update. - Принудительная установка пакета для другой архитектуры. Никогда не отключайте проверку архитектуры в менеджере пакетов.
Проверьте архитектуру #
Архитектура пакета должна совпадать с вашей прошивкой. Узнайте у маршрутизатора, какие архитектуры он принимает:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archМаршрутизатор x64 сообщает x86_64. Маршрутизаторы ARM64 сообщают имя, которое начинается с aarch64_ и различается между сборками прошивки. К каждому пакету прилагается короткий файл с инструкциями, в котором указана точная архитектура пакета, для которой он собран, например x86_64 или aarch64_generic. На странице Загрузки выберите свой пакет в разделе OpenWrt и откройте Инструкция по установке пакета, чтобы её прочитать. Сравните эту архитектуру с тем, что сообщает маршрутизатор. Если они не совпадают, не устанавливайте пакет.
Хранилище и память #
Пакет содержит клиент вместе с собственной средой выполнения, поэтому он намного больше типичного пакета OpenWrt. Проверьте маршрутизатор перед установкой:
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. Свежая установка содержит:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Параметр | Что делает | Значения |
|---|---|---|
enabled | Определяет, запускает ли служба клиент. Пока значение 0, запуск службы ничего не делает. | 0 (по умолчанию) или 1 |
token_file | Путь к файлу, из которого клиент читает токен. | По умолчанию /etc/localtonet/auth-token |
Показать текущие значения можно в любой момент:
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 | Снова запускает службу при загрузке. |
Чтобы выключить клиент, но оставить пакет установленным:
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. Показать его строки или следить за ними в реальном времени:
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) #
opkg remove localtonetOpenWrt 25.12+ (apk)
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.ipk2. Укажите AuthToken. Отредактируйте
/etc/localtonet/auth-tokenот имени root и заменитеDUMMY_AUTH_TOKENсвоим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустите службу. Когда проверка конфигурации пройдёт успешно:
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.ipk2. Укажите AuthToken. Отредактируйте
/etc/localtonet/auth-tokenот имени root и заменитеDUMMY_AUTH_TOKENсвоим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустите службу. Когда проверка конфигурации пройдёт успешно:
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.apk2. Укажите AuthToken. Отредактируйте
/etc/localtonet/auth-tokenот имени root и заменитеDUMMY_AUTH_TOKENсвоим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустите службу. Когда проверка конфигурации пройдёт успешно:
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.apk2. Укажите AuthToken. Отредактируйте
/etc/localtonet/auth-tokenот имени root и заменитеDUMMY_AUTH_TOKENсвоим токеном в одну строку. Затем защитите файл и проверьте конфигурацию:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Запустите службу. Когда проверка конфигурации пройдёт успешно:
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 нужно проверить на целевом устройстве. Никогда не устанавливайте принудительно пакет с неподходящей архитектурой.