Loading...

Aide CDN.com.tr

Lire le statut de cache : HIT, MISS, BYPASS, EXPIRED

Utilisez l'en-tête de réponse X-Proxy-Cache-MT pour voir exactement ce que le CDN a fait d'une requête et vérifier que la mise en cache fonctionne comme prévu.

Lire le statut de cache : HIT, MISS, BYPASS, EXPIRED

Utilisez l'en-tête de réponse X-Proxy-Cache-MT pour voir exactement ce que le CDN a fait d'une requête et vérifier que la mise en cache fonctionne comme prévu.

Vidéo en anglais, sous-titrée en français.

Cas d'usage

Un client vérifie les en-têtes de réponse dans les DevTools du navigateur et veut savoir si le contenu est servi depuis le cache CDN, récupéré depuis l'origine, ou volontairement ignoré.

Workflow

  1. Ouvrez l'URL de la page ou de la ressource et inspectez les en-têtes de réponse (onglet Network des DevTools du navigateur ou curl -I).
  2. Trouver l'en-tête X-Proxy-Cache-MT.
  3. Faire correspondre la valeur avec le glossaire ci-dessous.
  4. Répéter la requête : une URL saine et cacheable renvoie MISS à la première requête, puis HIT.

Verifications

  • HIT — servi depuis le cache CDN sans contacter votre origine. C'est l'objectif pour le contenu statique et anonyme.
  • MISS — pas encore en cache ; récupéré depuis l'origine et stocké. La prochaine requête identique devrait être un HIT.
  • EXPIRED — était en cache mais le TTL est dépassé ; récupéré à nouveau depuis l'origine.
  • BYPASS — une règle de contournement a correspondu à cette requête, donc le CDN est volontairement allé à l'origine. La raison la plus courante : vous êtes connecté à un panneau ou un CMS, et un cookie de session/connexion désactive la mise en cache pour vous. Les visiteurs sans ce cookie obtiennent toujours HIT. Les requêtes qui portent un en-tête Authorization (jeton Bearer, Basic auth) affichent aussi toujours BYPASS.

Questions frequentes

Je vois toujours BYPASS dans mon navigateur mais la mise en cache est censée être activée — pourquoi ?

BYPASS signifie que la requête a volontairement contourné le cache. Trois raisons sont possibles : la requête correspond à une règle avec Ne pas mettre ce chemin en cache sélectionné ; la requête porte un cookie de la liste Ignorer le cache en présence de ces cookies de la règle (sur les comptes d'hébergement WordPress, les cookies de connexion y figurent par défaut) ; ou la requête porte un en-tête Authorization. Votre navigateur connecté peut envoyer ces cookies, donc testez en fenêtre privée ou avec curl -I https://yourdomain.com/path : une réponse pouvant être mise en cache affiche d'abord MISS, puis HIT.

Le CDN respecte-t-il l'en-tête Cache-Control de mon origine ?

Cela dépend de la règle. Sur une règle avec Suivre les en-têtes de cache de votre origine sélectionné (valeur par défaut des nouveaux comptes), l'en-tête Cache-Control ou Expires de votre origine détermine combien de temps l'edge conserve la réponse ; si aucun des deux n'est présent, la réponse est conservée 30 jours au maximum. Sur une règle avec Mettre en cache pour une durée fixe sélectionné, les en-têtes Cache-Control et Expires de votre origine sont ignorés, et l'edge comme les navigateurs conservent la réponse pendant la durée que vous avez choisie. Deux pièges : une réponse qui envoie Set-Cookie n'est pas mise en cache par défaut ; et si Image Optimization est activée sur le compte ou sur la règle, les images optimisées sont conservées 365 jours quoi que dise l'origine.

Mobile et bureau semblent être mis en cache séparément — est-ce normal ?

Non. La clé de cache ne contient aucun composant d'appareil — mobile et bureau partagent une seule entrée, purger un chemin l'efface donc pour les deux.

Comment forcer du contenu à jour pour tout le monde ?

Purgez le chemin depuis Purge Management. Une actualisation forcée dans votre propre navigateur n'affecte que votre cache navigateur, pas le cache CDN.

Les requêtes avec un en-tête Authorization sont-elles mises en cache ?

Non. Les requêtes qui portent un en-tête Authorization (jeton Bearer, Basic auth) ne sont jamais servies depuis le cache du CDN ni enregistrées dans celui-ci ; elles vont toujours à votre serveur d'origine et affichent BYPASS.

Les requêtes avec un cookie de session contournent-elles le cache ?

Pas par défaut : les cookies d'analyse et de consentement sont présents dans presque chaque requête, donc l'edge ne regarde pas les cookies. Pour les pages derrière une connexion, écrivez le nom de votre cookie de session dans le champ Ignorer le cache en présence de ces cookies de la règle (un nom par ligne ; le nom est recherché dans l'en-tête Cookie sans distinction de casse), ou envoyez Cache-Control: private, no-store avec ces réponses. Les réponses contenant Set-Cookie ne sont pas mises en cache par défaut. Sur les comptes d'hébergement WordPress, les cookies wordpress_logged_in, wp-postpass et woocommerce_items_in_cart figurent sur cette liste par défaut.

Puis-je écrire une règle permanente pour que mes chemins d'API ne soient jamais mis en cache ?

Oui. Dans l'onglet Règles de Domaines et règles, ajoutez une règle, choisissez Commence par pour le chemin, saisissez /api/ et choisissez Ne pas mettre ce chemin en cache. N'ajoutez pas d'astérisque ; * n'est pas un joker ici. Chaque requête sur ce chemin va vers votre origine, et la règle reste valable jusqu'à ce que vous la modifiiez. Les règles Le type de fichier est s'appliquent sur tous les chemins et sont testées avant la règle /api/ ; si l'une de vos adresses d'API se termine par une extension telle que .png, ajustez vos règles en conséquence. Les requêtes avec un en-tête Authorization ne sont jamais mises en cache, dans tous les cas.

Pages associees

La page Événements de sécurité : WAF, blocage d'IP et de pays, hotlink, rate limit

Tous les contrôles de sécurité au niveau du compte sont réunis sur une seule page, Événements de sécurité : l'interrupteur WAF pour tout le site, la protection anti-bots JS Challenge, le blocage d'IP et de pays, la protection hotlink, la limitation de débit des requêtes et l'expiration des liens. Chaque enregistrement se déploie automatiquement sur les edges — pas d'étape de publication séparée.

Écrire une règle pour un domaine et un chemin

Dans l'onglet Règles de Domaines et règles, une règle sélectionne les requêtes par domaine, protocole et chemin, puis décide comment elles sont mises en cache, quels en-têtes sont ajoutés ou supprimés, d'où elles sont récupérées et qui peut y accéder.

Lire les journaux WAF

Utilisez les journaux WAF pour expliquer un trafic bloqué ou mis au défi sans exposer les systèmes de journalisation internes.

Activer HSTS pour vos noms d'hôte

L'interrupteur Toujours utiliser HTTPS (HSTS) fait envoyer par l'edge l'en-tête Strict-Transport-Security: max-age=31536000 sur les réponses HTTPS : un navigateur qui a déjà vu votre site refuse alors de l'ouvrir en HTTP simple pendant un an.

Bloquer le trafic par ASN et par pays

Deux listes noires à l'échelle du compte dans le même panneau : bloquer des pays entiers par code pays, ou bloquer des réseaux entiers par numéro de système autonome. Un visiteur bloqué reçoit la page 403 de marque avec un identifiant de référence.

URLs signées : liens qui expirent

Protégez un fichier pour qu'il ne puisse être récupéré qu'avec une signature que vous générez, valable jusqu'à un moment que vous choisissez. Les requêtes non signées reçoivent 403, celles qui ont expiré reçoivent 410.

Optimisation des images : AVIF et WebP sur l'edge

Activez l'optimisation des images pour le compte ou pour une règle de diffusion et choisissez WebP ou WebP + AVIF : l'edge convertit les images JPEG et PNG et envoie à chaque navigateur un format qu'il accepte, et vos pages gardent les mêmes URL d'images.

Rediriger un domaine vers un autre domaine (301)

Envoyez les requêtes d'un domaine vers un autre domaine par une redirection permanente (301) depuis l'onglet Redirections de Domaines et règles. Le chemin et la chaîne de requête sont conservés, et les vérifications de certificat Auto SSL sous /.well-known continuent de fonctionner.

Compression Brotli et gzip

L'edge compresse automatiquement les réponses texte : Brotli pour les navigateurs qui le prennent en charge, gzip pour les autres. Voyez quelle méthode utilise chaque domaine dans la carte Compression des réponses et confirmez-le avec curl.

HTTP/3 (QUIC) : le désactiver pour un nom d'hôte

HTTP/3 est activé par défaut sur chaque nom d'hôte HTTPS. Désactivez-le pour un nom d'hôte dans ses détails, dans l'onglet Domaines de Domaines et règles, lorsque ses visiteurs, ou un réseau qu'ils utilisent, rencontrent des problèmes avec QUIC ; ces visiteurs passent alors par HTTP/2.

En-têtes CORS sur l'edge

Ajoutez Access-Control-Allow-Origin et les autres en-têtes CORS aux réponses d'une règle de diffusion, laissez votre origine répondre aux requêtes OPTIONS de preflight, et autorisez dans le WAF les méthodes qu'utilise votre API.