MagiTrickle - Маршрутизация трафика на основе DNS запросов

[Ponywka]

MagiTrickle (произносится как Мэджитрикл) – утилита для точечной маршрутизации сетевого трафика по заданным доменным именам. Представляет собой установочный пакет, устанавливаемый в дополнение к операционной системе маршрутизатора.

Принцип работы основан на подмене основного DNS-сервера через промежуточный компонент без его отключения. Это позволяет перехватывать входящие DNS-запросы, кешировать ответы и сопоставлять IP-адреса с доменными именами. Благодаря этому становится возможной маршрутизация трафика без необходимости очистки DNS-кэша на стороне клиентов. Очистка кэша требуется только при запуске или перезапуске сервиса MagiTrickle, поскольку в этот момент кэш ещё не прогрет, и маршрутизация невозможна до первого запроса к нужному домену.

Установка пакета:

Spoiler

1. Добавление репозитория в пакетный менеджер:

wget -qO- http://bin.magitrickle.dev/packages/add_repo.sh | sh

2. Установка пакета:

opkg update && opkg install magitrickle

3. Запуск пакета:

/opt/etc/init.d/S99magitrickle start

Дальнейшее обновление можно осуществлять с помощью:

opkg update && opkg install magitrickle
/opt/etc/init.d/S99magitrickle restart

Описание типов правил:

Spoiler

Namespace (Именное пространство)

Охватывает указанный домен и все его поддомены.

Например, при записи example.com будут обрабатываться:

✅ example.com
✅ sub.example.com
✅ sub.sub.example.com
❌ anotherexample.com
❌ example.net

 

Wildcard (Подстановочный шаблон)

Шаблон с * и ? — позволяет задавать гибкие условия:

• * — любое количество любых символов
• ? — ровно один любой символ

Например, при записи *example.com будут обрабатываться:

✅ example.com
✅ sub.example.com
✅ sub.sub.example.com
✅ anotherexample.com
❌ example.net

 

Domain (Точный домен)

Правило применяется только к строго указанному домену, без поддоменов.

Например, при записи sub.example.com будут обрабатываться:

❌ example.com
✅ sub.example.com
❌ sub.sub.example.com
❌ anotherexample.com
❌ example.net

 

RegExp (Регулярное выражение)

Для опытных пользователей. Используется парсер dlclark/regexp2.

Например, при записи ^[a-z]*example\.com$ будут обрабатываться:

✅ example.com
❌ sub.example.com
❌ sub.sub.example.com
✅ anotherexample.com
❌ example.net

 

Поддержка:

• Официальный сайт
• Канал Telegram
• Чат Telegram
• Финансовая поддержка проекта
• Исходный код: GitHub / GitLab
• Автоматические сборки: GitHub / GitLab

 

Edited July 26 by Ponywka
Обновлённая инструкция

[FLK]

Название другое можно было бы придумать)

Но тема интересная - подписался) Буду следить за развитием!

Edited February 14 by FLK

[Zeleza]

Доброго дня

Это здорово, что появляются новые продукты, но прошу Вас убрать в названии слово kvas.

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

[bigpu]

25 минут назад, Zeleza сказал:

Придумайте пожалуйста свое собственное

kisel

[Ponywka]

Проект был переименован в "MagiTrickle"!

В связи с переименованием пакета, тем, кто успел установить его со старым именем, перед обновлением нужно будет провести миграцию:

/opt/etc/init.d/S99kvas2 stop
opkg remove kvas2
opkg install magitrickle_<version>_<arch>.ipk
mv /opt/var/lib/kvas2/config.yaml /opt/var/lib/magitrickle/config.yaml
/opt/etc/init.d/S99magitrickle start

 

[keenet07]

Так. А где Квас2? =)))

[Ponywka]

13 minutes ago, keenet07 said:

Так. А где Квас2? =)))

Попросили убрать схожий нейминг: 

 

[FLK]

1 час назад, Ponywka сказал:

Попросили убрать схожий нейминг: 

 

Ну и правильно сделал, индивидуальности добавил)

[Granite]

Хорошо, что нет монструозности, как у подобных по функционалу. Похоже это то, что мне надо. ) Желаю успеха!

[Ponywka]

Версия 0.1.0-9: https://gitea.20101010.xyz/Ponywka/MagiTrickle/actions/runs/38

Исправлены часть правил для IPTables

[FLK]

51 минуту назад, Ponywka сказал:

Версия 0.1.0-9: https://gitea.20101010.xyz/Ponywka/MagiTrickle/actions/runs/38

Исправлены часть правил для IPTables

Вам бы ещё в телеге канал создать, поддержку и траблшутинг своего продукта организовать) цены бы не было)

