
Servidor web rápido y extensible multiplataforma HTTP/1-2-3 con HTTPS automático
<p align="center"> <a href="https://caddyserver.com"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/1d6be89c-df8a-438c-b01d-cef6bf56440a"> <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/3a5b7419-6925-48f6-ae75-d231f4a4f0c2"> <img src="https://github.com/user-attachments/assets/3a5b7419-6925-48f6-ae75-d231f4a4f0c2" alt="Caddy" width="550"> </picture> </a> <br> <h3 align="center">un proyecto de <a href="https://zerossl.com"><img src="https://user-images.githubusercontent.com/55066419/208327323-2770dc16-ec09-43a0-9035-c5b872c2ad7f.svg" height="28" style="vertical-align: -7.7px" valign="middle"></a></h3> </p> <hr> <h3 align="center">Todos los sitios en HTTPS</h3> <p align="center">Caddy es una plataforma de servidor extensible que utiliza TLS por defecto.</p> <p align="center"> <a href="https://github.com/caddyserver/caddy/releases">Versiones</a> · <a href="https://caddyserver.com/docs/">Documentación</a> · <a href="https://caddy.community">Obtener ayuda</a> </p> <p align="center"> <a href="https://github.com/caddyserver/caddy/actions/workflows/ci.yml"><img src="https://github.com/caddyserver/caddy/actions/workflows/ci.yml/badge.svg"></a> <a href="https://www.bestpractices.dev/projects/7141"><img src="https://www.bestpractices.dev/projects/7141/badge"></a> <a href="https://pkg.go.dev/github.com/caddyserver/caddy/v2"><img src="https://img.shields.io/badge/godoc-reference-%23007d9c.svg"></a> <a href="https://x.com/caddyserver" title="@caddyserver on Twitter"><img src="https://img.shields.io/twitter/follow/caddyserver" alt="@caddyserver on Twitter"></a> <a href="https://caddy.community" title="Caddy Forum"><img src="https://img.shields.io/badge/community-forum-ff69b4.svg" alt="Caddy Forum"></a> <br> <a href="https://sourcegraph.com/github.com/caddyserver/caddy?badge" title="Caddy on Sourcegraph"><img src="https://sourcegraph.com/github.com/caddyserver/caddy/-/badge.svg" alt="Caddy on Sourcegraph"></a> <a href="https://cloudsmith.io/~caddy/repos/"><img src="https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith" alt="Cloudsmith"></a> </p> <p align="center"> <b>Desarrollado por</b> <br> <a href="https://github.com/caddyserver/certmagic"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/55066419/206946718-740b6371-3df3-4d72-a822-47e4c48af999.png"> <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/1128849/49704830-49d37200-fbd5-11e8-8385-767e0cd033c3.png"> <img src="https://user-images.githubusercontent.com/1128849/49704830-49d37200-fbd5-11e8-8385-767e0cd033c3.png" alt="CertMagic" width="250"> </picture> </a> </p> <!-- Warp sponsorship requests this section --> <div align="center" markdown="1"> <hr> <sup>Agradecimiento especial a:</sup> <br> <a href="https://go.warp.dev/caddy"> <img alt="Warp sponsorship" width="400" src="https://github.com/user-attachments/assets/c8efffde-18c7-4af4-83ed-b1aba2dda394"> </a> ### [Warp, creado para programar con múltiples agentes de IA](https://go.warp.dev/caddy) [Disponible para MacOS, Linux y Windows](https://go.warp.dev/caddy)<br> </div> <hr> ### Menú - [Características](#features) - [Instalación](#install) - [Compilar desde el código fuente](#build-from-source) - [Para desarrollo](#for-development) - [Con información de versión y/o plugins](#with-version-information-andor-plugins) - [Inicio rápido](#quick-start) - [Descripción general](#overview) - [Documentación completa](#full-documentation) - [Obtener ayuda](#getting-help) - [Acerca de](#about) ## [Características](https://caddyserver.com/features) - **Configuración sencilla** con el [Caddyfile](https://caddyserver.com/docs/caddyfile) - **Configuración potente** con su [configuración JSON nativa](https://caddyserver.com/docs/json/) - **Configuración dinámica** con la [API JSON](https://caddyserver.com/docs/api) - [**Adaptadores de configuración**](https://caddyserver.com/docs/config-adapters) si no te gusta JSON - **HTTPS automático** por defecto - [ZeroSSL](https://zerossl.com) y [Let's Encrypt](https://letsencrypt.org) 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](https://caddyserver.com/docs/architecture) 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](https://caddyserver.com/features) ## Instalación La forma más sencilla y multiplataforma de empezar es descargar Caddy desde [GitHub Releases](https://github.com/caddyserver/caddy/releases) y colocar el archivo ejecutable en tu PATH. Consulta [nuestra documentación en línea](https://caddyserver.com/docs/install) para otras instrucciones de instalación. ## Compilar desde el código fuente Requisitos: - [Go 1.26.0 o posterior](https://golang.org/dl/) ### Para desarrollo _**Nota:** Estos pasos [no incrustarán la información de versión adecuada](https://github.com/golang/go/issues/29228). Para ello, sigue las instrucciones de la siguiente sección._ ```bash $ 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: ```bash $ 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: ```bash $ go test ./... $ go test ./modules/caddyhttp/tracing/ ``` ### Con información de versión y/o plugins Usando [nuestra herramienta de compilación, `xcaddy`](https://github.com/caddyserver/xcaddy)... ```bash $ xcaddy build ``` ...los siguientes pasos se automatizan: 1. Crear una nueva carpeta: `mkdir caddy` 2. Entrar en ella: `cd caddy` 3. Copiar el [main.go de Caddy](https://github.com/caddyserver/caddy/blob/master/cmd/caddy/main.go) en la carpeta vacía. Añade imports para cualquier plugin personalizado que quieras agregar. 4. Inicializar un módulo de Go: `go mod init caddy` 5. (Opcional) Fijar la versión de Caddy: `go get github.com/caddyserver/caddy/v2@version` reemplazando `version` con una etiqueta git, commit o nombre de rama. 6. (Opcional) Añadir plugins agregando su import: `_ "import/path/here"` 7. Compilar: `go build -tags=nobadger,nomysql,nopgx` ## Inicio rápido El [sitio web de Caddy](https://caddyserver.com/docs/) tiene documentación que incluye tutoriales, guías de inicio rápido, referencia y más. **Recomendamos que todos los usuarios -- independientemente de su nivel de experiencia -- realicen nuestra guía de [Primeros pasos](https://caddyserver.com/docs/getting-started) para familiarizarse con el uso de Caddy.** Si solo tienes un minuto, [el sitio web tiene varios tutoriales de inicio rápido](https://caddyserver.com/docs/quick-starts) entre los que elegir. Sin embargo, después de terminar un tutorial de inicio rápido, lee más documentación para entender cómo funciona el software. 🙂 ## Descripción general Caddy se usa con mayor frecuencia como servidor HTTPS, pero es adecuado para cualquier programa Go de larga duración. Ante todo, es una plataforma para ejecutar aplicaciones Go. Las "apps" de Caddy son simplemente programas Go que se implementan como módulos de Caddy. Dos apps -- `tls` y `http` -- se incluyen de serie con Caddy. Las apps de Caddy se benefician al instante de [documentación automatizada](https://caddyserver.com/docs/json/), [cambios de configuración en línea sin interrupciones mediante API](https://caddyserver.com/docs/api) y la unificación con otras apps de Caddy. Aunque [JSON](https://caddyserver.com/docs/json/) es el lenguaje de configuración nativo de Caddy, Caddy puede aceptar entrada de [adaptadores de configuración](https://caddyserver.com/docs/config-adapters) que esencialmente pueden convertir cualquier formato de configuración que elijas a JSON: Caddyfile, JSON 5, YAML, TOML, configuración de NGINX y más. La forma principal de configurar Caddy es a través de [su API](https://caddyserver.com/docs/api), pero si prefieres archivos de configuración, la [interfaz de línea de comandos](https://caddyserver.com/docs/command-line) también los admite. Caddy expone un nivel de control sin precedentes en comparación con cualquier servidor web existente. En Caddy, normalmente estableces los valores reales de los tipos inicializados en memoria que impulsan todo, desde tus manejadores HTTP y handshakes TLS hasta tu medio de almacenamiento. Caddy también es ridículamente extensible, con un potente sistema de plugins que supone enormes mejoras respecto a otros servidores web. Para aprovechar el poder de este diseño, necesitas saber cómo está estructurado el documento de configuración. Consulta [nuestro sitio de documentación](https://caddyserver.com/docs/) para obtener detalles sobre [la estructura de configuración de Caddy](https://caddyserver.com/docs/json/). Casi toda la configuración de Caddy está contenida en un único documento de configuración, en lugar de estar dispersa entre flags de CLI, variables de entorno y un archivo de configuración como ocurre con otros servidores web. Esto hace que gestionar la configuración de tu servidor sea más sencillo y reduce las variables/factores ocultos. ## Documentación completa Nuestro sitio web tiene documentación completa: **https://caddyserver.com/docs/** La documentación también es de código abierto. Puedes contribuir a ella aquí: https://github.com/caddyserver/website ## Obtener ayuda - Aconsejamos a las empresas que usan Caddy que aseguren un contrato de soporte a través de [Ardan Labs](https://www.ardanlabs.com) antes de necesitar ayuda. - ¡Un [patrocinio](https://github.com/sponsors/mholt) ayuda mucho! Podemos ofrecer ayuda privada a los patrocinadores. Si Caddy beneficia a tu empresa, considera un patrocinio. Esto no solo ayuda a financiar el trabajo a tiempo completo para garantizar la longevidad del proyecto, sino que proporciona a tu empresa los recursos, el soporte y los descuentos que necesitas; además de ser una gran imagen para tu empresa ante tus clientes y clientes potenciales. - Los individuos pueden intercambiar ayuda gratuitamente en nuestro foro comunitario en https://caddy.community. Recuerda que las personas ayudan en su tiempo libre y por buena voluntad. ¡La mejor manera de obtener ayuda es darla primero! Utiliza nuestro [rastreador de incidencias](https://github.com/caddyserver/caddy/issues) solo para informes de errores y solicitudes de funcionalidades, es decir, elementos de desarrollo accionables (las preguntas de soporte normalmente se remitirán a los foros). ## Acerca de Matthew Holt comenzó a desarrollar Caddy en 2014 mientras estudiaba informática en la Universidad Brigham Young. (El nombre "Caddy" se eligió porque este software ayuda con las tediosas y mundanas tareas de servir la Web, y también es un único lugar donde organizar múltiples cosas juntas). Pronto se convirtió en el primer servidor web en usar HTTPS automáticamente y por defecto, y ahora tiene cientos de colaboradores y ha servido billones de peticiones HTTPS. **El nombre "Caddy" está registrado como marca.** El nombre del software es "Caddy", no "Caddy Server" ni "CaddyServer". Por favor, llámalo "Caddy" o, si deseas aclararlo, "el servidor web Caddy". Caddy es una marca registrada de Stack Holdings GmbH. - _Proyecto en X: [@caddyserver](https://x.com/caddyserver)_ - _Autor en X: [@mholt6](https://x.com/mholt6)_ Caddy es un proyecto de [ZeroSSL](https://zerossl.com), una empresa de HID Global. El alojamiento del repositorio de paquetes Debian es proporcionado amablemente por [Cloudsmith](https://cloudsmith.com). Cloudsmith es la única solución de gestión de paquetes universal, nativa de la nube y totalmente alojada, que permite a tu organización crear, almacenar y compartir paquetes en cualquier formato, en cualquier lugar, con total confianza.