M-Abozaid/esp32-c3-adblock

Что это?

Ключевые возможности

• 01Отвечает 0.0.0.0 на DNS-запросы по UDP для заблокированных доменов, остальные запросы пересылает вышестоящему резолверу.
• 02Хранит блок-лист во flash-памяти в виде 40-битных хешей, используя около 50 КБ RAM и не требуя PSRAM.
• 03Веб-панель со статистикой блокировок для каждого клиента и пользовательскими списками блокировки и разрешений.
• 04Обновление прошивки и блок-листов по воздуху, а также запланированная загрузка блок-листов с удалённого источника.
• 05Настройка WiFi через captive portal и обнаружение по mDNS-адресу c3adblock.local.
• 06Сборщик блок-листов поддерживает hosts-файлы, обычные списки доменов и базовые правила AdGuard.

Сценарии использования

• Добавить блокировку рекламы и трекеров во всей домашней сети через роутер, не покупая Raspberry Pi.
• Запустить маломощный дополнительный DNS-резолвер, который блокирует домены за основным DNS-сервером.
• Экспериментировать с фильтрацией DNS на недорогой плате ESP32-C3.

Быстрый старт

1. 1

   Скопируйте шаблон secrets и укажите в нём учётные данные для Wi-Fi и панели управления

   cp src/secrets.example.h src/secrets.h
2. 2

   Соберите хеш-таблицу списка блокировки

   python3 tools/build_blocklist.py data/blocklist.bin
3. 3

   Прошейте ESP32-C3 через USB

   pio run -t upload
4. 4

   Прошейте файловую систему списка блокировки через USB

   pio run -t uploadfs

Что важно знать

• !Требуется актуальная версия PlatformIO; старая версия из пакета apt не собирает проект.
• !При объёме флеш-памяти 4 МБ обновления прошивки по OTA ограничивают список блокировки примерно 250 тысячами доменов.
• !Пароли панели управления и OTA необходимо задать в secrets.h, иначе устройство загрузится с общедоступными учётными данными по умолчанию.
• !Трафик передаётся по незашифрованному HTTP с Basic Auth и поэтому не шифруется в локальной сети.

В подборках

Темы

Частые вопросы

Что такое esp32-c3-adblock?

DNS-блокировщик рекламы в стиле Pi-hole для ESP32-C3 за $2: хранит хеши блок-листа во flash-памяти и не требует PSRAM. esp32-c3-adblock превращает компактную плату на базе микроконтроллера ESP32-C3 в сетевой DNS sinkhole. Устройства в вашей сети направляют DNS-запросы на плату: она отвечает 0.0.0.0 для заблокированных доменов, а остальные запросы пересылает вышестоящему резолверу.

esp32-c3-adblock можно использовать бесплатно? Какая у него лицензия?

esp32-c3-adblock распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

esp32-c3-adblock всё ещё поддерживается?

Активно поддерживается. Последний коммит в esp32-c3-adblock — 6 нояб. 2026 г..

Для чего можно использовать esp32-c3-adblock?

Добавить блокировку рекламы и трекеров во всей домашней сети через роутер, не покупая Raspberry Pi. Запустить маломощный дополнительный DNS-резолвер, который блокирует домены за основным DNS-сервером. Экспериментировать с фильтрацией DNS на недорогой плате ESP32-C3.

Как установить esp32-c3-adblock?

Скопируйте шаблон secrets и укажите в нём учётные данные для Wi-Fi и панели управления: cp src/secrets.example.h src/secrets.h Соберите хеш-таблицу списка блокировки: python3 tools/build_blocklist.py data/blocklist.bin Прошейте ESP32-C3 через USB: pio run -t upload Прошейте файловую систему списка блокировки через USB: pio run -t uploadfs

Где скачать esp32-c3-adblock?

Исходный код и инструкции по установке — на GitHub: https://github.com/M-Abozaid/esp32-c3-adblock