caddy

un progetto

---

Ogni sito in HTTPS

Caddy è una piattaforma server estensibile che utilizza TLS per impostazione predefinita.

Release · Documentazione · Ottieni aiuto

       
 

Powered by

---

Menu

• Funzionalità
• Installazione
• Compilazione dal sorgente
  • Per lo sviluppo
  • Con informazioni sulla versione e/o plugin
• Avvio rapido
• Panoramica
• Documentazione completa
• Ottenere aiuto
• Informazioni

Funzionalità

• Configurazione semplice con il Caddyfile
• Configurazione potente con la sua configurazione JSON nativa
• Configurazione dinamica con l'API JSON
• Adattatori di configurazione se non ti piace il JSON
• HTTPS automatico per impostazione predefinita
  • ZeroSSL e Let's Encrypt per i nomi pubblici
  • CA locale completamente gestita per nomi interni e IP
  • Può coordinarsi con altre istanze Caddy in un cluster
  • Fallback multi-emittente
  • Supporto Encrypted ClientHello (ECH)
• Rimane attivo quando altri server vanno giù a causa di problemi legati a TLS/OCSP/certificati
• Pronto per la produzione dopo aver servito trilioni di richieste e gestito milioni di certificati TLS
• Scala fino a centinaia di migliaia di siti come dimostrato in produzione
• HTTP/1.1, HTTP/2 e HTTP/3 tutti supportati per impostazione predefinita
• Altamente estensibile architettura modulare che consente a Caddy di fare qualsiasi cosa senza appesantimenti
• Funziona ovunque con nessuna dipendenza esterna (nemmeno libc)
• Scritto in Go, un linguaggio con garanzie di sicurezza della memoria superiori rispetto ad altri server
• Davvero divertente da usare
• E molto altro ancora da scoprire

Installazione

Il modo più semplice e multipiattaforma per iniziare è scaricare Caddy da GitHub Releases e posizionare il file eseguibile nel tuo PATH.

Consulta la nostra documentazione online per altre istruzioni di installazione.

Compilazione dal sorgente

Requisiti:

• Go 1.26.0 o versione successiva

Per lo sviluppo

Nota: Questi passaggi non incorporeranno le informazioni corrette sulla versione. Per quello, segui le istruzioni nella sezione successiva.

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

Quando esegui Caddy, potrebbe tentare di associarsi a porte basse se non diversamente specificato nella tua configurazione. Se il tuo sistema operativo richiede privilegi elevati per questo, dovrai concedere al tuo nuovo binario il permesso di farlo. Su Linux, questo può essere fatto facilmente con: sudo setcap cap_net_bind_service=+ep ./caddy

Se preferisci usare go run che crea solo binari temporanei, puoi comunque farlo con lo script setcap.sh incluso, in questo modo:

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

Se non vuoi digitare la tua password per setcap, usa sudo visudo per modificare il tuo file sudoers e consentire al tuo account utente di eseguire quel comando senza password, ad esempio:

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

sostituendo username con il tuo nome utente effettivo. Fai attenzione e fallo solo se sai cosa stai facendo! Siamo qualificati solo a documentare come usare Caddy, non gli strumenti Go o il tuo computer, e forniamo queste istruzioni solo per comodità; impara a usare il tuo computer a tuo rischio e fai le modifiche necessarie.

Poi puoi eseguire i test in tutti i moduli o in uno specifico:

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

Con informazioni sulla versione e/o plugin

Usando il nostro strumento di build, xcaddy...

$ xcaddy build

...i seguenti passaggi sono automatizzati: