caddy

un proyecto de

---

Todos los sitios en HTTPS

Caddy es una plataforma de servidor extensible que utiliza TLS por defecto.

Versiones · Documentación · Obtener ayuda

       
 

Desarrollado por

---

Menú

• Características
• Instalación
• Compilar desde el código fuente
  • Para desarrollo
  • Con información de versión y/o plugins
• Inicio rápido
• Descripción general
• Documentación completa
• Obtener ayuda
• Acerca de

Características

• Configuración sencilla con el Caddyfile
• Configuración potente con su configuración JSON nativa
• Configuración dinámica con la API JSON
• Adaptadores de configuración si no te gusta JSON
• HTTPS automático por defecto
  • ZeroSSL y Let's Encrypt para nombres públicos
  • CA local totalmente gestionada para nombres internos e IPs
  • Puede coordinarse con otras instancias de Caddy en un clúster
  • Respaldo con múltiples emisores
  • Soporte de Encrypted ClientHello (ECH)
• Se mantiene en funcionamiento cuando otros servidores caen debido a problemas relacionados con TLS/OCSP/certificados
• Listo para producción tras servir billones de peticiones y gestionar millones de certificados TLS
• Escala a cientos de miles de sitios como se ha demostrado en producción
• HTTP/1.1, HTTP/2 y HTTP/3 compatibles por defecto
• Altamente extensible arquitectura modular que permite a Caddy hacer cualquier cosa sin sobrecarga
• Se ejecuta en cualquier lugar sin dependencias externas (ni siquiera libc)
• Escrito en Go, un lenguaje con mayores garantías de seguridad de memoria que otros servidores
• Realmente divertido de usar
• Mucho más por descubrir

Instalación

La forma más sencilla y multiplataforma de empezar es descargar Caddy desde GitHub Releases y colocar el archivo ejecutable en tu PATH.

Consulta nuestra documentación en línea para otras instrucciones de instalación.

Compilar desde el código fuente

Requisitos:

• Go 1.26.0 o posterior

Para desarrollo

Nota: Estos pasos no incrustarán la información de versión adecuada. Para ello, sigue las instrucciones de la siguiente sección.

$ git clone "https://github.com/caddyserver/caddy.git"
$ cd caddy/cmd/caddy/
$ go build

Cuando ejecutes Caddy, puede intentar enlazar a puertos bajos a menos que se especifique lo contrario en tu configuración. Si tu sistema operativo requiere privilegios elevados para esto, deberás dar permiso a tu nuevo binario para hacerlo. En Linux, esto se puede hacer fácilmente con: sudo setcap cap_net_bind_service=+ep ./caddy

Si prefieres usar go run, que solo crea binarios temporales, aún puedes hacerlo con el setcap.sh incluido de esta forma:

$ go run -exec ./setcap.sh main.go

Si no quieres escribir tu contraseña para setcap, usa sudo visudo para editar tu archivo sudoers y permitir que tu cuenta de usuario ejecute ese comando sin contraseña, por ejemplo:

username ALL=(ALL:ALL) NOPASSWD: /usr/sbin/setcap

reemplazando username con tu nombre de usuario real. ¡Ten cuidado y haz esto solo si sabes lo que estás haciendo! Solo estamos cualificados para documentar cómo usar Caddy, no las herramientas de Go ni tu ordenador, y proporcionamos estas instrucciones únicamente por comodidad; aprende a usar tu propio ordenador bajo tu propio riesgo y haz los ajustes necesarios.

Luego puedes ejecutar las pruebas en todos los módulos o en uno específico:

$ go test ./...
$ go test ./modules/caddyhttp/tracing/

Con información de versión y/o plugins

Usando nuestra herramienta de compilación, xcaddy...

$ xcaddy build

...los siguientes pasos se automatizan: