Перейти к содержанию

Рекомендуемые сообщения

Опубликовано

Привет! Хочу показать KeenProxy, который сейчас использую на своём Keenetic. Я начинал с Kvas. Для одного соединения и белого списка его хватало, но со временем захотелось задать разные маршруты для рабочего ноутбука и телевизора, держать несколько соединений с резервами и менять правила через веб-панель. А если запрос ушёл неожиданным путём, хотелось сразу увидеть, по какому правилу роутер выбрал выход. Из этого и вырос KeenProxy.

KeenProxy запускается на роутере с Entware. В одном бинарнике работают сервис на Go, встроенный sing-box и веб-панель. Исходный код открыт под GPL-3.0-only. Если программа управляет маршрутами и DNS домашней сети, можно посмотреть, как именно она это делает. Репозиторий KeenProxy

keenproxy-overview.thumb.jpg.38d4c900b999c84e4343ad39864b581f.jpg

Обзор веб-панели KeenProxy. На скриншотах в теме используются синтетические данные демо.

Устройства, группы и правила

  • Политика для подсети и исключения по устройствам. Устройство можно оставить на политике своей подсети, включить для него раздельную маршрутизацию, назначить полный туннель через выбранное соединение или исключить его из перехвата приложений. Настройка устройства имеет приоритет над политикой подсети. Устройство задаётся по MAC, а для перехвата используется его текущий IPv4-адрес из таблицы соседей или статический адрес из настройки. В панели также видны обнаруженные имена устройств, если их удалось получить.
  • Группы назначений. Группа может содержать домены с поддоменами, IP-адреса и CIDR. Для совпадений можно выбрать профиль, выход напрямую или блокировку. В раздельном режиме трафик без совпадения идёт напрямую. Глобальные блокирующие группы проверяются раньше политик клиентов, а в раздельном режиме явные домены и адреса имеют приоритет над правилами по странам.
  • GeoIP. Правила могут сопоставлять страны IP-адресов назначения, в том числе по условию «все, кроме выбранных». Можно подключать несколько баз стран с заданным приоритетом и отдельно использовать базы категорий IP-адресов. В панели есть проверка адреса по базам.
  • Пресеты. Готовые наборы доменов можно посмотреть перед импортом. Если включить обновление состава пресета с новой версией приложения, KeenProxy примет изменения набора и сохранит ручные добавления и исключения.
  • Как определяется домен. Когда имя доступно в TLS SNI или HTTP Host, используется оно. Для соединений без читаемого имени KeenProxy может сопоставить IPv4-адрес с DNS-ответами, которые он видел или получил при фоновом разрешении настроенных имён. Общие IP у CDN и собственный шифрованный DNS приложений ограничивают точность такого сопоставления.

Например, домены и подсети рабочих сервисов можно собрать в группу с маршрутом через рабочий WireGuard. Ноутбук в раздельном режиме будет использовать этот профиль для рабочих сервисов и обычный выход для остальных назначений. Телевизору можно оставить политику домашней сети или задать свою. Маршрутизация и порядок правил

Соединения и резервные цепочки

В панели можно добавить WireGuard, импортировать поддерживаемую ссылку или файл и выбрать отдельный outbound или endpoint из JSON sing-box. Поддержка протоколов зависит от сборки. В lite есть WireGuard, VLESS, Trojan, Shadowsocks и SOCKS. Полная сборка добавляет, в частности, VMess, Hysteria2, TUIC и AnyTLS. Для TrustTunnel используется отдельный клиент, с которым KeenProxy работает через локальный SOCKS5. Поддержка XHTTP в текущие сборки не входит. Руководство по соединениям · Состав сборок

В настройках профиля выбирается ближайший резерв. Если у резервного профиля есть свой резерв, получается цепочка. Например, Рабочий WireGuard → Резервный WireGuard → Резервный SOCKS5. Панель показывает всю цепочку, а при проверке конфигурации KeenProxy отклоняет циклы.

  • KeenProxy периодически проверяет доступность профилей HTTP-запросом. По умолчанию интервал составляет 15 секунд.
  • Если активное соединение не отвечает 60 секунд по умолчанию, выбирается первый доступный профиль в порядке цепочки. Если ни один резерв не отвечает, остаётся текущий выход.
  • При восстановлении более приоритетного профиля KeenProxy ждёт 120 секунд стабильных ответов по умолчанию и затем возвращает на него трафик. Пауза помогает при нестабильном соединении. Открытые соединения при переключении могут прерваться.
  • Выход «Напрямую» можно явно добавить как резерв. Тогда при отказе туннельных профилей цепочка сможет вывести трафик напрямую. Для DNS возможность прямого выхода задаётся отдельной политикой.

