← Blog
Un boîtier sélecteur lavande avec une façade ivoire et un levier orange sur fond lavande pâle.
Publié le
2026-11-17

Caddy vs Nginx : choisir un reverse proxy

Caddy et Nginx peuvent se placer entre un client et une application, recevoir des requêtes HTTP et les transmettre à un serveur applicatif. Caddy constitue un bon point de départ pour une petite installation lorsque sa configuration concise et son automatisation HTTPS répondent au besoin. Nginx reste un choix pertinent si votre équipe l’exploite déjà ou dépend de sa configuration et de ses modules.

La comparaison porte surtout sur le travail autour du reverse proxy : certificats, traitement des requêtes, en-têtes de confiance, mises à jour, rechargements et diagnostic des erreurs. Si vous devez encore décider qui exploitera cette infrastructure, consultez le guide de l’hébergement d’API, en anglais.

Comparer les exigences d’exploitation

DécisionCaddyNginx
Un petit reverse proxy HTTPUn Caddyfile permet d’exprimer le routage de base avec peu de configuration.Des blocs server et location définissent explicitement le routage et les paramètres de transmission.
Automatisation des certificatsHTTPS automatique est intégré, sous réserve des exigences de nom d’hôte et de validation.L’automatisation peut utiliser le module ACME officiel ou un autre outil de gestion des certificats. Vérifiez le paquet et les modules installés.
Configuration existanteÉvaluez l’effort de migration et les modules nécessaires à l’application.Conserver une configuration fonctionnelle et maintenue peut coûter moins cher que la remplacer.
Modifications de configurationLa CLI peut valider et recharger la configuration via l’API d’administration.Les commandes de vérification et de rechargement permettent de contrôler les mises à jour.
Performances en productionMesurez la charge de travail et le déploiement réels.Mesurez la charge de travail et le déploiement réels. Des résultats Windows ne représentent pas la capacité sous Linux.

Cette comparaison concerne Caddy et Nginx eux-mêmes. Nginx Proxy Manager est une application de gestion distincte. Une fonction proposée dans Nginx Plus n’est pas nécessairement disponible dans toutes les installations open source de Nginx.

Vérifier le fonctionnement de HTTPS

HTTPS automatique de Caddy gère les certificats et les redirections de HTTP vers HTTPS lorsque la configuration le permet. L’obtention d’un certificat public dépend toujours d’un domaine valide et d’un mécanisme de vérification fonctionnel. Les certificats locaux suivent un autre modèle de confiance.

Nginx possède également un module ACME officiel. Sa disponibilité et sa configuration dépendent de la version compilée ou du paquet installé. Affirmer que Nginx impose toujours un renouvellement manuel des certificats est dépassé. Comparez les composants que vous devrez exploiter, y compris le stockage des certificats et la surveillance de leur renouvellement.

Si une passerelle d’hébergement termine la connexion HTTPS avant de transmettre le trafic à l’application, examinez séparément ce trajet. Une URL publique en HTTPS ne prouve pas que la liaison entre la passerelle et le serveur applicatif est chiffrée, ni que vous pouvez obtenir un certificat pour n’importe quel domaine personnalisé. Aucune des configurations ci-dessous n’ajoute d’authentification à l’application.

Utiliser le même serveur applicatif pour comparer les comportements

Cet exercice local utilise Python 3.12.14, Caddy 2.11.9 et Nginx 1.31.8 sous Windows. Il vérifie le comportement HTTP sans demander de certificat ni ouvrir de point d’accès public. Utilisez un nouveau répertoire de travail et des ports libres. Téléchargez les exécutables depuis les sources d’installation officielles de Caddy et la page de téléchargement de Nginx.

Une petite application qui renvoie la requête reçue

Enregistrez ce code dans backend.py. Il décrit la requête reçue par l’application et prévoit deux chemins renvoyant volontairement une erreur. Il s’agit d’un serveur de diagnostic local, pas d’un serveur applicatif destiné à la production.

"""Local echo backend for the reverse-proxy comparison."""
import argparse
import json
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer

