caddyserver/caddyServidor web HTTP/1-2-3 multiplataforma, rápido e extensível, com 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">um projeto <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">Todo site em HTTPS</h3> <p align="center">Caddy é uma plataforma de servidor extensível que usa TLS por padrão.</p> <p align="center"> <a href="https://github.com/caddyserver/caddy/releases">Lançamentos</a> · <a href="https://caddyserver.com/docs/">Documentação</a> · <a href="https://caddy.community">Obter Ajuda</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>Desenvolvido 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>Agradecimento 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, criado para programar com múltiplos agentes de IA](https://go.warp.dev/caddy) [Disponível para MacOS, Linux e Windows](https://go.warp.dev/caddy)<br> </div> <hr> ### Menu - [Recursos](#features) - [Instalação](#install) - [Compilar a partir do código-fonte](#build-from-source) - [Para desenvolvimento](#for-development) - [Com informações de versão e/ou plugins](#with-version-information-andor-plugins) - [Início rápido](#quick-start) - [Visão geral](#overview) - [Documentação completa](#full-documentation) - [Obter ajuda](#getting-help) - [Sobre](#about) ## [Recursos](https://caddyserver.com/features) - **Configuração fácil** com o [Caddyfile](https://caddyserver.com/docs/caddyfile) - **Configuração poderosa** com sua [configuração JSON nativa](https://caddyserver.com/docs/json/) - **Configuração dinâmica** com a [API JSON](https://caddyserver.com/docs/api) - [**Adaptadores de configuração**](https://caddyserver.com/docs/config-adapters) se você não gosta de JSON - **HTTPS automático** por padrão - [ZeroSSL](https://zerossl.com) e [Let's Encrypt](https://letsencrypt.org) para nomes públicos - CA local totalmente gerenciada para nomes internos e IPs - Pode coordenar com outras instâncias do Caddy em um cluster - Fallback multi-emissor - Suporte a Encrypted ClientHello (ECH) - **Permanece ativo quando outros servidores caem** devido a problemas relacionados a TLS/OCSP/certificado - **Pronto para produção** após atender trilhões de requisições e gerenciar milhões de certificados TLS - **Escala para centenas de milhares de sites** como comprovado em produção - **HTTP/1.1, HTTP/2 e HTTP/3** todos suportados por padrão - **Altamente extensível** [arquitetura modular](https://caddyserver.com/docs/architecture) permite que o Caddy faça qualquer coisa sem inchaço - **Executa em qualquer lugar** com **nenhuma dependência externa** (nem mesmo libc) - Escrito em Go, uma linguagem com **garantias de segurança de memória** superiores a outros servidores - Na verdade, **divertido de usar** - Muito mais para [descobrir](https://caddyserver.com/features) ## Instalação A maneira mais simples e multiplataforma de começar é baixar o Caddy do [GitHub Releases](https://github.com/caddyserver/caddy/releases) e colocar o arquivo executável no seu PATH. Consulte [nossa documentação online](https://caddyserver.com/docs/install) para outras instruções de instalação. ## Compilar a partir do código-fonte Requisitos: - [Go 1.26.0 ou mais recente](https://golang.org/dl/) ### Para desenvolvimento _**Nota:** Estes passos [não incorporarão informações de versão adequadas](https://github.com/golang/go/issues/29228). Para isso, siga as instruções na próxima seção._ ```bash $ git clone "https://github.com/caddyserver/caddy.git" $ cd caddy/cmd/caddy/ $ go build ``` Ao executar o Caddy, ele pode tentar se vincular a portas baixas, a menos que especificado de outra forma na sua configuração. Se o seu sistema operacional exigir privilégios elevados para isso, você precisará dar permissão ao seu novo binário para fazê-lo. No Linux, isso pode ser feito facilmente com: `sudo setcap cap_net_bind_service=+ep ./caddy` Se você preferir usar `go run`, que cria apenas binários temporários, você ainda pode fazer isso com o `setcap.sh` incluído, assim: ```bash $ go run -exec ./setcap.sh main.go ``` Se você não quiser digitar sua senha para `setcap`, use `sudo visudo` para editar seu arquivo sudoers e permitir que sua conta de usuário execute esse comando sem senha, por exemplo: ``` username ALL=(ALL:ALL) NOPASSWD: /usr/sbin/setcap ``` substituindo `username` pelo seu nome de usuário real. Por favor, seja cuidadoso e só faça isso se souber o que está fazendo! Estamos qualificados apenas para documentar como usar o Caddy, não ferramentas Go ou seu computador, e estamos fornecendo estas instruções apenas por conveniência; por favor, aprenda a usar seu próprio computador por sua conta e risco e faça quaisquer ajustes necessários. Então você pode executar os testes em todos os módulos ou em um específico: ```bash $ go test ./... $ go test ./modules/caddyhttp/tracing/ ``` ### Com informações de versão e/ou plugins Usando [nossa ferramenta de build, `xcaddy`](https://github.com/caddyserver/xcaddy)... ```bash $ xcaddy build ``` ...os seguintes passos são automatizados: 1. Crie uma nova pasta: `mkdir caddy` 2. Entre nela: `cd caddy` 3. Copie o [main.go do Caddy](https://github.com/caddyserver/caddy/blob/master/cmd/caddy/main.go) para a pasta vazia. Adicione imports para quaisquer plugins personalizados que desejar adicionar. 4. Inicialize um módulo Go: `go mod init caddy` 5. (Opcional) Fixe a versão do Caddy: `go get github.com/caddyserver/caddy/v2@version` substituindo `version` por uma tag git, commit ou nome de branch. 6. (Opcional) Adicione plugins adicionando seu import: `_ "import/path/here"` 7. Compile: `go build -tags=nobadger,nomysql,nopgx` ## Início rápido O [site do Caddy](https://caddyserver.com/docs/) tem documentação que inclui tutoriais, guias de início rápido, referência e muito mais. **Recomendamos que todos os usuários -- independentemente do nível de experiência -- façam nosso guia de [Primeiros Passos](https://caddyserver.com/docs/getting-started) para se familiarizarem com o uso do Caddy.** Se você só tem um minuto, [o site tem vários tutoriais de início rápido](https://caddyserver.com/docs/quick-starts) para escolher! No entanto, após terminar um tutorial de início rápido, leia mais documentação para entender como o software funciona. 🙂 ## Visão geral O Caddy é mais frequentemente usado como um servidor HTTPS, mas é adequado para qualquer programa Go de longa duração. Antes de tudo, é uma plataforma para executar aplicações Go. Os "apps" do Caddy são apenas programas Go implementados como módulos do Caddy. Dois apps -- `tls` e `http` -- vêm de fábrica com o Caddy. Os apps do Caddy se beneficiam instantaneamente de [documentação automatizada](https://caddyserver.com/docs/json/), [alterações de configuração online](https://caddyserver.com/docs/api) sem interrupções e unificação com outros apps do Caddy. Embora [JSON](https://caddyserver.com/docs/json/) seja a linguagem de configuração nativa do Caddy, o Caddy pode aceitar entrada de [adaptadores de configuração](https://caddyserver.com/docs/config-adapters) que podem essencialmente converter qualquer formato de configuração de sua escolha em JSON: Caddyfile, JSON 5, YAML, TOML, configuração NGINX e mais. A principal forma de configurar o Caddy é através de [sua API](https://caddyserver.com/docs/api), mas se você preferir arquivos de configuração, a [interface de linha de comando](https://caddyserver.com/docs/command-line) também os suporta. O Caddy expõe um nível de controle sem precedentes em comparação com qualquer servidor web existente. No Caddy, você geralmente está definindo os valores reais dos tipos inicializados na memória que alimentam tudo, desde seus handlers HTTP e handshakes TLS até seu meio de armazenamento. O Caddy também é ridiculamente extensível, com um poderoso sistema de plugins que traz vastas melhorias em relação a outros servidores web. Para exercer o poder deste design, você precisa saber como o documento de configuração é estruturado. Consulte [nosso site de documentação](https://caddyserver.com/docs/) para detalhes sobre [a estrutura de configuração do Caddy](https://caddyserver.com/docs/json/). Quase toda a configuração do Caddy está contida em um único documento de configuração, em vez de estar espalhada por flags de CLI, variáveis de ambiente e um arquivo de configuração como em outros servidores web. Isso torna o gerenciamento da configuração do seu servidor mais direto e reduz variáveis/fatores ocultos. ## Documentação completa Nosso site tem documentação completa: **https://caddyserver.com/docs/** A documentação também é open source. Você pode contribuir com ela aqui: https://github.com/caddyserver/website ## Obter ajuda - Aconselhamos empresas que usam o Caddy a garantir um contrato de suporte através da [Ardan Labs](https://www.ardanlabs.com) antes que a ajuda seja necessária. - Um [patrocínio](https://github.com/sponsors/mholt) ajuda muito! Podemos oferecer ajuda privada a patrocinadores. Se o Caddy está beneficiando sua empresa, por favor considere um patrocínio. Isso não apenas ajuda a financiar trabalho em tempo integral para garantir a longevidade do projeto, como fornece à sua empresa os recursos, suporte e descontos que você precisa; além de ser uma ótima imagem para sua empresa diante de seus clientes e potenciais clientes! - Indivíduos podem trocar ajuda gratuitamente em nosso fórum da comunidade em https://caddy.community. Lembre-se de que as pessoas ajudam em seu tempo livre e por boa vontade. A melhor maneira de obter ajuda é dar ajuda primeiro! Por favor, use nosso [rastreador de issues](https://github.com/caddyserver/caddy/issues) apenas para relatórios de bugs e solicitações de recursos, ou seja, itens de desenvolvimento acionáveis (perguntas de suporte geralmente serão encaminhadas aos fóruns). ## Sobre Matthew Holt começou a desenvolver o Caddy em 2014 enquanto estudava ciência da computação na Brigham Young University. (O nome "Caddy" foi escolhido porque este software ajuda com as tarefas tediosas e mundanas de servir a Web, e também é um único lugar para múltiplas coisas serem organizadas juntas.) Logo se tornou o primeiro servidor web a usar HTTPS automaticamente e por padrão, e agora tem centenas de contribuidores e já atendeu trilhões de requisições HTTPS. **O nome "Caddy" é uma marca registrada.** O nome do software é "Caddy", não "Caddy Server" ou "CaddyServer". Por favor, chame-o de "Caddy" ou, se desejar esclarecer, "o servidor web Caddy". Caddy é uma marca registrada da Stack Holdings GmbH. - _Projeto no X: [@caddyserver](https://x.com/caddyserver)_ - _Autor no X: [@mholt6](https://x.com/mholt6)_ Caddy é um projeto da [ZeroSSL](https://zerossl.com), uma empresa da HID Global. A hospedagem do repositório de pacotes Debian é gentilmente fornecida pela [Cloudsmith](https://cloudsmith.com). A Cloudsmith é a única solução de gerenciamento de pacotes universal, totalmente hospedada e nativa da nuvem, que permite à sua organização criar, armazenar e compartilhar pacotes em qualquer formato, para qualquer lugar, com total confiança.
