caddyserver/caddyServeur web HTTP/1-2-3 multi-plateforme rapide et extensible avec HTTPS automatique
<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 projet <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">Chaque site en HTTPS</h3> <p align="center">Caddy est une plateforme serveur extensible qui utilise TLS par défaut.</p> <p align="center"> <a href="https://github.com/caddyserver/caddy/releases">Versions</a> · <a href="https://caddyserver.com/docs/">Documentation</a> · <a href="https://caddy.community">Obtenir de l'aide</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>Propulsé par</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>Remerciements particuliers à :</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, conçu pour coder avec plusieurs agents IA](https://go.warp.dev/caddy) [Disponible pour MacOS, Linux et Windows](https://go.warp.dev/caddy)<br> </div> <hr> ### Menu - [Fonctionnalités](#features) - [Installation](#install) - [Compiler depuis les sources](#build-from-source) - [Pour le développement](#for-development) - [Avec les informations de version et/ou les plugins](#with-version-information-andor-plugins) - [Démarrage rapide](#quick-start) - [Aperçu](#overview) - [Documentation complète](#full-documentation) - [Obtenir de l'aide](#getting-help) - [À propos](#about) ## [Fonctionnalités](https://caddyserver.com/features) - **Configuration facile** avec le [Caddyfile](https://caddyserver.com/docs/caddyfile) - **Configuration puissante** avec sa [configuration JSON native](https://caddyserver.com/docs/json/) - **Configuration dynamique** avec l'[API JSON](https://caddyserver.com/docs/api) - [**Adaptateurs de configuration**](https://caddyserver.com/docs/config-adapters) si vous n'aimez pas le JSON - **HTTPS automatique** par défaut - [ZeroSSL](https://zerossl.com) et [Let's Encrypt](https://letsencrypt.org) 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](https://caddyserver.com/docs/architecture) 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](https://caddyserver.com/features) ## Installation La façon la plus simple et multiplateforme de commencer est de télécharger Caddy depuis les [versions GitHub](https://github.com/caddyserver/caddy/releases) et de placer le fichier exécutable dans votre PATH. Consultez [notre documentation en ligne](https://caddyserver.com/docs/install) pour d'autres instructions d'installation. ## Compiler depuis les sources Prérequis : - [Go 1.26.0 ou plus récent](https://golang.org/dl/) ### Pour le développement _**Remarque :** Ces étapes [n'intégreront pas les informations de version appropriées](https://github.com/golang/go/issues/29228). Pour cela, veuillez suivre les instructions de la section suivante._ ```bash $ 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 : ```bash $ 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 : ```bash $ go test ./... $ go test ./modules/caddyhttp/tracing/ ``` ### Avec les informations de version et/ou les plugins En utilisant [notre outil de compilation, `xcaddy`](https://github.com/caddyserver/xcaddy)... ```bash $ xcaddy build ``` ...les étapes suivantes sont automatisées : 1. Créer un nouveau dossier : `mkdir caddy` 2. S'y déplacer : `cd caddy` 3. Copier le [main.go de Caddy](https://github.com/caddyserver/caddy/blob/master/cmd/caddy/main.go) dans le dossier vide. Ajoutez les imports pour tous les plugins personnalisés que vous souhaitez ajouter. 4. Initialiser un module Go : `go mod init caddy` 5. (Facultatif) Épingler la version de Caddy : `go get github.com/caddyserver/caddy/v2@version` en remplaçant `version` par un tag git, un commit ou un nom de branche. 6. (Facultatif) Ajouter des plugins en ajoutant leur import : `_ "import/path/here"` 7. Compiler : `go build -tags=nobadger,nomysql,nopgx` ## Démarrage rapide Le [site web de Caddy](https://caddyserver.com/docs/) propose une documentation comprenant des tutoriels, des guides de démarrage rapide, des références et plus encore. **Nous recommandons à tous les utilisateurs — quel que soit leur niveau d'expérience — de suivre notre guide [Getting Started](https://caddyserver.com/docs/getting-started) pour se familiariser avec l'utilisation de Caddy.** Si vous n'avez qu'une minute, [le site web propose plusieurs tutoriels de démarrage rapide](https://caddyserver.com/docs/quick-starts) parmi lesquels choisir ! Cependant, après avoir terminé un tutoriel de démarrage rapide, veuillez lire davantage de documentation pour comprendre comment le logiciel fonctionne. 🙂 ## Aperçu Caddy est le plus souvent utilisé comme serveur HTTPS, mais il convient à tout programme Go de longue durée. Avant tout, c'est une plateforme pour exécuter des applications Go. Les « apps » Caddy ne sont que des programmes Go implémentés sous forme de modules Caddy. Deux apps — `tls` et `http` — sont fournies en standard avec Caddy. Les apps Caddy bénéficient instantanément de la [documentation automatisée](https://caddyserver.com/docs/json/), des [changements de configuration en ligne via API](https://caddyserver.com/docs/api) sans interruption, et de l'unification avec les autres apps Caddy. Bien que [JSON](https://caddyserver.com/docs/json/) soit le langage de configuration natif de Caddy, Caddy peut accepter des entrées provenant d'[adaptateurs de configuration](https://caddyserver.com/docs/config-adapters) qui peuvent essentiellement convertir n'importe quel format de configuration de votre choix en JSON : Caddyfile, JSON 5, YAML, TOML, configuration NGINX, et plus encore. La principale façon de configurer Caddy est via [son API](https://caddyserver.com/docs/api), mais si vous préférez les fichiers de configuration, l'[interface en ligne de commande](https://caddyserver.com/docs/command-line) les prend également en charge. Caddy offre un niveau de contrôle sans précédent comparé à n'importe quel serveur web existant. Dans Caddy, vous définissez généralement les valeurs réelles des types initialisés en mémoire qui alimentent tout, de vos gestionnaires HTTP et poignées de main TLS à votre support de stockage. Caddy est également ridiculement extensible, avec un puissant système de plugins qui apporte de vastes améliorations par rapport aux autres serveurs web. Pour maîtriser la puissance de cette conception, vous devez savoir comment le document de configuration est structuré. Veuillez consulter [notre site de documentation](https://caddyserver.com/docs/) pour plus de détails sur [la structure de configuration de Caddy](https://caddyserver.com/docs/json/). Presque toute la configuration de Caddy est contenue dans un seul document de configuration, plutôt que d'être dispersée à travers des flags CLI, des variables d'environnement et un fichier de configuration comme avec d'autres serveurs web. Cela rend la gestion de la configuration de votre serveur plus simple et réduit les variables/facteurs cachés. ## Documentation complète Notre site web contient une documentation complète : **https://caddyserver.com/docs/** La documentation est également open source. Vous pouvez y contribuer ici : https://github.com/caddyserver/website ## Obtenir de l'aide - Nous conseillons aux entreprises utilisant Caddy de souscrire un contrat de support via [Ardan Labs](https://www.ardanlabs.com) avant d'avoir besoin d'aide. - Un [sponsoring](https://github.com/sponsors/mholt) aide beaucoup ! Nous pouvons offrir une aide privée aux sponsors. Si Caddy bénéficie à votre entreprise, veuillez envisager un sponsoring. Cela aide non seulement à financer un travail à temps plein pour assurer la pérennité du projet, mais fournit aussi à votre entreprise les ressources, le support et les réductions dont vous avez besoin ; tout en donnant une excellente image de votre entreprise auprès de vos clients et clients potentiels ! - Les particuliers peuvent échanger de l'aide gratuitement sur notre forum communautaire à https://caddy.community. Rappelez-vous que les gens donnent de l'aide sur leur temps libre et par bonne volonté. La meilleure façon d'obtenir de l'aide est d'en donner d'abord ! Veuillez utiliser notre [suivi des problèmes](https://github.com/caddyserver/caddy/issues) uniquement pour les rapports de bugs et les demandes de fonctionnalités, c'est-à-dire les éléments de développement exploitables (les questions de support seront généralement renvoyées vers les forums). ## À propos Matthew Holt a commencé à développer Caddy en 2014 alors qu'il étudiait l'informatique à la Brigham Young University. (Le nom « Caddy » a été choisi parce que ce logiciel aide avec les tâches fastidieuses et banales de servir le Web, et est aussi un endroit unique où plusieurs choses peuvent être organisées ensemble.) Il est rapidement devenu le premier serveur web à utiliser HTTPS automatiquement et par défaut, et compte désormais des centaines de contributeurs et a servi des billions de requêtes HTTPS. **Le nom « Caddy » est une marque déposée.** Le nom du logiciel est « Caddy », pas « Caddy Server » ni « CaddyServer ». Veuillez l'appeler « Caddy » ou, si vous souhaitez préciser, « le serveur web Caddy ». Caddy est une marque déposée de Stack Holdings GmbH. - _Projet sur X : [@caddyserver](https://x.com/caddyserver)_ - _Auteur sur X : [@mholt6](https://x.com/mholt6)_ Caddy est un projet de [ZeroSSL](https://zerossl.com), une société d'HID Global. L'hébergement du dépôt de paquets Debian est gracieusement fourni par [Cloudsmith](https://cloudsmith.com). Cloudsmith est la seule solution de gestion de paquets universelle, entièrement hébergée et cloud-native, qui permet à votre organisation de créer, stocker et partager des paquets dans n'importe quel format, vers n'importe quel endroit, en toute confiance.
