AnnetBox

Прошивка умного роутера на базе OpenWrt для NanoPi R3S

OpenWrt 25.12.6 rockchip / armv8 sing-box extended веб-панель · API · OTA
AnnetBox · 2026 ← → для навигации
Продукт

Софт-роутер, который проксирует весь домашний трафик

AnnetBox — прошивка на OpenWrt для NanoPi R3S. Она превращает коробку в полноценный роутер с прозрачным проксированием: устройства в локальной сети ничего не настраивают, трафик уходит через VPN-сервер автоматически.

Прозрачно

TProxy и redirect на уровне ядра. Клиент не ставит прокси и не знает, что трафик идёт через туннель — приложения работают как обычно.

Управляемо

Своя панель на SvelteKit: серверы, подписки, клиенты, туннели, скорость, журналы и обновления — в одном месте.

Обновляемо

OTA-обновления через собственный releases-сервис: кнопка в панели, проверка целостности, автоматический откат, если новая версия не взлетела.

Продукт2
Платформа

NanoPi R3S · OpenWrt 25.12.6

Аппаратная база и системный стек, на котором собирается пакет AnnetBox.

Железо

SOC
Rockchip RK3566, 4× ARM Cortex-A55
Порты
2× GbE (WAN + LAN), USB 3.0, Wi-Fi 5
Накопитель
microSD/eMMC, корневой раздел расширен до 2 ГБ
MAC
рандомизируются при первом запуске каждой копии

Система

Ядро
Linux 6.12 (OpenWrt 25.12.6)
Архитектура
aarch64_generic, rockchip/armv8
Пакеты
apk (apk-tools 3.x) — ipk больше не принимается
Плоскость данных
sing-box extended 1.13.14 (VLESS / Hysteria2 / XHTTP)
Панель
annetbox-api + статика SvelteKit на порту 80
Платформа3
Архитектура

Из чего собрана прошивка

Веб-панельSvelteKit · статика на :80
→
annetbox-apiGo · REST /api/v1 · сессии · CSRF
→
Состояниеannetbox.yaml + секреты отдельно
Rendererшаблоны → sing-box.json, nftables, dnsmasq
→
Executorвалидация → apply → откат при ошибке
→
Плоскость данныхsing-box + nftables + ip rule
annetbox-updatermanifest → sha256 → backup → apk add → health-check
↔
updates-boxupdates-box.annet.cloud · релиз apk
→
Телеметрияtelemetry.annet.cloud → Prometheus → Grafana
Fail-closed: если отрендеренный конфиг не проходит проверку nftables/sing-box, apply откатывается на предыдущую ревизию — «полусломанный» прокси на коробке не остаётся.
Архитектура4
Возможности

Что умеет коробка

⇄
Прозрачный проксиredirect, tproxy, redirect+tproxy, tun, mixed
⇅
Split tunnelingсписки direct/proxy, домены, IP, kill switch
◎
Мульти-туннелинесколько групп серверов и свой туннель на клиента
⌁
DNS-фильтрацияDNS-захват в sing-box, блок DoH через nftables
↻
ПодпискиVLESS / Hysteria2, авто-обновление по расписанию
◷
Проверка серверовTCP-пинг и HTTP-замер по каждому серверу
↕
MAC-клонпровайдерский IP переезжает на коробку
⤓
OTA-обновленияпо кнопке, с проверкой и откатом
⚡
Speedtest и трафикскорость по Cloudflare и счётчики в реальном времени
⛨
Captive-порталпри первом заходе открывается мастер настройки
◔
Телеметрияopt-in, только технические метрики
⌘
SSH и APIполный доступ к системе и REST-контракт
Возможности5
Интерфейс

Панель управления

Тёмная тема, те же компоненты и палитра, что в текущем UI AnnetBox.

Главная

Состояние WAN и прокси, переключатель «прокси / напрямую», скорость и трафик в реальном времени, быстрый выбор сервера.

Серверы

Список из подписки с пингом и HTTP-замером по каждому серверу: показатели обновляются по мере проверки, переключение — в один клик.

Настройки

Подписка и её URL, WAN (DHCP / статика / PPPoE / MAC-клон), LAN и DHCP, режимы перехвата, туннели, DNS, обновления, пароль, телеметрия.

Интерфейс6
Конфигурация

Как применяются настройки

  1. Состояние лежит в annetbox.yaml, секреты — в отдельных файлах и в конфиг не попадают.
  2. Renderer собирает sing-box.json, правила nftables, dnsmasq и sysctl из шаблонов и состояния.
  3. Executor проверяет результат: sing-box check и nft check.
  4. При успехе — новая ревизия overlay, перезапуск сервисов.
  5. При ошибке — откат на предыдущую ревизию, в панели видно причину.

Ревзии и откат

Ревзии
хранятся в /etc/annetbox/state/history
Откат
кнопка в панели и annetbox-apply -rollback
Экспорт
файл .annetbox — конфиг, при необходимости с секретами
Валидация
GET /config/validate — dry-run без применения
Правки в шаблонах сразу проверяются на коробке: невалидный ruleset не попадает в рантайм, apply останавливается до перезапуска сервисов.
Конфигурация7
Интерфейс

REST API

Тот же контракт, что и у панели: /api/v1, сессия в cookie, CSRF-токен для изменяющих запросов.

Система

  • GET /system/status
  • GET /system/version
  • GET|POST /system/update
  • POST /system/speedtest
  • GET /system/logs

Прокси

  • GET /proxy/servers
  • POST /proxy/servers/{tag}/probe
  • PUT /proxy/active
  • GET|PUT /proxy/modes
  • POST /proxy/refresh

Сеть и конфиг

  • GET|PUT /wan, GET|PUT /lan
  • GET /lan/clients
  • GET /config, POST /config/apply
  • POST /config/rollback
  • GET /config/export
API8
Инфраструктура

Облачные сервисы

Два небольших сервиса в Docker за Traefik — всё, что нужно для обновлений и наблюдаемости.

updates-box.annet.cloud

Хранилище релизов .apk: манифест последней версии, список всех релизов, скачивание и публикация по admin-токену. Публикует CI.

живёт

telemetry.annet.cloud

Приём отчётов, HMAC-токен на устройство, проброс метрик в Pushgateway → Prometheus → Grafana.

живёт

tw.annet.cloud

Grafana с дашбордом AnnetBox Telemetry: кто на связи, YouTube-метрики, задержка и скорость по каждой коробке.

живёт
Инфраструктура9
Наблюдаемость

Что мы измеряем

Отправляется (только при согласии)

  • идентификатор устройства (HWID) и WAN-IP
  • имя активного сервера
  • результат проверки YouTube: доступность, код, TTFB, объём и скорость

Раз в 15 минут, по HTTPS, с токеном, привязанным к устройству.

Не отправляется никогда

  • пароли и хеши
  • URL подписки и её содержимое
  • MAC-адреса и список LAN-клиентов
  • история посещений и содержимое трафика
Телеметрия выключена по умолчанию и включается только галочкой в мастере настройки.
Наблюдаемость10
Безопасность

Что за этим стоит

Доступ

Панель только с LAN, пароль администратора в bcrypt, сессии в cookie, CSRF-токен на изменяющие запросы, SSH по ключу или паролю root.

Обновления

Манифест подписан по SHA-256, версия сравнивается — откат на старшую запрещён, перед установкой снимается бэкап, после — health-check с откатом.

Данные

Секреты лежат отдельно от конфигурации, в экспорте по умолчанию выключены, пароль меняется из панели и сразу применяется.

Безопасность11
Статус

Где мы сейчас

Готово

  • прошивка на NanoPi R3S, сборка apk и публикация через CI
  • прозрачный прокси, split tunneling, kill switch, DNS-фильтрация
  • панель: главная, серверы с прогрессивной проверкой, настройки
  • OTA-обновления с проверкой целостности и откатом
  • облако: releases-сервис и телеметрия с Grafana

В работе

  • расширение списка форматов подписок и протоколов
  • профили подписки с интервалами обновления
  • поддержка дополнительных платформ (Orange Pi R1 Plus LTS)
  • печатная инструкция и страница проекта annet.cloud/annetbox
Статус12

Спасибо

Инструкция первого запуска — в комплекте, на русском языке

AnnetBox · annet.cloud 13