Guide · VPS & hosting

Cloudflare Pages ou Workers : déployer un site en 2026

Déployez un site statique avec Cloudflare Pages ou Workers, reliez votre domaine et vérifiez les quotas gratuits avant la mise en ligne.

Des pages statiques et des fonctions reliées à un réseau de diffusion.

Cloudflare Pages et Workers Static Assets peuvent tous deux publier les fichiers d’un site sur le réseau Cloudflare, mais ils ne désignent pas le même produit. Pages organise un projet de site, son intégration Git, ses builds et ses déploiements. Workers est l’environnement serverless ; Static Assets y ajoute les fichiers du site, avec ou sans script Worker. Pages reste la voie la plus lisible pour relier un dépôt Git ou envoyer un dossier déjà compilé. Workers Static Assets convient si le site doit partager son déploiement avec du code serveur, des routes d’API ou un routage plus explicite.[1][6]

En bref. Prévoyez le temps du build, de l’envoi et des contrôles DNS ; aucune durée n’a été mesurée pour cet article. Pages accepte un dépôt Git, un envoi avec Wrangler ou un glisser-déposer. Workers Static Assets peut déployer les seuls fichiers statiques ou les associer à un script dans une même version. Les requêtes qui servent directement ces actifs sont gratuites et illimitées ; seules celles qui invoquent le script consomment le quota de requêtes Workers. Les limites de nombre et de taille de fichiers continuent toutefois de s’appliquer. Ces conditions ont été vérifiées le 4 novembre 2026.[2][3][7][8]

Prérequis

Avant de créer le projet Cloudflare, préparez :

  • un compte Cloudflare ;
  • un site qui génère des fichiers HTML, CSS, JavaScript et images dans un dossier de sortie ;
  • Node.js et npm si vous choisissez Wrangler ;
  • un dépôt GitHub ou GitLab si vous voulez déclencher les déploiements après chaque envoi de code ;
  • l’accès DNS au domaine si vous voulez remplacer l’adresse pages.dev ou workers.dev ;
  • la commande de build et le nom exact du dossier produit, par exemple dist, build ou out selon votre outil.

Le tutoriel suppose que le site compile déjà. Il ne traite ni une base de données, ni une application qui exige un serveur Node.js permanent. Si vous hésitez encore entre plateforme gérée et serveur, commencez par comparer l’hébergement gratuit et payant. Pour voir le même travail de préparation sur une autre plateforme gérée, consultez le guide publier un site Next.js sur Vercel.

Les commandes ci-dessous viennent de la documentation Cloudflare consultée le 4 novembre 2026. Elles sont fournies comme commandes documentées à adapter. Aucune n’a été exécutée dans le cadre de cet article, et aucune sortie de terminal n’est présentée comme un résultat obtenu.

Pages, Workers et actifs statiques : ne pas mélanger les rôles

Cloudflare Pages est un produit de déploiement de sites. Il peut connecter GitHub ou GitLab, lancer le build puis publier le dossier de sortie. Il peut aussi recevoir des fichiers déjà construits par Direct Upload. Pages Functions ajoute du code côté serveur, mais ses requêtes comptent dans les quotas des plans Workers.[1][2][4]

Cloudflare Workers est l’environnement d’exécution serverless. Static Assets est sa fonction de publication de fichiers HTML, CSS, images et JavaScript ; un déploiement composé uniquement d’actifs est possible, sans script. Lorsqu’un script est présent, un fichier correspondant à l’URL est servi par défaut sans l’invoquer. Si aucun fichier ne correspond, la requête passe au script ; sans script, Cloudflare renvoie une erreur 404.[6]

Cette différence change la facturation et le diagnostic. Sur Workers, Cloudflare indique que les requêtes qui servent directement un actif statique sont gratuites et illimitées, et que le stockage de ces actifs n’ajoute pas de coût. Cela ne supprime pas les limites de déploiement : le nombre de fichiers et la taille de chacun restent plafonnés par version. Une route qui exécute le script, par exemple pour du rendu serveur, relève en revanche de la tarification et des limites d’exécution Workers. Cette distinction commerciale a été vérifiée le 4 novembre 2026.[7][8]

BesoinPoint de départ conseilléPourquoi
Site statique relié à GitHub ou GitLabPages avec intégration GitLe build et le déploiement suivent les changements du dépôt
Dossier déjà compilé par votre propre CIPages Direct UploadPages reçoit directement les fichiers produits
Petit site envoyé sans ligne de commandePages par glisser-déposerLe tableau de bord accepte un dossier ou une archive
Site statique avec routes d’API dans la même unitéWorkers avec Static AssetsWrangler déploie les actifs et le script ensemble
Middleware avant certains fichiersWorkers avec run_worker_first cibléLe script peut intercepter les chemins choisis

Le tableau n’est pas un classement. Pour un site purement statique, Pages évite une configuration Workers inutile. Pour du code exécuté à la requête, l’article Workers, Functions et Lambda détaille les limites CPU, la mémoire et l’état entre deux appels.

Étape 1 : construire le site et repérer le dossier de sortie

Lancez la commande de build définie par votre framework ou votre générateur de site. Elle peut être npm run build, mais le bon choix est celui du projet. Consultez son fichier package.json et sa documentation plutôt que de reprendre une commande au hasard.

Après le build, ouvrez le dossier produit. Il doit contenir les fichiers destinés au navigateur, avec un index.html pour un site statique classique. Ne désignez pas la racine du dépôt si elle contient le code source, les secrets locaux ou node_modules.

Ce que vous devez voir : un dossier de sortie autonome, dont les chemins d’images et de feuilles de style fonctionnent lorsque le site est servi. Notez son nom. Les étapes suivantes utilisent <DOSSIER_DE_SORTIE> comme emplacement fictif.

Étape 2 : choisir le mode de déploiement Pages

L’intégration Git est adaptée quand Cloudflare doit construire le site après chaque changement envoyé au dépôt. Direct Upload est préférable si le build tourne déjà ailleurs, par exemple dans votre propre CI, ou si vous envoyez les fichiers depuis votre poste.[2][3]

Ce choix n’est pas interchangeable après coup. La documentation Direct Upload précise qu’un projet créé ainsi ne peut pas ensuite passer à l’intégration Git. Un projet lié à Git peut recevoir certains déploiements manuels, mais le glisser-déposer du tableau de bord n’est pas disponible pour ce projet.[3]

Décidez aussi quelle branche représente la production. Avec l’intégration Git, les autres branches servent aux déploiements de prévisualisation. Avec Direct Upload, la branche de production est enregistrée lors de la création du projet avec Wrangler.

Étape 3 : déployer Pages depuis Git

Dans le tableau de bord Cloudflare, ouvrez Workers & Pages, puis créez une application Pages et choisissez Connect to Git. Autorisez uniquement le compte ou l’organisation nécessaire, puis sélectionnez le dépôt GitHub ou GitLab. Les dépôts publics et privés sont pris en charge.[2]

Renseignez ensuite :

  1. le nom du projet, qui sert à former l’adresse pages.dev ;
  2. la branche de production ;
  3. la commande de build ;
  4. le dossier de sortie ;
  5. le sous-dossier racine si le site vit dans un monorepo ;
  6. les variables nécessaires au build, sans placer de secret dans le dépôt.

Si le site n’a aucune étape de compilation, Cloudflare demande de laisser le champ de commande vide. Le dossier de sortie reste obligatoire puisqu’il désigne le contenu à publier.[2]

Lancez Save and Deploy. Ce que vous devez voir : les journaux d’installation, de build et de déploiement, puis une URL unique. Une erreur à cette étape vient souvent d’une version de Node différente, d’une commande exécutée depuis le mauvais sous-dossier ou d’un dossier de sortie mal nommé.

Étape 4 : déployer Pages avec Wrangler

Direct Upload envoie un dossier déjà compilé. La documentation commence par l’authentification Wrangler, puis la création du projet. Commandes documentées, non exécutées pour cet article :[3]

npx wrangler login
npx wrangler pages project create

Wrangler demande le nom du projet et la branche de production. Le déploiement du dossier construit utilise ensuite :

npx wrangler pages deploy <DOSSIER_DE_SORTIE>

Pour une prévisualisation associée à une branche, la commande documentée est :

npx wrangler pages deploy <DOSSIER_DE_SORTIE> --branch=<NOM_DE_BRANCHE>

Ce que vous devez voir d’après la documentation : une adresse de production sous <PROJET>.pages.dev. Chaque branche de prévisualisation reçoit aussi un alias de la forme <BRANCHE>.<PROJET>.pages.dev.[3]

Le glisser-déposer est une solution distincte dans le tableau de bord. Au 4 novembre 2026, Cloudflare documente une limite de 1 000 fichiers pour cette méthode, contre 20 000 avec Wrangler. La taille maximale d’un fichier est de 25 Mio dans les deux cas. Le glisser-déposer ne compile pas un dossier functions; il faut Wrangler pour l’envoyer.[3]

Étape 5 : déployer avec Workers Static Assets

Choisissez cette voie si le projet a besoin d’un Worker ou si vous voulez gérer explicitement le comportement des routes. La configuration Wrangler doit désigner le dossier à publier dans assets.directory.[6][9]

Pour un projet composé uniquement d’actifs, la configuration minimale conserve notamment le nom, une compatibility_date et assets.directory ; le champ main n’est nécessaire que si un script Worker doit être exécuté. La commande de déploiement Workers ci-dessous est documentée mais non exécutée pour cet article :[6][9]

npx wrangler deploy

Pour travailler localement avec la configuration Workers, Cloudflare documente la commande suivante, elle aussi non exécutée ici :

npx wrangler dev

Ces commandes ne sont pas les commandes Pages. La documentation de migration associe wrangler pages dev et wrangler pages deploy à Pages, puis wrangler dev et wrangler deploy à Workers.[9][10]

Le routage mérite une vérification avant publication. Par défaut, Workers sert d’abord le fichier statique correspondant. not_found_handling peut déclarer une application monopage ou une page 404. L’option run_worker_first force le passage par le script pour toutes les requêtes ou pour des motifs précis.[6]

Cette dernière option a un coût pratique. Sur le plan gratuit, une requête qui passe par le script consomme le quota Workers. Si ce quota est dépassé, Cloudflare indique qu’une route run_worker_first concernée peut répondre avec un statut 429 au lieu de revenir automatiquement au fichier statique. Vérifié le 4 novembre 2026.[7]

Résultat attendu d’après la documentation, et non observé dans le cadre de cet article : le Worker et ses actifs apparaissent comme une même version. Vérifiez une page HTML, une feuille de style, une image, une URL inexistante et, si le script en a une, une route d’API.

Étape 6 : relier un domaine personnalisé

Pour Pages, ajoutez le domaine dans Workers & Pages, ouvrez le projet, puis Custom domains. Un domaine racine comme example.com doit être une zone du même compte Cloudflare avec ses serveurs de noms configurés chez Cloudflare. Un sous-domaine peut rester chez un autre fournisseur DNS et pointer par CNAME vers l’adresse <PROJET>.pages.dev.[5]

Ajoutez le domaine depuis le projet avant de créer manuellement un simple CNAME. Cloudflare avertit qu’un CNAME isolé, sans association dans Pages, peut échouer avec une erreur 522.[5]

Pour Workers, un Custom Domain exige une zone Cloudflare active et pointe directement vers le Worker ; une route Workers sert plutôt à intercepter un domaine ou certains chemins d’une zone. Ne copiez pas une cible pages.dev vers un Worker. Si vous migrez un site Pages, gardez l’ancien projet jusqu’à ce que le domaine, les redirections et les pages d’erreur aient été vérifiés sur Workers.[9][11]

Après le rattachement, contrôlez :

  • l’ouverture en HTTPS ;
  • la variante avec et sans www ;
  • une page interne ;
  • une URL inexistante ;
  • les redirections ;
  • les en-têtes de sécurité attendus.

Si vous administrez plutôt un serveur d’origine, le guide configurer HTTPS sur un VPS couvre le DNS, le proxy et les certificats. Sur Pages, le certificat dépend aussi des enregistrements CAA : une politique CAA trop restrictive peut empêcher Cloudflare d’émettre le certificat.[5]

Étape 7 : vérifier les quotas avant de considérer le site prêt

La page de limites du plan gratuit Pages, vérifiée le 4 novembre 2026, documente 500 builds par mois, un seul build simultané et une durée maximale de 20 minutes par build. Ces nombres décrivent la chaîne de build Pages, pas les requêtes HTTP servies par le site ni le quota d’exécution d’une Pages Function. Un site Pages gratuit peut contenir jusqu’à 20 000 fichiers, chaque actif étant limité à 25 Mio. Cloudflare documente aussi 100 projets Pages par compte et 100 domaines personnalisés par projet sur le plan gratuit.[4]

Documentation Cloudflare Pages « Limits », mise à jour le 5 septembre 2026 : 500 builds par mois et un build à la fois en Free, 100 domaines personnalisés par projet.
Cloudflare, developers.cloudflare.com, capture du 13 novembre 2026

