Servidor web con HTTPS automático y Caddy: guía multiplataforma para desarrolladores (Windows, macOS, Linux)

Problema real: Cada vez que levantas un proyecto web local, haces una demo para un cliente o despliegas una API necesitas exponerla con HTTPS. La alternativa clásica implica generar certificados autofirmados (y lidiar con las advertencias del navegador) o usar herramientas como mkcert. En producción, toca configurar Nginx o Apache con Certbot. Todo eso cuesta tiempo, da pereza y añade fricción. Existe una solución más simple y que funciona igual en Windows, macOS y Linux: Caddy.

Caddy es un servidor web moderno y ligero, escrito en Go, que automáticamente obtiene y renueva certificados Let's Encrypt para todos tus dominios, sin configuración extra. En esta guía aprenderás a instalarlo, exponer sitios estáticos, hacer de proxy inverso y usar plantillas, todo con comandos reales y sin dependencias complicadas.

Requisitos previos

• Cualquier sistema operativo: Windows 10/11, macOS (Intel/Apple Silicon), Linux (Ubuntu/Debian/Fedora/etc.).
• Terminal o PowerShell con acceso a internet.
• Para producción con dominios reales: un dominio apuntando (DNS) a la IP de tu máquina y los puertos 80/443 abiertos (en local solo necesitas el binario y un puerto libre).
• (Opcional) Una aplicación web que quieras servir o redirigir (Node.js, Flask, PHP…).

1. Instalar Caddy

Caddy se distribuye como un único binario. Descárgalo desde su web oficial o usa el script de instalación.

Op A: Descarga directa (cualquier SO)

Visita https://caddyserver.com/download y elige tu sistema operativo, arquitectura y los módulos extra que necesites (por ejemplo, caddy-dns/cloudflare si quieres desafíos DNS). Descarga el archivo comprimido, extráelo y coloca el binario en una carpeta de tu PATH.

Op B: Línea de comandos (macOS/Linux/WSL)

# macOS con Homebrew
brew install caddy

# Linux con script oficial
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

Op C: Windows (PowerShell como administrador)

choco install caddy -y
# O descarga el binario y agrégalo al PATH manualmente

Verifica la instalación:

caddy version

2. Primeros pasos: servidor de archivos estáticos con HTTPS local

Caddy puede funcionar con un simple comando file-server sin necesidad de un archivo de configuración (Caddyfile). Ejecuta esto en el directorio que quieres servir:

caddy file-server --domain localhost

Se abrirá un servidor en https://localhost:8443 (Caddy usa TLS incluso para localhost, generando un certificado autofirmado en el que debes confiar manualmente la primera vez). Si quieres HTTP simple para desarrollo local:

caddy file-server --domain localhost --listen :8080

Ahora accede a http://localhost:8080. Para exponerlo en la red local con HTTPS automático, usa tu IP local:

caddy file-server --listen :443 --domain 192.168.1.100

Caddy obtendrá un certificado real si la IP es pública. En red privada, generará uno de confianza limitada.

3. Configuración con Caddyfile

El Caddyfile es un archivo de texto con una sintaxis simple. Crea Caddyfile en la raíz de tu proyecto:

localhost

file_server

Ahora ejecuta:

caddy run

Esto levanta un servidor HTTPS en https://localhost:443 (requiere privilegios de administrador/root para puertos <1024; en desarrollo puedes usar el puerto 8443 con caddy run --config Caddyfile --adapter caddyfile y https://localhost:8443).

Para usar un dominio real, supongamos miapp.example.com:

miapp.example.com {
    root * /var/www/misitio
    file_server
    encode gzip zstd
}

Caddy solicitará automáticamente un certificado Let's Encrypt para ese dominio en cuanto arranque (si el dominio apunta al servidor). Lanza en producción con:

sudo caddy run --config /ruta/Caddyfile

4. Proxy inverso a una aplicación local

Uno de los usos más comunes es poner HTTPS delante de una app que escucha en un puerto interno (ej. Node.js en http://localhost:3000). Crea un Caddyfile:

api.example.com {
    reverse_proxy localhost:3000
}

Caddy maneja el TLS, la redirección HTTP→HTTPS y los encabezados de proxy de forma transparente.

También puedes encadenar varios servicios en subrutas:

example.com {
    route /api/* {
        reverse_proxy localhost:8080
    }
    route /app/* {
        reverse_proxy localhost:9000
    }
    root * /var/www/landing
    file_server
}

5. Renovación automática de certificados

Caddy es el único servidor que gestiona los certificados sin intervención. No hay cron, ni hooks, ni comandos renew. Los certificados se renuevan silenciosamente en segundo plano 30 días antes de expirar. Puedes comprobar el estado con:

caddy list-certificates

6. Errores frecuentes y soluciones

7. Casos prácticos de uso

7.1 Desarrollo local con dominio .test y HTTPS real usando ACME DNS challenge

Si quieres usar dominios miapp.local sin cambiar DNS público, el módulo tls.dns con un proveedor DNS te permite obtener certificados reales para dominios que solo tú controlas. Ejemplo con Cloudflare:

Instala Caddy con el módulo Cloudflare (caddy-dns/cloudflare). Luego en el Caddyfile:

miapp.test {
    tls {
        dns cloudflare {env.CF_API_TOKEN}
    }
    reverse_proxy localhost:3000
}

Define la variable de entorno CF_API_TOKEN con un token API de Cloudflare con permisos de DNS. Ahora miapp.test tendrá un certificado real aunque no esté en la DNS pública.

7.2 Caddy como balanceador de carga

balanceado.example.com {
    reverse_proxy node1:3000 node2:3000 node3:3000 {
        lb_policy random
    }
}

7.3 Servir aplicaciones SPA con ruteo del lado cliente

spa.example.com {
    root * /var/www/frontend
    file_server
    try_files {path} /index.html
}

8. Buenas prácticas

• Usa siempre el Caddyfile versionado junto con tu código fuente. Así despliegas de manera consistente en cualquier entorno.
• Mantén Caddy actualizado. Un simple caddy upgrade (si tienes el módulo correspondiente) o descarga la nueva versión. Los parches de seguridad de Go y TLS son frecuentes.
• Protege el endpoint de administración si usas el API de configuración de Caddy (normalmente en http://localhost:2019). No lo expongas a la red pública.
• Aprovecha encode para compresión (gzip, zstd) en respuestas de archivo estático.
• En producción, redirige www a no‑www (o al revés) con un bloque simple:

www.example.com {
    redir https://example.com{uri}
}

• Personaliza los logs para integración con sistemas de monitoreo (JSON a stdout, syslog, etc.):

example.com {
    log {
        output file /var/log/caddy/access.log
    }
    ...
}

9. Cierre con idea clave

La complejidad de los servidores web tradicionales quedó en el pasado. Con Caddy, HTTPS deja de ser un proyecto aparte para convertirse en una característica automática y fiable. Ya no tienes excusa para exponer servicios sin cifrar, ni siquiera en desarrollo local. Basta un binario y un Caddyfile de cuatro líneas.