Nick & Tech

Web & infrastructure · Intermédiaire

Cloudflare Workers : déployer un site sans serveur, le guide pas à pas

Réponse rapide : Cloudflare Workers permet d'héberger un site ou une application sans gérer le moindre serveur : ton code et tes fichiers sont distribués sur le réseau mondial de Cloudflare et exécutés à la demande. Pour déployer, tu crées un projet avec npm create cloudflare@latest, tu ajoutes tes fichiers dans un dossier « assets », puis tu lances npx wrangler deploy. En quelques minutes, ton site est en ligne, avec un tier gratuit généreux et un plan payant à partir de 5 $/mois si tu dépasses les quotas.

Tu as un site à mettre en ligne, mais l'idée de louer un VPS, de le sécuriser et de surveiller qu'il ne tombe pas en panne te fatigue d'avance. Tu as entendu parler de « serverless » et de Cloudflare Workers, mais entre les termes techniques et les changements réguliers de la plateforme, tu ne sais pas par où commencer.

Dans ce guide, on reprend tout depuis le début : ce qu'est Cloudflare Workers, comment ça fonctionne concrètement, combien ça coûte en septembre 2026, et surtout comment déployer ton premier site étape par étape. On met les mains dedans, avec les vraies commandes, les vrais chiffres vérifiés dans la documentation officielle, et les pièges à éviter.

Pourquoi Cloudflare Workers, et pourquoi c'est compliqué en 2026

Cloudflare Workers est une plateforme de calcul « serverless » : au lieu de louer une machine qui tourne en permanence, tu envoies ton code (JavaScript, TypeScript ou WebAssembly) et Cloudflare l'exécute directement sur son réseau, au plus près de chaque visiteur, uniquement quand une requête arrive. Il n'y a pas de serveur à administrer, pas de mise à jour système, pas de facture qui tombe si personne ne visite ton site.

Le sujet est devenu plus complexe qu'il y a deux ans parce que Cloudflare a fusionné progressivement deux produits qui étaient auparavant séparés : Cloudflare Pages (pensé pour les sites statiques et les frameworks front-end) et Cloudflare Workers (pensé pour du code serverless). Depuis que les Workers savent nativement servir des fichiers statiques, Cloudflare recommande désormais de commencer tout nouveau projet directement sur Workers plutôt que sur Pages, les deux plateformes ayant atteint une parité de fonctionnalités pour les sites statiques, le rendu dynamique et les domaines personnalisés depuis début 2026, à l'exception de quelques produits qui restent propres à Workers (Secrets Store, Workflows, Containers, Durable Objects).

Autre changement important : l'ancienne fonctionnalité « Workers Sites », qui servait à héberger des fichiers statiques via Workers KV, est désormais dépréciée. La documentation officielle est claire : « Do not use Workers Sites for new projects », et cette approche a été retirée de Wrangler v4. C'est remplacé par « Workers Static Assets », la méthode recommandée aujourd'hui pour déployer un site.

Cloudflare Workers, c'est quoi exactement ?

En résumé : Cloudflare Workers est un service de calcul serverless qui exécute ton code JavaScript, TypeScript ou WebAssembly directement sur le réseau mondial de Cloudflare, sans serveur à gérer. Depuis 2024, il sait aussi servir des fichiers statiques (HTML, CSS, images), ce qui en fait une solution complète pour héberger un site.

Techniquement, un Worker tourne dans un « isolate » V8 : un environnement ultra-léger, différent d'un conteneur classique, qui démarre quasi instantanément. C'est ce qui permet à Cloudflare de facturer uniquement le temps de calcul réellement utilisé.

  • Un Worker : un script qui répond aux requêtes HTTP (et à d'autres déclencheurs comme les tâches planifiées ou les files d'attente).
  • Les assets statiques : tes fichiers HTML, CSS, JavaScript, images, qui sont servis directement depuis le réseau de Cloudflare, sans passer par ton code.
  • Wrangler : l'outil en ligne de commande officiel pour développer, tester et déployer tes Workers.
  • Le fichier de configuration (wrangler.jsonc ou wrangler.toml) : il décrit ton projet, où sont tes fichiers, et quelles ressources (bases de données, stockage) ton Worker peut utiliser.

Pour qui c'est fait : les créateurs de sites vitrines, blogs, petites applications web ou API qui veulent un hébergement rapide, sans serveur à maintenir, et qui sont à l'aise avec un minimum de ligne de commande.

Cloudflare Workers vs Cloudflare Pages : lequel choisir en 2026 ?

En résumé : Cloudflare Pages reste disponible pour les projets existants, mais Cloudflare recommande désormais de démarrer tout nouveau site sur Workers, car les Workers gèrent maintenant aussi bien le contenu statique que la logique dynamique, dans un seul déploiement.

La documentation officielle de bonnes pratiques est explicite : « Workers Static Assets is the recommended way to deploy static sites, single-page applications, and full-stack apps on Cloudflare ». Concrètement :

  • Pages : historiquement pensé pour les sites statiques et les frameworks front-end, avec déploiement lié à un dépôt Git et des previews automatiques par branche.
  • Workers avec assets statiques : un seul projet gère à la fois tes fichiers statiques et ta logique serveur (API, rendu dynamique), avec accès natif à Durable Objects, Cron Triggers, files d'attente, etc.
  • Facturation : les requêtes vers des fichiers statiques sont gratuites et illimitées sur les deux plateformes ; seule la partie « code exécuté » est comptabilisée dans les quotas Workers.
  • Migration : si tu as déjà un site sur Pages, il continue de fonctionner ; il n'y a pas d'urgence à migrer, mais les nouvelles fonctionnalités arrivent en priorité sur Workers.

Pour qui c'est fait : si tu démarres un projet neuf aujourd'hui, pars directement sur Workers avec assets statiques. Si tu as déjà un site sur Pages qui tourne bien, tu n'es pas obligé de tout casser.

Combien coûte Cloudflare Workers, et quelles sont les limites du plan gratuit ?

En résumé : Le plan gratuit de Cloudflare Workers inclut 100 000 requêtes par jour et 10 millisecondes de temps CPU par requête, ce qui suffit pour un site vitrine ou un petit projet. Le plan payant démarre à 5 $/mois et inclut 10 millions de requêtes et 30 millions de millisecondes CPU par mois.

Ces chiffres viennent directement de la page officielle de tarification des Workers. Le plan gratuit propose 100 000 requêtes par jour, tous scripts confondus sur ton compte, avec 10 ms de temps CPU par invocation. Le plan payant (Standard) inclut 10 millions de requêtes par mois plus 0,30 $ par million supplémentaire, et 30 millions de millisecondes CPU par mois plus 0,02 $ par million, avec un plafond de 30 secondes de CPU par défaut par invocation, configurable jusqu'à 5 minutes selon la documentation officielle.

Points importants à connaître avant de te lancer :

  • Requêtes vers des fichiers statiques : non comptées dans ces quotas, servies gratuitement sur les deux plans.
  • Dépassement du temps CPU sur le plan gratuit : au-delà de 10 ms, ton Worker peut être interrompu et renvoyer une erreur. Un site principalement statique avec un peu de logique légère reste largement dans ces limites.
  • Sous-requêtes : le nombre d'appels sortants par invocation est limité ; utile si tu enchaînes plusieurs appels à des API externes.

Pour qui c'est fait : le plan gratuit convient très bien à un blog ou un site vitrine à trafic modéré. Dès qu'une logique serveur plus gourmande s'ajoute, passe au plan payant à 5 $/mois pour éviter les blocages.

Bon à savoir : les tarifs et quotas de Cloudflare évoluent régulièrement. Vérifie toujours les chiffres sur la page officielle de tarification avant de t'engager, en particulier si tu prévois un trafic important ou si ton projet dépend de services associés comme Workers KV, D1 ou R2, qui ont leurs propres quotas et grilles tarifaires.

Comment déployer un premier site sur Cloudflare Workers, étape par étape ?