keenproxy-failover.thumb.jpg.3cd931eb96994ee73886a315fa3971ea.jpg

В демо видна вся цепочка, включая резервы следующих профилей.

В панели видно, какой профиль цепочки сейчас используется. Периодическая проверка показывает доступность проверочного HTTP-запроса. HTTPS с проверкой сертификата и передачу данных можно проверить отдельно в Диагностике. Резервные цепочки

Перехват трафика и NDM-хук в 0.8.0

KeenProxy устанавливает собственные цепочки iptables. TCP участвующих устройств перенаправляется через REDIRECT. Режим TPROXY добавляет перехват UDP при наличии нужной поддержки в ядре и модулях прошивки. Транзитный UDP на порту 443 от участвующих устройств отклоняется, чтобы браузеры могли повторить попытку по TCP. Это важно учитывать для приложений, которым нужен QUIC. Перехват приложений рассчитан на IPv4. При штатной остановке KeenProxy сначала снимает перехват. Схема прохождения трафика

Прошивка может пересобрать таблицы файрвола, например при смене сетевых настроек. В процессе иногда исчезают переходы в цепочки KeenProxy. В версии 0.8.0 мы добавили обработку этих событий через NDM.

  1. В совместимой управляемой установке Keenetic/Netcraze с Entware сервис при наличии сокета NDM и инфраструктуры хуков регистрирует /opt/etc/ndm/netfilter.d/99-keenproxy.sh.
  2. После пересборки IPv4-таблицы nat, filter или mangle NDM вызывает хук. Хук уведомляет работающий демон. Тот последовательно проверяет переходы в свои цепочки, при необходимости восстанавливает правила и проверяет результат. sing-box продолжает работать. Повторные уведомления могут объединяться.
  3. Сторож также запускает проверку каждые 30 секунд по умолчанию. По таймеру можно восстановить правила и там, где хук недоступен, в том числе в экспериментальной установке OpenWrt.
  4. В Журнале → Аудит видно, что запустило попытку восстановления — хук или таймер, какое правило затронуто и чем закончилась повторная проверка. Счётчик увеличивается после подтверждённого восстановления. Время в записи относится к проверке и восстановлению правил. Само восстановление занимает некоторое время, и пакеты во время пересборки могут теряться.

При штатной остановке служба удаляет свой хук. Резервная цепочка и хук отвечают за разные отказы. Цепочка выбирает другой выход, если недоступно соединение. Хук помогает вернуть перехват, если прошивка переписала правила. Изменение в KeenProxy 0.8.0 · Документация Keenetic по хукам OPKG

keenproxy-netfilter-audit.thumb.jpg.4b893044edf562a1b5203e4f44942c0e.jpg

Синтетические записи аудита показывают попытки восстановления по событию NDM и по таймеру.

DNS и фильтры

  • Локальный DNS. KeenProxy принимает DNS по UDP и TCP и перенаправляет запросы на порт 53 с настроенного LAN-интерфейса. Это правило действует на интерфейс целиком, в том числе для устройств, исключённых из перехвата приложений.
  • Маршрут к резолверу. В панели есть каталог провайдеров и ручная настройка. Для прямого обращения доступны обычный UDP, DoH и DoT. Для обращения через выбранное соединение используются DoH и DoT. Можно задать bootstrap IP, а при отказе туннеля выбрать строгий режим или разрешить прямую попытку отдельной настройкой DNS.
  • Фильтрация доменов. Можно взять DNS-список из каталога или подключить свой HTTPS-источник в формате списка доменов, hosts или поддерживаемых DNS adblock-правил. Есть ручное и суточное автообновление, а также исключения для домена и его поддоменов. Явные блокирующие группы имеют приоритет над исключениями из списков. Фильтрация действует на запросы, которые обрабатывает DNS KeenProxy. DNS и фильтры

Веб-панель, конфигурация и диагностика

  • Общий черновик. Профиль, группу и политику устройства можно подготовить на разных экранах и применить одной кнопкой. В настройках есть импорт и экспорт YAML и возможность открыть предыдущую сохранённую конфигурацию как черновик. Полную резервную копию храните у себя, она может содержать реквизиты соединений.
  • Обзор. Видны трафик по соединениям, состояние профилей, загрузка всего роутера и отдельно CPU и RSS процесса KeenProxy со встроенным sing-box.
  • Журналы. Во вкладке Маршрутизация видны устройство, назначение, выбранный выход и правило. Есть поиск, фильтры и группировка повторов. Изменения конфигурации и восстановления файрвола попадают в Аудит, системные сообщения и ошибки — в Систему.
  • Диагностика. Можно отдельно запустить HTTP, HTTPS с проверкой сертификата и передачу 64 КиБ через применённое соединение. Там же видны сведения о сборке, DNS, GeoIP и состоянии перехвата.
  • Архив для разбора проблем. На роутере в Диагностика → Архив для диагностики → Скачать ZIP можно выгрузить все сохранённые записи трёх журналов, обезличенную сводку применённых настроек и состояние службы. Секреты, исходные профили и произвольный текст сообщений исключаются. Имена и адреса удаляются или заменяются метками. Время событий и часть сетевых параметров сохраняются, поэтому архив перед отправкой стоит просмотреть.
  • Обновления. В управляемой установке Entware панель умеет проверить релиз, установить его вручную или по расписанию и откатиться к предыдущей зарегистрированной версии. Автоустановка по умолчанию выключена. Руководство по панели · Состав диагностического ZIP

Где попробовать

Основная платформа — Keenetic и Netcraze с Entware, ARM64 и MIPS little-endian. Нужны компоненты OPKG и Netfilter, совместимые iptables и место под бинарник, базы и журналы. Установщик определяет архитектуру, сверяет файлы релиза с SHA256SUMS и регистрирует службу S99keenproxy. По умолчанию панель открывается на LAN-адресе роутера, порт 8086, токен находится в /opt/etc/keenproxy/token. Перед запуском остановите другие службы, которые перехватывают тот же трафик или DNS. Перехват DNS включается уже при первом запуске с начальной конфигурацией. Подготовка Entware и установка · Релиз 0.8.0

OpenWrt — экспериментальная поддержка. Есть обычные и облегчённые сборки для ARM32, ARM64, MIPS little-endian и MIPS big-endian. Установка ручная. Для испытаний ориентируемся на устройства с минимум 128 МиБ RAM и достаточным местом на накопителе. Перехват зависит от прошивки, модулей и совместимых утилит iptables. На обычном OpenWrt восстановление по таймеру работает независимо от NDM. Совместимость перехвата на физических роутерах, особенно с firewall4, ещё проверяем. Требования для OpenWrt

В браузерном демо можно посмотреть правила, резервные цепочки и примеры событий восстановления на синтетических данных. Если попробуете на роутере, напишите модель, версию прошивки, архитектуру, вариант сборки и режим перехвата. Особенно интересны наблюдения после пересборки файрвола. В аудите можно проверить, сработал ли Хук netfilter или Сторож · таймер. Браузерное демо · GitHub Issues

  • Спасибо 1
  • Лайк 2
  • Не понял 1
Опубликовано

В ближайших планах довести до ума поддержку ascWG, которая не поддерживается sing-box. Мне самому она очень нужна :) Есть два варианта реализации, либо через форк sing-box самой амнезии, либо через промежуточный локальный socks5 прокси и ASC -go клиент. Но это будет только про TCP трафик. Скорее всего на первой итерации сделаем второй вариант, потому что он проще.

Вариант с ascWG через их форк сингбокса будет есть больше памяти, что сразу сузит количество поддерживаемых роутеров :(

 

Присоединяйтесь к обсуждению

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

Гость
Ответить в этой теме...

×   Вставлено с форматированием.   Вставить как обычный текст

  Разрешено использовать не более 75 эмодзи.

×   Ваша ссылка была автоматически встроена.   Отображать как обычную ссылку

×   Ваш предыдущий контент был восстановлен.   Очистить редактор

×   Вы не можете вставлять изображения напрямую. Загружайте или вставляйте изображения по ссылке.

  • Последние посетители   0 пользователей онлайн

    • Ни одного зарегистрированного пользователя не просматривает данную страницу
×
×
  • Создать...

Важная информация

На этом сайте используются файлы cookie. Нажимая "Я принимаю" или продолжая просмотр сайта, вы разрешаете их использование: Политика конфиденциальности.