Pourquoi votre serveur voit la mauvaise IP
Sans proxy, le navigateur d'un visiteur se connecte directement à votre serveur, et l'adresse de cette connexion — REMOTE_ADDR en PHP, $remote_addr dans nginx — est celle du visiteur. Placez un CDN, un répartiteur de charge ou n'importe quel reverse proxy devant, et la connexion que votre serveur accepte vient du proxy. Chaque ligne de journal, chaque limite de débit, chaque contrôle « connexion depuis un nouvel emplacement » voit désormais l'adresse du proxy.
L'adresse du visiteur n'est pas perdue. Le proxy l'a vue et l'écrit dans la requête qu'il transmet, dans un en-tête. Tout le sujet se résume à deux questions : quel en-tête lire, et quand le croire — car un en-tête n'est que du texte, et quiconque peut joindre directement votre serveur peut y écrire ce qu'il veut.
Comment X-Forwarded-For est construit
X-Forwarded-For (XFF) est une liste séparée par des virgules. Chaque proxy qui traite la requête prend la valeur existante et ajoute l'adresse dont il a reçu la requête. Un visiteur en 198.51.100.7 qui passe par un proxy arrive sur votre serveur ainsi :
X-Forwarded-For: 198.51.100.7
Avec deux proxys, le second ajoute l'adresse du premier :
X-Forwarded-For: 198.51.100.7, 203.0.113.20
Voici le point important pour la sécurité : un proxy ajoute ; il ne vérifie pas ce qui s'y trouvait déjà. Un visiteur peut envoyer son propre X-Forwarded-For: 1.2.3.4, et une fois que le CDN a ajouté la vraie adresse de connexion, votre serveur voit :
X-Forwarded-For: 1.2.3.4, 198.51.100.7
La valeur la plus à gauche est ce que le visiteur a tapé. La valeur à laquelle vous pouvez croire est celle ajoutée par le proxy de confiance — la plus à droite ou, avec plusieurs proxys de confiance à la suite, la première valeur en partant de la droite qui n'est pas l'un de vos propres proxys. Un code qui prend la première valeur de XFF pour « l'IP du client » peut être trompé par n'importe qui disposant de curl.
X-Real-IP et les en-têtes de cdn.com.tr
X-Forwarded-For porte un historique ; souvent, vous voulez simplement une réponse. Les en-têtes à valeur unique existent pour cela.
X-Real-IP est défini par de nombreux proxys basés sur nginx avec l'adresse de la connexion qu'ils ont acceptée. Notre périphérie le définit à chaque requête.
X-CDN-Client-IP est l'adresse du visiteur telle que notre périphérie l'a vue : une valeur unique, IPv4 ou IPv6, écrite par la périphérie à chaque requête. Un en-tête du même nom envoyé par le visiteur est remplacé, pas transmis. C'est l'en-tête le plus simple à lire.
X-CDN-Client-Port est le port source du visiteur. Là où de nombreux utilisateurs partagent une même adresse publique — réseaux mobiles, CGNAT —, l'adresse seule n'identifie pas un visiteur ; adresse plus port, si, et c'est ce qu'il vous faut quand une ligne de journal doit désigner une seule connexion.
X-CDN-Edge-IP est l'adresse du serveur de périphérie auquel le visiteur s'est connecté, utile pour rapprocher vos journaux des nôtres ou noter où une connexion a été établie.
Ces en-têtes sont standard sur chaque requête ; il n'y a rien à activer. La périphérie envoie aussi X-Forwarded-For avec l'adresse de connexion ajoutée, ainsi que X-Forwarded-Proto, X-Forwarded-Host et X-Forwarded-Port pour le schéma, le nom d'hôte et le port utilisés par le visiteur.
Ne faites confiance à l'en-tête que s'il vient de votre CDN
Un en-tête écrit par la périphérie n'est digne de confiance que si la requête est réellement passée par la périphérie. Si votre origine répond à n'importe qui sur internet, un attaquant peut s'y connecter directement et envoyer X-CDN-Client-IP: 127.0.0.1 ou l'adresse de son choix. Deux mesures comblent cette brèche, et elles fonctionnent mieux ensemble.
Dites à votre serveur web quelles adresses sont des proxys. nginx, Apache et la plupart des frameworks ne restituent l'adresse du client que pour les requêtes qui viennent d'adresses que vous déclarez de confiance ; venant de n'importe qui d'autre, les en-têtes sont ignorés. Listez les adresses de périphérie de votre compte — nous vous communiquons les adresses actuelles sur demande.
Verrouillez l'origine au CDN. Exigez un en-tête secret dont vous choisissez le nom et la valeur et que vous ajoutez à chaque règle de diffusion, ou exigez le certificat client de la périphérie avec mTLS. Une requête directe n'atteint alors jamais votre application, et les en-têtes transmis sur les requêtes qui arrivent sont ceux de la périphérie.
Faites de l'en-tête secret ou du certificat le verrou principal, et de la liste d'adresses le second : ils continuent de fonctionner quelles que soient les évolutions des adresses de périphérie, alors qu'une liste doit être tenue à jour.
nginx : set_real_ip_from et real_ip_header
Le module realip de nginx remplace $remote_addr par l'adresse issue d'un en-tête — mais seulement quand la connexion vient d'une adresse listée dans set_real_ip_from. Ensuite, votre journal d'accès, les règles allow et deny et limit_req voient tous le visiteur.
Avec X-CDN-Client-IP, il n'y a aucune liste à analyser. Si vous préférez X-Forwarded-For — par exemple parce qu'un répartiteur de charge à vous se trouve entre le CDN et nginx —, utilisez real_ip_header X-Forwarded-For; avec real_ip_recursive on;, et listez à la fois les adresses de périphérie et votre répartiteur de charge dans set_real_ip_from. nginx parcourt alors la liste en partant de la droite, saute chaque adresse de confiance et s'arrête à la première qui n'en est pas une : le visiteur.
Conservez aussi dans le journal l'adresse de connexion d'origine ($realip_remote_addr). Quand vous devez savoir quel serveur de périphérie a livré une requête, elle est là.
nginx : restituer l'adresse du visiteur depuis le CDN
# in http {} or server {}
# the edge addresses for your account (placeholders)
set_real_ip_from 203.0.113.0/24;
set_real_ip_from 2001:db8:100::/48;
real_ip_header X-CDN-Client-IP;
log_format cdn '$remote_addr:$http_x_cdn_client_port via $realip_remote_addr '
'[$time_local] "$request" $status $body_bytes_sent';
access_log /var/log/nginx/access.log cdn;
Apache : mod_remoteip
Le mod_remoteip d'Apache fait le même travail. Activez-le (a2enmod remoteip sur Debian et Ubuntu), nommez l'en-tête et listez les proxys de confiance. Utilisez RemoteIPTrustedProxy pour les adresses publiques ; RemoteIPInternalProxy est destiné aux plages privées.
Utilisez %a dans le format de journal : avec mod_remoteip configuré, c'est l'adresse restituée du visiteur. Les règles d'accès comme Require ip voient elles aussi l'adresse du visiteur une fois le module en place.
Apache 2.4 avec mod_remoteip
RemoteIPHeader X-CDN-Client-IP
# the edge addresses for your account (placeholders)
RemoteIPTrustedProxy 203.0.113.0/24
RemoteIPTrustedProxy 2001:db8:100::/48
LogFormat "%a %{X-CDN-Client-Port}i %l %u %t \"%r\" %>s %b" cdn
CustomLog ${APACHE_LOG_DIR}/access.log cdn
Laravel et autres frameworks : proxys de confiance
Les frameworks lisent X-Forwarded-For eux-mêmes, avec la même règle : les en-têtes transmis ne comptent que s'ils viennent de proxys de confiance. Dans Laravel 11 et versions ultérieures, vous les déclarez dans bootstrap/app.php ; $request->ip() renvoie alors le visiteur, et $request->secure() ainsi que les URL générées suivent X-Forwarded-Proto.
Laravel, via Symfony, lit X-Forwarded-For depuis la droite et saute les adresses de confiance — exactement la règle de la valeur la plus à droite de confiance. Ne faites pas confiance à * sur une origine que l'internet peut joindre directement ; cela dit au framework de croire les en-têtes de n'importe quel client. Express (app.set('trust proxy', ...)) et Rails (config.action_dispatch.trusted_proxies) suivent la même idée sous d'autres noms.
bootstrap/app.php (Laravel 11+)
use Illuminate\Foundation\Configuration\Middleware;
use Illuminate\Http\Request;
->withMiddleware(function (Middleware $middleware) {
$middleware->trustProxies(
at: ['203.0.113.0/24', '2001:db8:100::/48'], // edge addresses (placeholders)
headers: Request::HEADER_X_FORWARDED_FOR
| Request::HEADER_X_FORWARDED_HOST
| Request::HEADER_X_FORWARDED_PORT
| Request::HEADER_X_FORWARDED_PROTO,
);
})
// anywhere in the application
$ip = $request->ip(); // the visitor
$port = $request->header('X-CDN-Client-Port'); // the visitor's source port
Vérifier que cela fonctionne
Trois tests rapides confirment la configuration.
Via le CDN. Demandez une page et regardez votre journal d'accès : l'adresse doit être votre propre adresse publique, pas une adresse de périphérie.
Falsifiez-la. Envoyez curl -H 'X-Forwarded-For: 1.2.3.4' -H 'X-CDN-Client-IP: 1.2.3.4' https://www.example.com/. Le journal doit toujours afficher votre vraie adresse : la périphérie remplace X-CDN-Client-IP et ajoute votre adresse après la valeur XFF que vous avez envoyée.
Contournez le CDN. Envoyez la même requête directement à l'origine avec --resolve. Si l'origine est verrouillée, la requête est refusée ; sinon, le journal doit afficher votre vraie adresse plutôt que 1.2.3.4, car votre adresse n'est pas dans la liste de confiance. S'il affiche 1.2.3.4, la liste de confiance est trop large.
Où l'IP réelle compte
Les journaux d'accès, l'analytique et les signalements d'abus comptent vos visiteurs, pas les serveurs de périphérie placés devant eux.
Les limites par IP et les blocages façon fail2ban visent l'auteur de l'abus plutôt que tous ceux qui vous atteignent par la même périphérie.
Adresse, port source, heure et adresse de périphérie désignent ensemble une seule connexion, même derrière des adresses mobiles partagées.
Comment le mettre en place
Guides pas à pas dans le centre d'aide :
FAQ X-Forwarded-For
Quelle valeur de X-Forwarded-For est l'IP du client ?
La valeur la plus à droite ajoutée par un proxy de confiance. Les valeurs à sa gauche étaient déjà dans l'en-tête quand la requête a atteint ce proxy : le visiteur a pu les écrire. Avec un seul CDN devant votre serveur, c'est simplement la dernière valeur.
Que devient un en-tête X-Forwarded-For envoyé par le visiteur ?
La périphérie le conserve et y ajoute l'adresse dont elle a reçu la requête, comme le font les proxys. C'est pourquoi vous lisez la valeur la plus à droite — ou X-CDN-Client-IP, une valeur unique que la périphérie écrit elle-même et qu'un visiteur ne peut pas définir.
Quelle est la différence entre X-Forwarded-For et X-Real-IP ?
X-Forwarded-For est une liste à laquelle chaque proxy ajoute une valeur : elle enregistre donc tout le chemin. X-Real-IP est une adresse unique définie par un seul proxy. Ce sont deux conventions ; l'en-tête standard Forwarded (RFC 7239) porte la même information avec une syntaxe plus stricte.
Pourquoi aurais-je besoin de X-CDN-Client-Port ?
Parce que de nombreux visiteurs peuvent partager une même adresse IP publique sur les réseaux mobiles et derrière du CGNAT. Le port source, avec l'adresse et l'heure, distingue ces visiteurs, ce qu'il vous faut quand une ligne de journal doit désigner une seule connexion.
Puis-je faire confiance à X-CDN-Client-IP venant de n'importe quelle adresse ?
Seulement si votre origine n'accepte aucun trafic autre que celui du CDN, verrouillée par un en-tête secret ou mTLS. Si l'origine peut être jointe directement, n'importe qui peut envoyer cet en-tête : limitez-le donc aussi aux adresses de la périphérie.
Où obtenir les adresses de périphérie à approuver ?
Nous vous communiquons sur demande les adresses actuelles des serveurs de périphérie liés à votre compte. Verrouillez aussi l'origine avec un en-tête secret ou mTLS, pour que votre protection ne dépende pas de la tenue à jour d'une liste.