En résumé : Le déploiement se fait en trois grandes étapes : créer le projet avec l'outil officiel, préparer tes fichiers ou ton code, puis lancer une seule commande pour publier. Tout se fait depuis un terminal, avec l'outil Wrangler.

Voici la marche à suivre pour un site simple, purement statique (HTML/CSS/JS), sans framework complexe.

Étape 1 : les prérequis

  • Un compte Cloudflare gratuit (email et mot de passe).
  • Node.js installé sur ta machine (version récente recommandée).
  • Un terminal et des notions de base de la ligne de commande.
  • Optionnel : un nom de domaine déjà pointé vers Cloudflare si tu veux ton propre domaine plutôt que l'adresse *.workers.dev fournie par défaut.

Étape 2 : créer le projet

Dans ton terminal, lance la commande officielle de création de projet :

npm create cloudflare@latest -- mon-site

Étape 3 : configurer le fichier du projet

Un fichier de configuration est généré automatiquement (wrangler.jsonc le plus souvent aujourd'hui). Pour un site statique, il ressemble à ceci, avec assets.directory qui pointe vers le dossier contenant tes fichiers construits (par exemple ./dist) :

{

"name": "mon-site",

"compatibility_date": "2026-09-26",

"assets": {

"directory": "./dist"

}

}

Étape 4 : tester en local

npx wrangler dev

Cette commande simule l'environnement de Cloudflare en local, avec rechargement automatique, pour vérifier que tout fonctionne avant de publier.

Étape 5 : déployer

npx wrangler deploy

La première fois, la commande ouvre ton navigateur pour te connecter. Ton site est alors accessible sur une adresse de type mon-site.<ton-compte>.workers.dev.

Étape 6 : brancher ton propre nom de domaine (optionnel)

Une fois le Worker déployé, associe un domaine personnalisé depuis le tableau de bord Cloudflare, à condition que ce domaine soit déjà géré par les serveurs DNS de Cloudflare.

Pour qui c'est fait : toute personne à l'aise avec un terminal de base, même sans expérience de développeur. Si tu n'as jamais ouvert de terminal, prévois de suivre un tuto d'introduction avant de te lancer.

Peut-on faire un site full-stack avec une base de données sur Cloudflare Workers ?

En résumé : Oui. En plus de servir des fichiers statiques, un Worker peut exécuter du code dynamique (API, authentification, rendu de page) et se connecter à des services de stockage propres à Cloudflare comme Workers KV, D1 (base de données SQL) ou R2 (stockage de fichiers).

Pour un site avec des parties dynamiques (formulaire, espace membre, panier), tu ajoutes un point d'entrée principal à ton Worker en plus du dossier d'assets statiques :

  • Workers KV : une base clé-valeur pour du stockage simple et rapide (configuration, cache, petites données).
  • D1 : une base de données SQL managée par Cloudflare, pratique si tu as besoin de requêtes relationnelles classiques.
  • R2 : du stockage d'objets compatible avec l'API S3, pour héberger des fichiers volumineux (images, vidéos, documents) sans frais de sortie de bande passante.
  • Durable Objects : pour de la logique qui a besoin d'un état persistant et cohérent (compteurs, sessions temps réel, coordination entre requêtes).

Ces services ont chacun leur propre quota gratuit et leur propre grille tarifaire.

Pour qui c'est fait : les projets qui dépassent le simple site vitrine et ont besoin d'une vraie logique applicative, sans vouloir gérer une base de données traditionnelle sur un serveur séparé.

Quelles sont les principales limites et pièges à connaître ?

En résumé : Les limites les plus fréquentes concernent le temps CPU (pas le temps d'attente réseau), le nombre de sous-requêtes par invocation, et la taille du script. Il existe aussi des pièges de configuration spécifiques à la migration depuis Workers Sites ou depuis Pages.

  • Temps CPU, pas temps d'attente : Cloudflare ne facture que le calcul réel, pas le temps passé à attendre une réponse réseau. Un Worker qui attend 200 ms une API externe mais ne calcule que 5 ms reste dans les clous du plan gratuit.
  • Pas de traitements longs sur une requête HTTP : pour des tâches lourdes, utilise plutôt un « Queue consumer » ou un Cron Trigger, avec des limites de temps bien plus larges.
  • Workers Sites est obsolète : si un ancien tutoriel en parle, ignore-le pour un nouveau projet et utilise « Workers Static Assets ».
  • Fichier .assetsignore : contrairement à Pages, Workers n'exclut pas automatiquement node_modules ou .git : crée ce fichier pour éviter de publier des fichiers inutiles ou sensibles.
  • Ne jamais afficher de secrets à l'écran : clés API et variables sensibles passent par les commandes dédiées de gestion des secrets, jamais en clair dans le code ou à l'écran en vidéo.
Bon à savoir : si ton Worker gratuit commence à dépasser régulièrement les 10 ms de CPU par requête, ce n'est pas forcément un bug de ta part : certaines opérations courantes (chiffrement, plusieurs appels à une base de données dans une même requête) suffisent à dépasser ce seuil. C'est souvent le signal qu'il est temps de passer au plan payant.

Comment ce guide a été construit

Cet article a été rédigé à partir d'une recherche ciblée dans la documentation officielle de Cloudflare (developers.cloudflare.com, cloudflare.com/plans), complétée par des articles techniques récents de 2026 pour contextualiser les changements de plateforme. Les chiffres de tarification et de limites (quotas de requêtes, temps CPU, commandes Wrangler) proviennent directement des pages officielles.

Les points qui reposent sur des sources tierces non officielles, ou qui dépendent de ta configuration, sont présentés comme des estimations. Les détails d'interface du tableau de bord Cloudflare peuvent aussi évoluer entre la rédaction de ce guide et ta lecture.

Cas d'usage concrets

Le créateur qui lance son premier portfolio

Tu es freelance et tu veux un site vitrine simple avec quelques pages et un formulaire de contact. Un site statique déployé avec Workers Static Assets, sur le plan gratuit, couvre largement ce besoin : 100 000 requêtes par jour suffisent pour ce type de trafic.

La petite entreprise avec un espace client

Tu gères une boutique avec un espace client nécessitant une authentification et des données dynamiques. Tu combines assets statiques pour le front-end et un Worker avec D1 pour la base de données. Prévois le passage au plan payant à 5 $/mois dès que le trafic ou la complexité augmentent.

Le développeur qui migre depuis un VPS classique

Tu en as assez de gérer les mises à jour de sécurité d'un serveur traditionnel. Migrer une API vers Workers fait gagner du temps d'administration, mais impose de revoir le code pour respecter les limites de CPU et déplacer les traitements longs vers des files d'attente.

L'agence qui gère plusieurs sites clients

Tu déploies des dizaines de petits sites pour des clients. Le modèle « un Worker par site » avec assets statiques permet un déploiement rapide et reproductible via wrangler deploy, et l'automatisation via l'action GitHub officielle wrangler-action publie automatiquement chaque mise à jour, sans intervention manuelle.

En résumé

Cloudflare Workers est aujourd'hui la voie recommandée par Cloudflare elle-même pour héberger un site, statique ou full-stack, sans jamais toucher à un serveur. Le déploiement tient en quelques commandes (npm create cloudflare@latest, puis npx wrangler deploy), le plan gratuit (100 000 requêtes par jour, 10 ms de CPU par requête) suffit pour démarrer, et le plan payant à 5 $/mois couvre confortablement la montée en charge d'un petit projet. Le principal changement à intégrer en 2026 reste l'abandon de l'ancien « Workers Sites » au profit des « Workers Static Assets », plus simple et unifié avec le reste de la plateforme.

Tableau comparatif : plan gratuit vs plan payant Cloudflare Workers

CritèrePlan FreePlan Standard (payant)
Coût mensuel0 $à partir de 5 $/mois
Requêtes incluses100 000 par jour10 millions par mois, puis 0,30 $/million
Temps CPU inclus10 ms par invocation30 millions de ms CPU/mois, puis 0,02 $/million
Durée max par invocationlimitée par le seuil CPU30 s par défaut, configurable jusqu'à 5 min*
Fichiers statiquesgratuits et illimitésgratuits et illimités
Adapté poursite vitrine, prototype, petit projet persosite avec trafic soutenu ou logique serveur plus lourde

*Valeur à confirmer selon le type de déclencheur (requête HTTP vs tâche planifiée ou file d'attente) — voir la page officielle de tarification pour le détail exact.

Comment choisir selon ton usage réel

  • Besoin : site vitrine simple, sans base de données : reste sur Workers Static Assets et le plan gratuit.
  • Besoin : formulaire, petite API ou espace membre léger : Workers avec assets statiques + KV ou D1, en surveillant tes quotas.
  • Besoin : migration d'un site déjà en production sur un VPS : teste avec wrangler dev, vérifie tes dépendances Node.js, et budgète le plan payant si le trafic est déjà significatif.
  • Besoin : gros trafic ou traitements lourds réguliers : combine Workers pour les requêtes rapides et Queues ou Cron Triggers pour les tâches longues, en plan payant dès le départ.
  • Besoin : hébergement statique sans logique serveur : Workers Static Assets fonctionne très bien, mais Pages reste valable si tu préfères un déploiement lié à un dépôt Git.
Bon à savoir : les prix, quotas et noms de fonctionnalités de Cloudflare changent régulièrement. Avant de publier ou de facturer un projet client, revérifie toujours les chiffres sur la documentation officielle, en particulier si plusieurs mois se sont écoulés depuis la lecture de cet article.

Foire aux questions

Cloudflare Workers est-il vraiment gratuit ?

Le plan gratuit permet de déployer un site sans payer, avec 100 000 requêtes par jour et 10 ms de temps CPU par requête. Ce n'est pas « sans limite » : au-delà de ces seuils, il faut passer au plan payant à partir de 5 $/mois. Les fichiers statiques restent gratuits sur les deux plans.

Dois-je apprendre à coder pour déployer un site sur Cloudflare Workers ?

Pour un site purement statique (fichiers déjà écrits), non : quelques commandes de terminal suffisent pour créer le projet et le déployer. Dès que tu ajoutes une logique dynamique (API, base de données), des bases en JavaScript ou TypeScript deviennent nécessaires.

Quelle est la différence entre Cloudflare Pages et Cloudflare Workers en 2026 ?

Les deux permettent d'héberger un site, mais Cloudflare recommande désormais Workers pour tout nouveau projet, car les Workers savent servir des fichiers statiques tout en gérant la logique dynamique dans un seul déploiement, avec accès à davantage de fonctionnalités (Durable Objects, Cron Triggers, files d'attente). Pages reste supporté pour les projets existants.

Que devient l'ancien système « Workers Sites » ?

Workers Sites est déprécié : la documentation officielle recommande explicitement de ne plus l'utiliser pour de nouveaux projets et de passer par « Workers Static Assets » à la place. Cette dépréciation s'accompagne du retrait du support dans Wrangler v4.

Puis-je utiliser mon propre nom de domaine avec Cloudflare Workers ?

Oui, à condition que ton domaine soit déjà géré par les serveurs DNS de Cloudflare. Tu peux ensuite associer un domaine personnalisé à ton Worker depuis le tableau de bord.

Que se passe-t-il si mon Worker dépasse les limites du plan gratuit ?

Sur le plan gratuit, dépasser régulièrement le temps CPU alloué peut entraîner l'interruption de certaines requêtes. Dépasser le nombre de requêtes quotidiennes limite l'exécution de ton code au-delà du seuil. Dans les deux cas, la solution est de passer au plan payant, qui inclut des volumes bien plus larges avant la moindre facturation additionnelle.

Sources vérifiées

Envie de le voir en vidéo ?

Les tutos pas à pas sont aussi sur Instagram.

Suivre @nickandtech