Un bloqueador DNS de código abierto al estilo de Pi-hole corre en un módulo ESP32-C3 Super Mini de 2 dólares y filtra anuncios y rastreadores para todos los equipos de una red doméstica o de una oficina pequeña. El firmware responde 0.0.0.0 a las consultas por dominios que están en la lista de bloqueo y reenvía el resto a un servidor DNS externo, según contó Open Electronics.
Lo que lo separa de los bloqueadores de red habituales es el método. Los nombres de dominio no se guardan como texto en la RAM, sino en la flash como huellas FNV-1a de 40 bits ordenadas. Así, más de 140.000 dominios ocupan cerca de 0,7 MB de flash y apenas unos 50 KB de RAM, sin necesidad de PSRAM. El proyecto es de Zed (M-Abozaid) y el código está en un repositorio público.
El corazón del sistema es el módulo ESP32-C3FH4. Trae una CPU RISC-V de 32 bits y un solo núcleo que llega a 160 MHz, 400 KB de SRAM, 4 MB de flash, WiFi 4 en 2,4 GHz y un puerto USB Type-C para programarlo. Se alimenta con 5 V por USB y necesita una fuente estable para evitar caídas de tensión cuando transmite la radio. En la versión mínima basta con un módulo ESP32-C3 compacto con USB Type-C conectado directo al puerto USB del router.
Huellas FNV-1a en la flash en vez de texto en la RAM
Cuando llega una consulta DNS por UDP, el firmware en C++ extrae el dominio, calcula su huella incluyendo los sufijos de los dominios padre y hace una búsqueda binaria en la tabla guardada en la flash. Si el dominio está en la lista de bloqueo, responde 0.0.0.0. Si no, reenvía la consulta al servidor de arriba y le devuelve la respuesta al cliente.
Una búsqueda DNS completa toma unos 10 ms, contando cerca de 18 lecturas de la flash y la ida y vuelta por Wi-Fi. La revisión contra la lista de bloqueo, sola, cuesta 50 microsegundos.
¿Cuántos dominios caben en un ESP32-C3?
La capacidad depende de la partición que se elija. Con huellas de 40 bits caben unos 141.000 dominios casi sin colisiones, cerca de 250.000 con particiones de doble aplicación para actualizar el firmware por OTA, o hasta unos 537.000 con una partición de aplicación única y alrededor de una colisión.
En una placa ESP32-C3 de 4 MB, las actualizaciones OTA del firmware exigen dos espacios de aplicación, y eso deja cerca de 1,3 MB de flash para la lista de bloqueo. Con huellas de 32 bits se ahorra flash, pero aparecen unas siete colisiones con 250.000 dominios.
La comparación entre placas queda así:
- ESP32-C3 Super Mini con 4 MB de flash. Más de 140.000 dominios en cerca de 0,7 MB, 50 KB de RAM y 50 microsegundos por revisión.
- ESP32-S3 con 8 MB de PSRAM. Guarda la lista de bloqueo actual y revisa en 50 microsegundos, más o menos el doble de rápido que el ESP32.
- ESP32 con 4 MB de PSRAM. Trunca la lista de bloqueo actual y revisa en 100 microsegundos.
- ESP32-S3 con 16 MB. Cerca de 2,7 millones de dominios con huellas de 40 bits, contra unos 466.000 dominios guardados como texto en 8 MB de PSRAM.
Panel web, portal cautivo y listas por OTA
El panel web responde en c3adblock.local. Muestra las peticiones DNS bloqueadas y permitidas por cliente, permite bloquear equipos específicos y sumar dominios propios a la lista. La configuración inicial del Wi-Fi se hace con un portal cautivo, así que no hace falta escribir las credenciales en el código.
El firmware y la lista de bloqueo se actualizan por OTA. También hay actualizaciones automáticas programadas que descargan archivos de lista ya compilados desde una URL definida por el usuario.
¿Qué se necesita para armarlo?
El software se construye con un sketch de Arduino (ESP32_AdBlocker), el núcleo esp32 de Arduino en versión 3.1.1 o superior y PlatformIO. Para las actualizaciones automáticas de la lista, el firmware usa un cliente WebDAV con autenticación HTTP Basic. Quien quiera reconstruir el proyecto encuentra el código para compilar y los archivos para cargar en el repositorio de Zed (M-Abozaid).
La versión mínima no requiere soldar. Se enchufa el módulo al puerto USB del router, se configura el portal cautivo y se apunta el DHCP del router a la dirección de la placa.
Para una variante cableada, el proyecto también contempla un controlador Ethernet W5500 y un LED RGB WS2812 que indica el estado. El catálogo de Open Electronics incluye la placa Ethernet mini con chip W5500 y el LED RGB direccionable WS2812B.
El código fuente está en github.com/s60sc/ESP32_AdBlocker.




