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

Підтримка