Caddy est une plate-forme de serveur extensible qui utilise TLS par défaut.
Sormes · Documentation · Obtenez de l'aide
Alimenté par
La manière la plus simple et la plate-forme multipliée pour commencer est de télécharger Caddy à partir des versions GitHub et de placer le fichier exécutable dans votre chemin.
Voir notre documentation en ligne pour d'autres instructions d'installation.
Exigences:
Remarque: ces étapes n'intégreront pas les informations de version appropriées. Pour cela, veuillez suivre les instructions dans la section suivante.
$ git clone " https://github.com/caddyserver/caddy.git "
$ cd caddy/cmd/caddy/
$ go build
Lorsque vous exécutez Caddy, il peut essayer de se lier aux ports bas, sauf indication contraire dans votre configuration. Si votre système d'exploitation a besoin de privilèges élevés pour cela, vous devrez donner votre nouvelle autorisation binaire à le faire. Sur 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 ça:
$ go run -exec ./setcap.sh main.go
Si vous ne souhaitez pas taper votre mot de passe pour setcap
, utilisez sudo visudo
pour modifier votre fichier sudoers et permettez à votre compte d'utilisateur d'exécuter cette commande sans mot de passe, par exemple:
username ALL=(ALL:ALL) NOPASSWD: /usr/sbin/setcap
Remplacement 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 comment utiliser Caddy, pas d'aller ou un outillage ou votre ordinateur, et nous fournissons ces instructions uniquement pour la commodité; Veuillez apprendre à utiliser votre propre ordinateur à vos propres risques et à effectuer des ajustements nécessaires.
En utilisant notre outil de constructeur, xcaddy
...
$ xcaddy build
... Les étapes suivantes sont automatisées:
mkdir caddy
cd caddy
go mod init caddy
go get github.com/caddyserver/caddy/v2@version
Remplacement de version
par une balise Git, un commissance ou un nom de branche._ "import/path/here"
go build -tags=nobadger,nomysql,nopgx
Le site Web de Caddy a une documentation qui comprend des tutoriels, des guides de démarrage rapide, une référence, etc.
Nous recommandons que tous les utilisateurs - quel que soit leur niveau d'expérience - font notre guide de démarrage 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 parmi lesquels choisir! Cependant, après avoir terminé un tutoriel rapide, veuillez lire plus de documentation pour comprendre le fonctionnement du logiciel. ?
Caddy est le plus souvent utilisé comme serveur HTTPS, mais il convient à tout programme GO de longue date. D'abord et avant tout, il s'agit d'une plate-forme pour exécuter les applications GO. Les "applications" caddy ne sont que des programmes GO qui sont mis en œuvre en tant que modules Caddy. Deux applications - tls
et http
- expédié la norme avec Caddy.
Les applications Caddy bénéficient instantanément de la documentation automatisée, des modifications gracieuses de configuration en ligne via l'API et de l'unification avec d'autres applications Caddy.
Bien que JSON soit le langage de configuration natif de Caddy, Caddy peut accepter la saisie des adaptateurs de configuration qui peut essentiellement convertir n'importe quel format de configuration de votre choix en JSON: CaddyFile, JSON 5, YAML, Toml, Nginx Config, etc.
La principale façon de configurer Caddy est via son API, mais si vous préférez les fichiers de configuration, l'interface de ligne de commande les prend également en charge.
Caddy expose un niveau de contrôle sans précédent par rapport à tout 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 de vos poignées de main TLS à votre support de stockage. Caddy est également ridiculement extensible, avec un système de plugin puissant qui apporte de grandes améliorations par rapport aux autres serveurs Web.
Pour exercer la puissance de cette conception, vous devez savoir comment le document de configuration est structuré. Veuillez consulter notre site de documentation pour plus de détails sur la structure de configuration de Caddy.
La quasi-totalité de la configuration de Caddy est contenue dans un seul document de configuration, plutôt que d'être dispersé sur les drapeaux CLI et les variables Env 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.
Notre site Web a une documentation complète:
https://caddyserver.com/docs/
Les documents sont également open source. Vous pouvez y contribuer ici: https://github.com/caddyserver/website
Nous conseillons aux entreprises utilisant CADDY pour sécuriser un contrat de support via Ardan Labs avant de vous aider.
Un parrainage va très loin! Nous pouvons offrir une aide privée aux sponsors. Si Caddy profite à votre entreprise, veuillez considérer un parrainage. Cela aide non seulement à financer des travaux à temps plein pour assurer la longévité du projet, mais il offre à votre entreprise les ressources, le soutien et les remises dont vous avez besoin; En plus d'être un excellent look pour votre entreprise pour vos clients et vos clients potentiels!
Les individus peuvent échanger de l'aide gratuitement sur notre forum communautaire à https://caddy.community. N'oubliez pas que les gens donnent l'aide de leur temps libre et de leur bonne volonté. La meilleure façon d'obtenir de l'aide est de le donner en premier!
Veuillez utiliser notre suivi de problème uniquement pour les rapports de bogues et les demandes de fonctionnalités, c'est-à-dire des éléments de développement exploitables (les questions de support seront généralement renvoyées aux forums).
Matthew Holt a commencé à développer Caddy en 2014 tout en étudiant l'informatique à l'Université Brigham Young. (Le nom "Caddy" a été choisi parce que ce logiciel aide avec les tâches fastidieuses et banales de servir le Web, et est également un seul endroit pour que plusieurs choses soient organisées ensemble.) Il est rapidement devenu le premier serveur Web à utiliser HTTPS automatiquement et Par défaut, et a maintenant des centaines de contributeurs et a servi des milliards de demandes HTTPS.
Le nom "Caddy" est déposé. Le nom du logiciel est "Caddy", pas "Caddy Server" ou "CaddyServer". Veuillez l'appeler "Caddy" ou, si vous souhaitez clarifier "le serveur Web Caddy". Caddy est une marque déposée de Stack Holdings GmbH.
Caddy est un projet de Zerossl, une société de holdings de pile.
L'hébergement du référentiel de la package Debian est gracieusement fourni par Cloudsmith. Cloudsmith est la seule solution de gestion des packages universelle entièrement hébergée, native du cloud, qui permet à votre organisation de créer, stocker et partager des packages dans n'importe quel format, à n'importe quel endroit, avec une confiance totale.