caddy

un projet

---

Chaque site en HTTPS

Caddy est une plateforme serveur extensible qui utilise TLS par défaut.

Versions · Documentation · Obtenir de l'aide

       
 

Propulsé par

---

Menu

• Fonctionnalités
• Installation
• Compiler depuis les sources
  • Pour le développement
  • Avec les informations de version et/ou les plugins
• Démarrage rapide
• Aperçu
• Documentation complète
• Obtenir de l'aide
• À propos

Fonctionnalités

• Configuration facile avec le Caddyfile
• Configuration puissante avec sa configuration JSON native
• Configuration dynamique avec l'API JSON
• Adaptateurs de configuration si vous n'aimez pas le JSON
• HTTPS automatique par défaut
  • ZeroSSL et Let's Encrypt pour les noms publics
  • AC locale entièrement gérée pour les noms internes et les IP
  • Peut se coordonner avec d'autres instances Caddy dans un cluster
  • Repli multi-émetteurs
  • Prise en charge d'Encrypted ClientHello (ECH)
• Reste opérationnel lorsque d'autres serveurs tombent en raison de problèmes liés à TLS/OCSP/certificats
• Prêt pour la production après avoir servi des billions de requêtes et géré des millions de certificats TLS
• Passe à l'échelle pour des centaines de milliers de sites comme prouvé en production
• HTTP/1.1, HTTP/2 et HTTP/3 tous pris en charge par défaut
• Hautement extensible grâce à son architecture modulaire qui permet à Caddy de tout faire sans surcharge
• S'exécute partout avec aucune dépendance externe (pas même libc)
• Écrit en Go, un langage offrant de meilleures garanties de sécurité mémoire que les autres serveurs
• Vraiment agréable à utiliser
• Et bien plus encore à découvrir

Installation

La façon la plus simple et multiplateforme de commencer est de télécharger Caddy depuis les versions GitHub et de placer le fichier exécutable dans votre PATH.

Consultez notre documentation en ligne pour d'autres instructions d'installation.

Compiler depuis les sources

Prérequis :

• Go 1.26.0 ou plus récent

Pour le développement

Remarque : Ces étapes n'intégreront pas les informations de version appropriées. Pour cela, veuillez suivre les instructions de la section suivante.

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

Lorsque vous exécutez Caddy, il peut tenter de se lier à des ports bas, sauf indication contraire dans votre configuration. Si votre système d'exploitation exige des privilèges élevés pour cela, vous devrez donner à votre nouveau binaire la permission de le faire. Sous Linux, cela peut être fait facilement avec : sudo setcap cap_net_bind_service=+ep ./caddy

Si vous préférez utiliser go run qui ne crée que des binaires temporaires, vous pouvez toujours le faire avec le setcap.sh inclus comme ceci :

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

Si vous ne voulez pas taper votre mot de passe pour setcap, utilisez sudo visudo pour modifier votre fichier sudoers et autoriser votre compte utilisateur à exécuter cette commande sans mot de passe, par exemple :

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

en remplaçant username par votre nom d'utilisateur réel. Soyez prudent et ne faites cela que si vous savez ce que vous faites ! Nous ne sommes qualifiés que pour documenter l'utilisation de Caddy, pas les outils Go ni votre ordinateur, et nous fournissons ces instructions uniquement pour votre commodité ; veuillez apprendre à utiliser votre propre ordinateur à vos propres risques et apporter les ajustements nécessaires.

Ensuite, vous pouvez exécuter les tests dans tous les modules ou dans un module spécifique :

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

Avec les informations de version et/ou les plugins

En utilisant notre outil de compilation, xcaddy...

$ xcaddy build

...les étapes suivantes sont automatisées :