Back to projectsVolver a los proyectos

DNS · Código Abierto

ESP32-DNS-Cloudflare

Actualización de DNS con un ESP32

Project imageImagen del proyecto

ESP32-DNS-Cloudflare es un título bastante autoexplicativo para este proyecto: actualizar su DNS de Cloudflare con un ESP32.

Esta es en realidad la segunda iteración del proyecto: la primera la escribí en C, y funcionó perfecto durante un año, pero quería hacerla un poco más ergonómica. Además tenía el gran problema de que mis credenciales de WiFi y el token de la API de Cloudflare estaban escritos directamente en el código, así que nunca lo convertí en un proyecto ni lo subí a un repositorio, el proyecto era una carpeta juntando polvo en una esquina de mi PC.

Quizás debería hablar de la aplicación en sí: por qué la hice, qué hace, y lo más importante, por qué usted, querido lector, elegiría usarla.

El dolor #

No quiero pagar una cuenta de Netflix aparte, sobre todo cuando mis papás han compartido su cuenta conmigo durante los últimos 13 años, más o menos, y funciona perfectamente bien. Cuando me fui de la casa, quise seguir usando la cuenta, pero a algunos ejecutivos no les gusta esa idea. Por suerte, mis papás tienen un router Asus con Open VPN instalado, así que la idea es simple: configurar la VPN, conectarme a la red de mis papás cuando quiera ver algo, y ser feliz.

¡No tan rápido! El problema es que su IP es dinámica, y cada cierto tiempo (como después de un gran apagón) tengo que pedirle a mi papá que me diga su nueva IP, actualizarla en el DNS y recién ahí puedo ver mi serie favorita.

La solución, por supuesto, es tener un Servidor en la casa de mis papás (más bien una Raspberry Pi), con ddclient instalado (y quizás Jellyfin, para ser honesto) para que la Raspi mantenga actualizado un registro DNS. Pero, querido lector, usted probablemente sabe que las Raspis están cada vez más caras, y yo quería montar Home Assistant en mi casa justamente con esa Raspberry Pi, la mismísima que estaba en la casa de mis papás actualizando el DNS. Así que la solución era liberarla.

Revisar la IP de la red y actualizar un registro DNS es tan simple, que prefiero gastar un par de Watts en un microcontrolador en vez de varios Watts más en un SBC completo. Y así nació este proyecto.

También quería tener una forma de conectarme a mi red local usando una VPN de la misma manera, pero eso significaba configurar dos ESP32: hacer un firmware a medida con las credenciales de WiFi y el token de la API de Cloudflare en el código, y revisar que todo funcionara... demasiado trabajo para hacerlo dos veces, así que tuve que implementar un portal web para configurarlo, un logo bonito, y aprender a usar MicroPython.

XKCD pertinente
xkcd #1205: Is It Worth the Time?

Funcionalidades #

Este pequeño Software (¿o debería llamarlo Firmware? A esta altura honestamente no lo sé) maneja algunas cosas con mucha elegancia: después de cargar el script al Microcontrolador, este parte automáticamente en modo AP, el usuario se conecta vía WiFi, y luego accede al portal web.

Credenciales WiFi

El Microcontrolador escanea los SSIDs, usted escribe la contraseña y le asigna un Hostname al dispositivo, muy útil para conectarse al microcontrolador después.

Luego configura el DNS, con una interfaz parecida. Va a necesitar un API Token, el Zone ID de su cuenta, y el nombre del registro DNS. ¡Eso es todo! La app queda configurada y se puede olvidar de ella. La aplicación revisará periódicamente si la IP cambió, y si cambió, actualizará el registro DNS.

Le agregué unas animaciones de LED bonitas y así de un vistazo se puede ver en qué está el dispositivo: respiración lenta para el modo AP, 1 parpadeo al revisar la IP, 3 parpadeos al actualizar el DNS, etc.

En general, creo que la app terminó siendo muy intuitiva, y las animaciones del LED son muy útiles para revisar sin conectar el debugger si la app está funcionando, incluso después de meses encendida. Y es bastante robusta: en los dos lugares donde está corriendo, ¡no he tenido ningún problema! (bueno, al menos no relacionado con la app en sí). Consume poca energía, pero realmente muy poca, y la verdad es que se ve muy cool, es un pequeño aparatito que hace su trabajo sin descanso. Para mí esas son razones suficientes para usarlo, resuelve un problema real, no necesita un servidor voluminoso sino un microcontrolador muy pequeño, y en realidad it just works.

Cazando bugs #

Como dije antes, tuve una versión en C de esta misma idea funcionando por algo así como un año, y nunca tuve problemas, pero después de implementarla en MicroPython, noté que a veces dejaba de funcionar. Pensé que era un problema de la reimplementación, quizás tenía una fuga de memoria, quizás el Runtime era muy pesado para esta tarea, no sé. Así que empecé a investigar, y no encontré nada. Usando el Agente agregué más salida de debug, un test de diagnóstico, y nada, no pude encontrar la causa, pero el bug estaba ahí: el Microcontrolador no se conectaba al endpoint de Cloudflare.

Hace un par de semanas, tenía otro ESP32 corriendo un firmware de ESPHome, y dejaba de funcionar aleatoriamente. ¡Ahora tenía dos microcontroladores corriendo firmwares distintos con un problema similar! Terminé encontrando qué gatillaba el problema, pero no la causa real. Actualizaré esta página apenas termine de trabajar en eso.