Aller au contenu
Runbook

Installer Caddy sur macOS

Serveur web moderne à HTTPS automatique, utilisable comme reverse proxy et serveur de fichiers.

Outilweb-serverreverse-proxyhttpstlshttp

Installation

Caddy (Homebrew) · Homebrew
brew install caddy

Installe le binaire caddy unique.

Vérifier l'installation

Vérifier
caddy version

Service

Démarrer
brew services start caddy
Arrêter
brew services stop caddy
Statut
brew services info caddy
Redémarrer
brew services restart caddy

Fichiers importants

TypeCheminDescription
config/opt/homebrew/etc/CaddyfileCaddyfile par défaut utilisé par le service Homebrew (Apple Silicon ; /usr/local/etc sur Intel).

Ports par défaut

80443

Outils en ligne de commande

  • caddyServeur et CLI : caddy run, caddy reload, caddy file-server, caddy reverse-proxy.

Désinstaller

Désinstaller
brew services stop caddy
brew uninstall caddy

À savoir

  • Se lier aux ports 80/443 nécessite des privilèges élevés ; pour des tests locaux, utilisez une adresse de site comme localhost, que Caddy sert en HTTPS via une autorité de certification locale.
  • Modifiez /opt/homebrew/etc/Caddyfile, puis appliquez les changements avec caddy reload (ou redémarrez le service brew).
  • Pour un serveur statique ponctuel dans le répertoire courant, lancez caddy file-server --listen :8080.

Installation avec Homebrew

brew install caddy installe le binaire caddy unique. Lancez-le en service d'arrière-plan avec brew services start caddy, qui lit /opt/homebrew/etc/Caddyfile (Apple Silicon ; /usr/local/etc sur Intel).

HTTPS local

Pour le développement, une adresse de site localhost fait servir à Caddy du HTTPS via une autorité de certification de confiance locale qu'il installe au premier usage. Les domaines publics sur les ports 80/443 nécessitent ces ports privilégiés (lancez avec des droits élevés).

Usage ponctuel

Sans configuration, caddy file-server --listen :8080 sert le répertoire courant, et caddy reverse-proxy --from localhost:8080 --to localhost:3000 met en place un proxy rapide. Utilisez caddy reload pour appliquer les modifications du Caddyfile sans interruption.