Workers Free documente 100 000 requêtes qui invoquent un script par jour, avec remise à zéro à minuit UTC, 10 ms de CPU par requête HTTP, 128 Mo de mémoire par isolat et 100 Workers par compte. Ce quota de 100 000 n’inclut pas les requêtes servies directement par Static Assets. Pour les actifs, la limite distincte est de 20 000 fichiers par version et 25 Mio par fichier. Les offres payantes ont d’autres plafonds, notamment 100 000 actifs statiques par version, mais cet article ne fige aucun tarif.[7][8]

Un fichier vidéo de plus de 25 Mio ne peut donc pas être publié comme un actif Pages ou Workers Static Assets. La page de limites Pages renvoie vers R2 pour les fichiers plus lourds. Workers Static Assets a aussi une limite fonctionnelle sur les requêtes par plage : la documentation indique que le service répond avec le fichier complet et un statut 200 au lieu d’un 206 partiel. Ce point compte pour certains lecteurs vidéo.[4][7][8]

Consignez les limites pertinentes dans le projet. Un déploiement réussi ne prouve pas que le prochain build restera sous 20 minutes, ni que les routes dynamiques resteront dans le quota Workers.

Erreurs fréquentes

Le build réussit, mais Pages publie une page vide

Le dossier de sortie est souvent incorrect. Comparez sa valeur dans Pages avec le dossier réellement créé après le build. Dans un monorepo, vérifiez aussi le répertoire racine depuis lequel Cloudflare installe les dépendances.

Les fichiers statiques fonctionnent, mais l’API répond 404

Sur Pages par glisser-déposer, un dossier functions n’est pas compilé. Utilisez Wrangler pour ce projet. Sur Workers, vérifiez le champ main, puis le comportement de assets.directory et de run_worker_first.[3][6]

Une application monopage renvoie 404 après actualisation

Workers Static Assets demande un comportement explicite pour les URL sans fichier correspondant. Vérifiez not_found_handling et choisissez le mode application monopage seulement si le routeur côté navigateur doit reprendre ces URL.[6][9]

Le domaine reste en attente

Vérifiez d’abord que le domaine a été ajouté au projet Pages, puis contrôlez le CNAME ou les serveurs de noms. Examinez les enregistrements CAA si l’émission du certificat bloque. Évitez de déplacer puis de remettre plusieurs fois le DNS pendant l’activation.[5]

Le site statique reçoit des erreurs 429

Déterminez si la requête sert réellement un fichier ou exécute le Worker. Une règle run_worker_first trop large peut transformer des accès statiques en invocations de script et consommer le quota gratuit.[7]

Récapitulatif

Utilisez Pages avec Git pour confier le build et les prévisualisations de branches à Cloudflare. Prenez Direct Upload si votre chaîne produit déjà le dossier final. Choisissez Workers Static Assets lorsque des fichiers statiques et du code Worker doivent être versionnés et déployés ensemble.

Gardez quatre preuves avant l’annonce : l’URL de production répond, le domaine personnalisé sert le bon projet, une URL inexistante suit le comportement prévu et les limites du plan couvrent le trafic dynamique. Les fichiers statiques et les invocations Workers n’ont pas le même régime, même s’ils partagent le même déploiement.

Questions fréquentes

Cloudflare Pages est-il gratuit en 2026 ?

Pages est disponible sur tous les plans. Le plan gratuit documente notamment 500 builds mensuels, 20 000 fichiers par site et une taille maximale de 25 Mio par actif, chiffres vérifiés le 4 novembre 2026. Une Pages Function consomme toutefois les quotas Workers.[1][4]

Faut-il choisir Pages ou Workers pour un site statique ?

Pages est le choix le plus simple pour un dépôt Git ou un dossier précompilé. Workers Static Assets devient pertinent si vous ajoutez un script, une API ou des règles de routage explicites. Un site uniquement composé de fichiers n’a pas besoin d’un Worker exécuté à chaque requête.

Peut-on déployer Pages sans GitHub ?

Oui. Direct Upload accepte un dossier précompilé avec Wrangler ou par glisser-déposer. GitLab est aussi pris en charge par l’intégration Git.[2][3]

Les actifs statiques Workers consomment-ils le quota de requêtes ?

Cloudflare indique que les requêtes servies directement depuis Static Assets sont gratuites et sans limite. Si la requête invoque le script, elle suit la tarification et les quotas Workers. Vérifiez particulièrement run_worker_first.[7]

Peut-on passer plus tard de Direct Upload à l’intégration Git ?

La documentation Cloudflare indique qu’un projet Direct Upload ne peut pas être converti ensuite en projet avec intégration Git. Choisissez le mode avant de créer le projet, ou prévoyez un nouveau projet pour changer de chaîne.[3]

Sources