class Handler(BaseHTTPRequestHandler):
    def respond(self):
        length = int(self.headers.get("Content-Length", "0"))
        body = self.rfile.read(length).decode("utf-8")
        status = 503 if self.path == "/upstream-error" else 404 if self.path == "/missing" else 200
        payload = json.dumps({
            "method": self.command,
            "target": self.path,
            "body": body,
            "host": self.headers.get("Host"),
            "forwarded_for": self.headers.get("X-Forwarded-For"),
            "forwarded_proto": self.headers.get("X-Forwarded-Proto"),
        }).encode("utf-8")
        self.send_response(status)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(payload)))
        self.end_headers()
        self.wfile.write(payload)

    do_GET = respond
    do_POST = respond

    def log_message(self, *args):
        pass

if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    parser.add_argument("--port", type=int, default=19000)
    args = parser.parse_args()
    ThreadingHTTPServer(("127.0.0.1", args.port), Handler).serve_forever()

Exécutez python backend.py --port 19000 dans un premier terminal. Le serveur écoute uniquement sur 127.0.0.1.

Configuration de Caddy

Enregistrez ce fichier sous le nom Caddyfile. Le service HTTP accepte toute valeur Host, mais écoute uniquement sur l’interface de bouclage : l’exercice peut ainsi examiner l’en-tête Host fourni. HTTPS automatique est désactivé. Le point d’accès d’administration est lui aussi local.

{
    admin 127.0.0.1:12019
    auto_https off
}
http://:18080 {
    bind 127.0.0.1
    header X-Proxy-Revision one
    reverse_proxy 127.0.0.1:19000 {
        transport http {
            dial_timeout 2s
            response_header_timeout 2s
        }
    }
}

Dans un autre terminal ouvert sur ce répertoire, lancez caddy validate --config Caddyfile --adapter caddyfile, puis caddy run --config Caddyfile --adapter caddyfile. Utilisez le chemin complet de l’exécutable s’il n’est pas dans votre PATH. La référence reverse_proxy détaille les valeurs par défaut et les options de transmission.

Configuration de Nginx

Enregistrez ce fichier sous le nom nginx.conf dans le même répertoire, puis créez les sous-répertoires logs et temp. La version Windows de Nginx exige que le répertoire parent des fichiers temporaires existe. Le proxy écoute sur un autre port local, ce qui permet aux deux logiciels de partager le même serveur applicatif.

worker_processes 1;
error_log logs/error.log notice;
pid logs/nginx.pid;

events {
    worker_connections 128;
}

http {
    access_log off;
    server {
        listen 127.0.0.1:18081;
        server_name _;
        add_header X-Proxy-Revision one always;
        location / {
            proxy_pass http://127.0.0.1:19000;
            proxy_http_version 1.1;
            proxy_set_header Connection "";
            proxy_set_header Host $http_host;
            proxy_set_header X-Forwarded-For $remote_addr;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_connect_timeout 2s;
            proxy_read_timeout 2s;
        }
    }
}

Utilisez ce répertoire comme préfixe Nginx : nginx -p /absolute/path/to/working-directory/ -c nginx.conf -t vérifie la configuration ; la même commande sans -t démarre le serveur. Sous Windows, indiquez un chemin absolu avec des barres obliques, par exemple C:/proxy-demo/. Entourez de guillemets un chemin contenant des espaces.

Les deux exemples conservent le chemin demandé. Ici, proxy_pass ne contient pas d’URI après l’adresse du serveur applicatif. Ajouter une URI modifie le remplacement du chemin ; la référence du module proxy de Nginx explique cette distinction.

Examiner les réponses et les modes de défaillance

Envoyez les mêmes requêtes aux ports 18080 et 18081, avec Host: example.test. Demandez par exemple /api/items?q=a%20b&n=2, puis envoyez un POST JSON à /api/items. Examinez ce que reçoit l’application au lieu de vérifier uniquement le code HTTP 200.

VérificationRésultat observé localement
Chemin et paramètres encodésLes deux ont conservé /api/items?q=a%20b&n=2.
POST et corps UTF-8Les deux ont conservé la méthode et le corps JSON contenant café.
En-tête HostLes deux ont transmis example.test au serveur applicatif.
En-têtes de transmission fournisLes deux configurations ont remplacé l’adresse et le protocole falsifiés par 127.0.0.1 et http.
Erreur renvoyée par l’applicationLes deux ont conservé les réponses 404 et 503 volontaires.
Rechargement de configurationLe remplacement de one par two dans X-Proxy-Revision est apparu dans les réponses suivantes.
Arrêt du serveur applicatifCaddy a renvoyé 502. Nginx a renvoyé 504 ; son journal indiquait un délai de connexion dépassé.

Les 24 vérifications ont réussi, y compris l’acceptation des configurations et l’arrêt des services de test. Il s’agit d’observations fonctionnelles locales. Elles ne mesurent ni le débit, ni le trafic simultané, ni le renouvellement des certificats, ni un service Linux, ni un déploiement sur Hivenet. Nginx documente les limites de sa version Windows : cet exercice ne permet donc pas de désigner le logiciel le plus performant en production.

Le test des en-têtes suppose que l’appelant direct est le client. Derrière une passerelle de confiance, remplacer ces champs par l’adresse de la passerelle et son protocole HTTP interne peut supprimer une information nécessaire. Définissez les proxys intermédiaires auxquels vous faites confiance, puis configurez le proxy et l’application en conséquence. Les en-têtes de transmission fournis arbitrairement par un client ne doivent pas faire autorité.

Une réponse 503 produite par l’application et un serveur applicatif injoignable correspondent à des pannes différentes. Le second cas peut entraîner une erreur de passerelle ou un dépassement de délai, selon la connexion et les réglages. Examinez ensemble le statut, les journaux et la durée avant de modifier les nouvelles tentatives, surtout pour les requêtes qui changent des données.

Prévoir les rechargements, les limites et les vérifications en production

Pour Caddy, modifiez la configuration puis exécutez caddy reload --config Caddyfile --adapter caddyfile --address 127.0.0.1:12019. La référence de la CLI Caddy décrit aussi la validation et l’arrêt. Pour Nginx, reprenez les mêmes arguments de préfixe et de configuration, vérifiez avec -t, puis utilisez -s reload. Consultez la documentation de contrôle de la configuration Nginx.

Le test de rechargement a constaté la modification d’un en-tête de réponse. Il n’a pas vérifié la continuité de requêtes longues. Le streaming, les WebSockets, les téléversements, la mise en mémoire tampon, les limites de taille et les délais doivent être testés séparément avec le comportement réel de l’application. Les limites de deux secondes sont des paramètres de test, pas des valeurs recommandées pour la production.

Après l’exercice, arrêtez Caddy avec caddy stop --address 127.0.0.1:12019. Arrêtez cette instance Nginx avec les mêmes arguments de préfixe et de configuration, complétés par -s quit, puis interrompez le terminal Python avec Ctrl+C. Évitez une commande d’arrêt globale des processus sur une machine qui héberge d’autres proxys.

Avant le déploiement, définissez les noms d’hôte attendus, les contrôles d’accès, la conservation des journaux, les contrôles de santé, les mises à jour et la reprise après incident. Si le serveur applicatif passe dans un conteneur distinct, son adresse de bouclage change de sens. Le guide des réseaux Docker Compose, en anglais, explique quand utiliser les noms de services et les ports des conteneurs.

Choisir ensemble le proxy et le mode d’hébergement

Choisissez Caddy lorsque sa configuration et sa gestion intégrée des certificats réduisent le travail pour votre service. Conservez ou choisissez Nginx lorsque votre configuration existante, les modules nécessaires et l’expérience de l’équipe le justifient. Testez une migration avec les routes et les clients réels avant de retirer l’ancienne installation.

Un reverse proxy et une API web classique peuvent fonctionner sur une infrastructure CPU. Compute avec Hivenet, page en anglais, constitue une option pour les charges que vous exploitez vous-même. Consultez la documentation des vCPU, les accès nécessaires à l’instance et les options de connectivité actuelles avant de choisir une configuration.

Utilisez la redirection de ports SSH pour un accès privé lorsque cela convient au besoin. Vérifiez séparément le point d’accès public et le trajet TLS. Le choix du proxy ne détermine pas la capacité de la machine virtuelle et ne transforme pas une infrastructure en service applicatif géré. Une fois l’application fonctionnelle, mesurez-la sur l’instance prévue et intégrez le travail d’exploitation à votre budget.

Votre prochaine charge de travail sur Hivenet.

Choisissez une charge de travail d’IA, de calcul ou de stockage à tester sur Hivenet, ou échangez avec notre équipe sur sa mise en production.