Встановлення 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 потрібно перевірити на цільовому пристрої. Ніколи не встановлюйте примусово пакет іншої архітектури.