[Ponywka]

Just now, FLK said:

Вам бы ещё в телеге канал создать, поддержку и траблшутинг своего продукта организовать) цены бы не было)

Так-то могу, прост вряд-ли будет время этим всем заниматься. Всё же делается всё на энтузиазме, который имеет свойство пропадать

 

[FLK]

Только что, Ponywka сказал:

Так-то могу, прост вряд-ли будет время этим всем заниматься. Всё же делается всё на энтузиазме, который имеет свойство пропадать

 

Ну никто не заставляет там висеть целыми сутками, я просто идею подкинул) не более

[Ponywka]

19 minutes ago, FLK said:

Ну никто не заставляет там висеть целыми сутками, я просто идею подкинул) не более

Ну... Адреса занял - а там посмотрю что да как...
https://t.me/MagiTrickle
https://t.me/MagiTrickleChat

Edited February 14 by Ponywka

[Ponywka]

Перевёл автоматические сборки на GitHub: https://github.com/Ponywka/MagiTrickle/releases

[Ponywka]

v0.1.2 (GitHub Release)

• Переход от socat на свой CLI для /etc/ndm/netfilter.d
• Переход на HTTP в UNIX Socket

[FLK]

web-ui в планах я так понимаю?

[Ponywka]

2 hours ago, FLK said:

web-ui в планах я так понимаю?

Ну... Сейчас я делаю API HTTP для CRUD записей + CLI. Условно когда доделаю API - подключится другой разработчик, который будет фронт (WebUI) делать. Сроков не дам, но предположительно уже скоро.

[FLK]

1 час назад, Ponywka сказал:

Ну... Сейчас я делаю API HTTP для CRUD записей + CLI. Условно когда доделаю API - подключится другой разработчик, который будет фронт (WebUI) делать. Сроков не дам, но предположительно уже скоро.

Ну будем ждать)

[Ponywka]

Для v0.1.3 появится тестовый WebUI, как только я смогу убедиться, что в релизе нет критических багов.

 

Edited February 28 by Ponywka

[Ponywka]

v0.1.3 (GitHub Release)

• Добавлен HTTP сервер
• Добавлен API (Swagger документация находится в файле docs/swagger.yaml)
• Реализован базовый WebUI
• Исправлены некоторые ошибки
• Произведён частичный рефакторинг кода

Edited February 23 by Ponywka

[Ponywka]

v0.1.4 (GitHub Release)

• Исправлен `config.yaml.example`
• Исправлено падение приложения при существующем интерфейсе в `DOWN` состоянии

Edited February 23 by Ponywka

[Granite]

Прошу включить комментарии в телеге.

[Ponywka]

On 2/24/2025 at 7:36 PM, Granite said:

Прошу включить комментарии в телеге.

Проблемка в том, что в Telegram нельзя к каналу привязать чат с топиками, а следить за двумя чатами я не очень хочу... В закреплённом сообщении есть ссылка на чат - можно там обсудить что да как.

Edited February 27 by Ponywka

[pegakmop]

А в чем проблема основной чат привязать до канала?)

[Ponywka]

2 hours ago, pegakmop said:

А в чем проблема основной чат привязать до канала?)

 

On 2/25/2025 at 12:14 PM, Ponywka said:

Проблемка в том, что в Telegram нельзя к каналу привязать чат с топиками

 

[Андрей Волосков]

Подскажите, если ставить на внутреннюю память роутера, проблем не будет? 

[pegakmop]

5 часов назад, Ponywka сказал:

Проблемка в том, что в Telegram нельзя к каналу привязать чат с топиками

Та их и сейчас нету🫣

[Ponywka]

1 hour ago, Андрей Волосков said:

Подскажите, если ставить на внутреннюю память роутера, проблем не будет? 

Ну проблема максимум в том, что пакет весит 9 мегабайт в расжатом виде, а так можно.

На счёт веса - будет исправлено в будущем, сейчас пока не до этого.

[Ponywka]

v0.1.5 (GitHub Release)

• Добавлен полноценный WebUI (спасибо @shevernitskiy)
• Старый WebUI переименован в "legacy" (указать в app.httpWeb.skin)
• Добавлена возможность отключать обработку правил для IPv6/IPv4 (app.netfilter.disableIPv6 и app.netfilter.disableIPv4 соответственно)
• Группам теперь можно задавать цвета
• Был возвращён назад пакет socat вместо тяжелого бинарника, а также основной бинарник был сжат с помощью upx[1]

[1] Могут быть проблемы на некоторых архитектурах. Мной было проверено на mipsel - полёт нормальный. Как на других роутерах, увы, неизвестно!