caddy-tui: una interfaz de terminal para cuidar de Caddy en Docker

·

Also available in English: read in English.

Hay un aburrimiento muy particular que solo conocen los dueños de servidores: abrir otra vez el mismo fichero de configuración para añadir una línea más.

Caddy es una gozada. Consigue y renueva solo los certificados HTTPS, y su configuración son unas pocas líneas legibles. Pero yo lo ejecuto en Docker delante de varios servicios, y cada cambio era el mismo ritual: editar el Caddyfile a mano, esperar que fuese válido, recargar, esperar que no se cortase nada. Estaba harto. Y lo que más me frustraba era el silencio de después. ¿Estaba la web arriba? ¿Se acercaba la caducidad de un certificado? ¿Quién estaba golpeando mi servidor a las tres de la madrugada pidiendo /.env? Caddy hacía su trabajo en silencio, y yo no tenía una forma cómoda de verlo.

Así que hice lo que hace cualquiera, aburrido y un poco frustrado, con una terminal delante: escribí la herramienta que echaba de menos. caddy-tui es una interfaz de terminal que edita la configuración por mí, con seguridad, y vigila a Caddy para que yo no tenga que hacerlo. Encuentra sola tu contenedor de Caddy, tu Caddyfile y tu proyecto de compose, y te da un único sitio desde el que editarlo, comprobarlo y vigilarlo.

Qué hace

  • Edición segura: cada cambio se valida antes de guardarse, se hace copia de seguridad antes y se aplica con una recarga que no corta conexiones. Una tecla deshace el último cambio.
  • Asistente para añadir servicios: proxy inverso, proxy inverso con rutas, redirección o página de mantenimiento. Escribe el bloque, lo valida, muestra una vista previa y lo añade. Los mismos formularios editan los bloques existentes.
  • Diagnóstico y reparación: puertos sin publicar, un Caddyfile desfasado dentro del contenedor, destinos inalcanzables, variables sin definir, HTTP plano donde se espera HTTPS. Comprueba cada sitio y te dice el estado, el tiempo de respuesta y la validez del certificado.
  • Certificados: nombres, emisor y caducidad de todo lo que Caddy tiene guardado, con un aviso antes de que uno caduque o cuando Let’s Encrypt está fallando.
  • Tráfico en vivo y estadísticas: peticiones por segundo, códigos de estado, latencia, dominios y direcciones más activos, y el histórico de 24 horas, 7, 30 y 90 días.
  • Bloqueo de escáneres: bloquea una dirección o un rango con una tecla, o deja que banee automáticamente a los escáneres evidentes, al estilo fail2ban, con lista de excepciones y bloqueos que caducan.
  • Avisos por Telegram: una comprobación periódica que te dice cuándo algo falla o se recupera.
  • Actualizar Caddy: compara tu imagen con el registro y ofrece descargarla y recrear Caddy, validando antes tu configuración con la versión nueva para que una versión mala nunca tumbe el sitio.
  • Mudanza: --export e --import llevan tu configuración, y opcionalmente los certificados, a otro servidor.
  • ¿Aún no tienes Caddy? Puede instalar Docker y preparar un primer Caddy por ti, preguntando antes.

No tiene más dependencias que Python 3.8 y Docker. La interfaz está disponible en inglés y castellano, y se cambia con una tecla.

Instalación

En Debian, Ubuntu, Raspberry Pi OS o Armbian, añade una vez el repositorio apt firmado y apt upgrade lo mantiene al día:

curl -fsSL https://mgoreiro.github.io/caddy-tui/apt/caddy-tui.gpg | sudo tee /usr/share/keyrings/caddy-tui.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/caddy-tui.gpg] https://mgoreiro.github.io/caddy-tui/apt stable main" | sudo tee /etc/apt/sources.list.d/caddy-tui.list
sudo apt update && sudo apt install caddy-tui
sudo caddy-tui

El paquete es independiente de la arquitectura, así que sirve igual en x86-64 que en placas ARM. También puedes descargar el .deb desde la página de releases. La huella de la clave y la guía de instalación completa están en el repositorio.

Si quieres verlo funcionando con algo concreto, combina bien con Tossbox, cuya variante HTTPS usa Caddy y que caddy-tui detecta sin configurar nada.

A hombros de gigantes

caddy-tui no sustituye a Caddy; solo cuida de él. Todo el trabajo de verdad lo hace Caddy, creado por Matt Holt y desarrollado por su comunidad de colaboradores, y Let’s Encrypt, que ha hecho que los certificados gratuitos nos parezcan lo normal. Gracias.

caddy-tui es un proyecto independiente y no está afiliado al proyecto Caddy ni cuenta con su respaldo.

El código está en GitHub con licencia MIT. Se agradecen incidencias, ideas y pull requests.