Montrer un site en cours de développement à un client, faire tester une application à un collègue ou vérifier un rendu depuis son téléphone : le besoin revient souvent, et la réponse classique (ouvrir un port sur la box, configurer une redirection, gérer un certificat) est franchement lourde pour une démo de dix minutes. Cloudflare propose depuis un moment une solution bien plus simple avec la commande cloudflared tunnel --url, qui publie un serveur tournant sur votre machine à une adresse en trycloudflare.com. Pas besoin de compte, ni de nom de domaine, et aucun port à ouvrir.
La nouveauté, c'est qu'on peut désormais réserver cette adresse à quelques personnes choisies grâce à une vérification par e-mail. Je compte m'en servir pour présenter mes sites Joomla en local à mes clients, alors j'ai épluché la documentation officielle pour vous détailler l'installation, les pièges à éviter (Vite, hôtes virtuels), les alternatives et la façon d'encadrer un agent IA qui voudrait ouvrir des tunnels tout seul.
Quick Tunnels, de quoi parle-t-on ?
Un Quick Tunnel repose sur cloudflared, le petit connecteur open source de Cloudflare. Il ouvre une connexion sortante depuis votre ordinateur vers le réseau de Cloudflare. Comme c'est votre machine qui appelle, et pas Internet qui cherche à entrer chez vous, le pare-feu de la box n'y voit rien à redire : aucune redirection de port, aucune adresse IP publique à exposer.
Cloudflare attribue ensuite à ce tunnel une adresse aléatoire du type mot-mot-mot-mot.trycloudflare.com, en HTTPS. Toute requête arrivant sur cette adresse est relayée jusqu'à votre serveur local. Quand vous fermez cloudflared, l'adresse cesse de fonctionner. C'est tout le principe, et c'est ce qui rend l'outil si pratique pour les démos.
Pour les débutants : « localhost » désigne votre propre ordinateur. Un serveur qui écoute sur http://localhost:8080 n'est joignable que depuis cette machine. Le tunnel sert justement à le rendre accessible depuis l'extérieur, sans toucher à la configuration de votre réseau.
Installer cloudflared sur macOS, Linux et Windows
Sur macOS
Le plus simple est de passer par Homebrew :
brew install cloudflared
Sur Debian et Ubuntu
Je vous conseille le dépôt officiel de Cloudflare. Sa clé de signature a changé récemment, donc méfiez-vous des vieux tutoriels qui donnent encore l'ancienne. Voici les commandes à jour :
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main' | sudo tee /etc/apt/sources.list.d/cloudflared.list
sudo apt-get update && sudo apt-get install cloudflared
Pour les autres distributions, la page de téléchargement de Cloudflare propose des paquets .deb et .rpm ainsi que des binaires pour x86, ARM et ARM64. Il existe aussi une image Docker.
Sous Windows
Deux options. La première passe par winget, le gestionnaire de paquets intégré à Windows 10 et 11 :
winget install --id Cloudflare.cloudflared
La seconde consiste à récupérer l'installateur MSI ou l'exécutable, en 32 ou 64 bits, sur la même page de téléchargement. Après une installation par winget, pensez à rouvrir votre terminal pour que la commande soit reconnue.
Vérifier la version
Quel que soit votre système, contrôlez la version installée :
cloudflared --version
La protection par e-mail dont je parle plus bas n'existe qu'à partir de cloudflared 2026.9.3. Si votre version est plus ancienne, mettez-la à jour (brew upgrade cloudflared, sudo apt-get upgrade cloudflared ou winget upgrade Cloudflare.cloudflared). Au passage, Cloudflare ne prend en charge que les versions sorties dans l'année qui précède la dernière publication.
Préparer un petit serveur de test
Avant de brancher un vrai projet, je préfère toujours valider la chaîne avec une page toute simple. Python embarque un mini serveur web, le module http.server, parfait pour ça :
mkdir test-tunnel
cd test-tunnel
echo "<h1>Le tunnel fonctionne</h1>" > index.html
python3 -m http.server 8080
Sous Windows, remplacez la dernière ligne par py -m http.server 8080. Ouvrez http://localhost:8080 dans votre navigateur : si le titre s'affiche, le serveur local est prêt. Laissez ce terminal ouvert.
Ouvrir un premier tunnel public
Dans un second terminal, lancez :
cloudflared tunnel --url http://localhost:8080
Après quelques secondes, cloudflared affiche un encadré contenant l'adresse publique, composée de quatre mots au hasard, avec un avertissement indiquant qu'elle peut mettre un peu de temps à répondre. C'est normal : il faut laisser au DNS le temps de propager ce nouveau nom. Si rien ne vient au bout d'une minute ou deux, videz le cache DNS de votre machine (ipconfig /flushdns sous Windows) et réessayez.
Pour le test, j'ouvre l'adresse sur un autre appareil, idéalement un téléphone en 4G ou 5G, donc en dehors de mon réseau local. Si la page « Le tunnel fonctionne » s'affiche, tout est bon. Pour tout couper, un Ctrl+C dans le terminal de cloudflared suffit. Au prochain lancement, vous obtiendrez une nouvelle adresse, différente de la précédente.
Le port 8080 n'a rien d'obligatoire. L'option --url accepte toute adresse que cloudflared peut joindre, y compris une autre machine de votre réseau local, par exemple http://192.168.1.50:8123 pour un serveur domotique ou un NAS.
Vite, WampServer et les en-têtes Host
Le cas de Vite
Si votre projet tourne avec Vite, vous risquez de tomber sur un message « Blocked request » en ouvrant l'adresse du tunnel. Par sécurité, le serveur de développement de Vite ne répond qu'aux requêtes adressées à localhost, aux domaines en .localhost et aux adresses IP. Le plus simple consiste à réécrire l'en-tête Host envoyé par le tunnel pour faire croire à Vite qu'on l'appelle en local :
cloudflared tunnel --url http://localhost:5173 --http-host-header localhost:5173
L'autre méthode consiste à déclarer l'hôte dans le réglage server.allowedHosts de Vite. Comme l'adresse change à chaque lancement, vous pouvez autoriser .trycloudflare.com (le point initial couvre tous les sous-domaines).
Ne passez pas server.allowedHosts à true pour gagner du temps. La documentation de Vite le déconseille clairement : ce réglage expose votre serveur de développement à des attaques par DNS rebinding.
Un site local avec hôte virtuel (WampServer, XAMPP, Laragon)
C'est le cas qui me concerne le plus. Quand je développe un site Joomla en local, il est généralement servi par Apache via un hôte virtuel, du genre monsite.local. Apache choisit le site à afficher en fonction de l'en-tête Host. Or le tunnel transmet par défaut le nom en trycloudflare.com, que votre Apache ne connaît pas : vous risquez de tomber sur la page d'accueil de WampServer ou sur un autre site. La même option règle le problème :
cloudflared tunnel --url http://localhost:80 --http-host-header monsite.local
Si votre site local est en HTTPS avec un certificat auto-signé, pointez vers https://localhost:443 et ajoutez --no-tls-verify, sinon cloudflared refusera le certificat. Gardez aussi en tête qu'un CMS qui fabrique des URL absolues (une adresse forcée dans la configuration, une redirection vers HTTPS ou vers le nom de domaine local) peut renvoyer votre visiteur vers monsite.local, introuvable de son côté. Un test sur téléphone avant d'envoyer le lien au client vous évitera ce genre de déconvenue.
Les limites d'un Quick Tunnel
Soyons clairs, c'est un outil de test et de démonstration, pas une solution d'hébergement. La documentation officielle des Quick Tunnels liste plusieurs limites :
- aucune garantie de disponibilité ;
- 200 requêtes simultanées au maximum par tunnel, au-delà de quoi les visiteurs reçoivent une erreur 429 ;
- pas de prise en charge des Server-Sent Events (SSE) ;
- un nom d'hôte qui change à chaque nouveau tunnel.
Pour une adresse fixe, du vrai trafic ou des règles d'accès plus fines, il faut passer à un tunnel nommé, créé depuis un compte Cloudflare avec un domaine géré chez eux. Voici comment je résume les trois approches :
| Critère | Quick Tunnel public | Quick Tunnel protégé | Tunnel nommé + Cloudflare Access |
|---|---|---|---|
| Compte Cloudflare | Non | Non | Oui |
| Nom de domaine | Non (trycloudflare.com) | Non (trycloudflare.com) | Oui, le vôtre |
| Adresse fixe | Non | Non | Oui |
| Contrôle d'accès | Aucun, l'adresse suffit | Liste d'e-mails ou de domaines, code à usage unique | Règles complètes (fournisseur d'identité, groupes, etc.) |
| Webhooks et clients automatiques | Oui | Non | Oui, avec la configuration adaptée |
| Usage conseillé | Test rapide sans données sensibles | Démo à un client ou un collègue | Service durable, production |
| Les Quick Tunnels, protégés ou non, sont gratuits. | |||
Réserver l'accès avec --allowed-mail
Jusqu'ici, n'importe qui disposant de l'adresse pouvait accéder à votre service. Depuis cloudflared 2026.9.3, Cloudflare propose les « Protected Quick Tunnels », présentés sur le blog officiel de Cloudflare. Il suffit d'ajouter l'option --allowed-mail suivie de l'adresse de la personne autorisée :
cloudflared tunnel --url http://localhost:8080 --allowed-mail Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser.
L'encadré de démarrage change alors de contenu : il indique que le tunnel est protégé par une authentification à code unique via Cloudflare Access, ainsi que le nombre d'adresses autorisées. Les adresses elles-mêmes n'apparaissent nulle part, la ligne des réglages les remplace par des astérisques. Très pratique si vous lancez le tunnel en plein partage d'écran pendant une visio.
Plusieurs adresses ou tout un domaine
Vous pouvez répéter l'option autant de fois que nécessaire, séparer plusieurs adresses par des virgules, ou autoriser tout un domaine avec un joker. Mettez bien des guillemets simples autour du joker, sinon votre shell tentera d'interpréter l'étoile :
cloudflared tunnel --url http://localhost:8080 \
--allowed-mail Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser. \
--allowed-mail Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser. \
--allowed-mail '*@monagence.fr'
Sous PowerShell, remplacez les barres obliques inverses de fin de ligne par un accent grave (`), ou écrivez tout sur une seule ligne.
Avec Wrangler
Si vous développez sur Cloudflare Workers, l'outil Wrangler accepte la même option :
npx wrangler tunnel quick-start http://localhost:8080 --allowed-mail Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser.
Ce que voit votre invité
Votre visiteur ouvre l'adresse que vous lui avez transmise et se retrouve redirigé vers login.trycloudflare.com, sur une page Cloudflare Access qui lui demande son adresse e-mail. Il reçoit un code dans sa boîte de réception, le saisit, et accède enfin à votre application. Il n'a besoin d'aucun compte Cloudflare. Une fois authentifié, il conserve sa session jusqu'à 4 heures.
Une personne absente de la liste reçoit simplement une réponse de refus, et sa requête n'atteint jamais votre application. Point appréciable côté confidentialité : votre liste d'adresses ne quitte jamais votre ordinateur. Cloudflare Access se contente de vérifier que le visiteur contrôle bien l'adresse saisie, et c'est cloudflared, sur votre machine, qui la compare à la liste que vous avez tapée.
La liste ne se modifie pas à chaud. Pour ajouter ou retirer quelqu'un, il faut arrêter le tunnel et en relancer un nouveau, ce qui coupe l'accès à tout le monde et génère une nouvelle adresse à renvoyer. Prenez donc une minute pour réunir toutes les adresses avant d'envoyer le lien.
Les cas où la protection par e-mail ne marche pas
La vérification par code suppose un humain derrière un vrai navigateur. Un webhook Stripe ou GitHub, un script curl ou n'importe quel client automatique restera bloqué devant la page de connexion. Pour ces usages, deux options :
- pour un test ponctuel, ouvrir un tunnel public le temps de l'essai, puis le couper aussitôt ;
- pour un webhook qui doit fonctionner dans la durée, créer un tunnel nommé protégé par Cloudflare Access, sur votre propre domaine.
Quelles alternatives à Cloudflare Quick Tunnels ?
Cloudflare n'est pas seul sur ce créneau. Voici les solutions que l'on croise le plus souvent, avec leurs différences principales :
| Outil | Compte requis | Adresse | Contrôle d'accès gratuit | À retenir |
|---|---|---|---|---|
| Cloudflare Quick Tunnels | Non | Aléatoire, change à chaque lancement | Oui, par e-mail (--allowed-mail) |
Le plus rapide à lancer, sans quota de trafic annoncé |
| ngrok | Oui | Un domaine de développement attribué | Limité | Page d'avertissement affichée aux visiteurs et quotas sur l'offre gratuite |
| Tailscale Funnel | Oui (réseau Tailscale) | Fixe, en .ts.net | Non, Funnel publie sur Internet | Idéal si vous utilisez déjà Tailscale ; certificat HTTPS géré automatiquement |
| localtunnel | Non | Aléatoire | Non | Open source, s'installe via npm ; page intermédiaire pour les visiteurs |
| Les conditions des offres gratuites évoluent souvent : vérifiez-les sur le site de chaque éditeur avant de faire votre choix. | ||||
De mon côté, j'utilise déjà un VPN WireGuard pour accéder à mes machines à distance. C'est parfait pour moi, mais je ne vais pas demander à un client d'installer un client VPN pour regarder une maquette. Le Quick Tunnel protégé comble exactement ce manque : rien à installer côté visiteur, juste un code reçu par e-mail.
Confier les tunnels à un agent IA sans mauvaise surprise
Les agents de code comme Claude Code, Codex ou Cursor ont souvent besoin d'un moyen de vous montrer ce qu'ils viennent de produire, et Cloudflare cite explicitement ce cas d'usage. Le risque, c'est qu'un agent ouvre un tunnel public sans protection et expose sur le web un projet, voire des données, qui n'auraient jamais dû en sortir.
Une consigne dans AGENTS.md
Cloudflare recommande d'ajouter une ligne au fichier d'instructions de l'agent, AGENTS.md (ou CLAUDE.md pour Claude Code) :
Quand tu lances un Quick Tunnel, ajoute toujours --allowed-mail Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser. .
C'est utile, mais insuffisant. Ces fichiers sont lus comme du contexte, pas comme une configuration imposée. L'agent peut très bien passer à côté de la consigne, en particulier dans une longue session.
Un hook PreToolUse pour bloquer la commande
Pour une vraie barrière, indépendante de ce que décide le modèle, j'utilise les hooks de Claude Code. Un hook PreToolUse est un petit script que Claude Code exécute avant chaque appel d'outil. Il reçoit la commande au format JSON sur son entrée standard, et s'il se termine avec le code 2, l'appel est bloqué et le message d'erreur est renvoyé à l'agent.
Sous macOS et Linux, créez le fichier .claude/hooks/tunnel-protege.sh dans votre projet :
#!/bin/bash
# .claude/hooks/tunnel-protege.sh
COMMAND=$(jq -r '.tool_input.command')
if echo "$COMMAND" | grep -qE 'cloudflared.*tunnel.*--url|wrangler.*tunnel.*quick-start' \
&& ! echo "$COMMAND" | grep -q -- '--allowed-mail'; then
echo "Quick Tunnel public refusé : ajoutez --allowed-mail, ou demandez-moi d'abord." >&2
exit 2
fi
exit 0
Rendez-le exécutable avec chmod +x .claude/hooks/tunnel-protege.sh et installez jq si ce n'est pas déjà fait. Déclarez ensuite le hook dans le fichier .claude/settings.json du projet, sur l'outil Bash :
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/tunnel-protege.sh"
}
]
}
]
}
}
À partir de là, un cloudflared tunnel --url ou un wrangler tunnel quick-start lancé sans --allowed-mail est refusé, et l'agent reçoit le message lui demandant d'ajouter l'option ou de vous consulter. Un tunnel nommé lancé avec cloudflared tunnel run passe normalement.
La version Windows en PowerShell
Une bonne partie d'entre vous travaille sous Windows, et le script bash ci-dessus suppose Git Bash ou WSL ainsi que jq. Voici un équivalent en PowerShell, sans dépendance. Créez .claude\hooks\tunnel-protege.ps1 :
# .claude\hooks\tunnel-protege.ps1
$data = [Console]::In.ReadToEnd() | ConvertFrom-Json
$cmd = $data.tool_input.command
if ($cmd -match 'cloudflared.*tunnel.*--url|wrangler.*tunnel.*quick-start' -and $cmd -notmatch '--allowed-mail') {
[Console]::Error.WriteLine("Quick Tunnel public refusé : ajoutez --allowed-mail, ou demandez-moi d'abord.")
exit 2
}
exit 0
Puis déclarez-le ainsi dans .claude\settings.json :
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "powershell -NoProfile -ExecutionPolicy Bypass -Command \"& (Join-Path $env:CLAUDE_PROJECT_DIR '.claude\\hooks\\tunnel-protege.ps1'); exit $LASTEXITCODE\""
}
]
}
]
}
}
Le exit $LASTEXITCODE final n'est pas décoratif : sans lui, PowerShell renvoie 0 même si votre script se termine par exit 2, et Claude Code ne bloque rien.
Plusieurs utilisateurs ont signalé des comportements irréguliers des hooks PreToolUse sous Windows selon les versions de Claude Code. Testez toujours votre garde-fou : demandez à l'agent de lancer cloudflared tunnel --url http://localhost:8080 sans option et vérifiez que la commande est bien refusée avant de lui faire confiance.
Les limites de ce garde-fou
Ce hook a ses angles morts. Il ne lit que le texte de la commande, sans vérifier l'adresse qui suit l'option : --allowed-mail '*@gmail.com' passerait sans broncher. Il ne voit pas non plus un tunnel lancé depuis un script intermédiaire, ni via la variable d'environnement TUNNEL_URL, qui permet elle aussi d'ouvrir un Quick Tunnel. Je garde donc les deux protections, la consigne dans AGENTS.md et le hook : elles se complètent.
En entreprise, parlez-en d'abord au service informatique
Avant d'utiliser ces tunnels sur un ordinateur professionnel, gardez en tête qu'ils sont aussi appréciés des cybercriminels. Proofpoint a documenté en 2024 des campagnes de malware s'appuyant sur les tunnels trycloudflare.com gratuits pour distribuer des chevaux de Troie d'accès à distance. C'est pour cette raison que des solutions de sécurité comme Elastic Security intègrent des règles qui repèrent cloudflared lorsqu'il expose un service local, et que la recommandation habituelle est de bloquer les domaines de tunnel quand leur usage n'est pas autorisé.
Concrètement, si vous comptez utiliser cloudflared au travail, demandez l'accord de votre administrateur système. Vous éviterez une alerte de sécurité inutile, et il pourra prévoir une exception propre plutôt que de découvrir l'outil dans ses journaux.
Questions fréquentes
- Faut-il un compte Cloudflare pour utiliser un Quick Tunnel ?
- Non. Ni vous ni vos visiteurs n'avez besoin de compte, même avec la protection par e-mail. Un compte devient nécessaire seulement pour un tunnel nommé sur votre propre domaine.
- Les Quick Tunnels sont-ils gratuits ?
- Oui, et la protection par e-mail l'est aussi.
- Combien de temps l'adresse reste-t-elle valable ?
- Tant que le processus cloudflared tourne. Dès que vous l'arrêtez, l'adresse ne répond plus, et le prochain lancement en génère une nouvelle.
- Peut-on choisir son adresse en trycloudflare.com ?
- Non, elle est aléatoire. Pour une adresse stable, il faut un tunnel nommé avec un domaine géré par Cloudflare.
- Peut-on exposer un service d'une autre machine du réseau local ?
- Oui, l'option --url accepte n'importe quelle adresse joignable par cloudflared, comme http://192.168.1.50:8080.
- Mes visiteurs autorisés doivent-ils se reconnecter souvent ?
- Une fois le code saisi, la session reste active jusqu'à 4 heures. Au-delà, ou après un redémarrage du tunnel, ils devront recommencer la vérification.
Mon avis
Les Quick Tunnels étaient déjà pratiques, mais l'absence de contrôle d'accès me retenait pour les démos clients : un lien qui traîne dans un e-mail transféré, et n'importe qui pouvait tomber sur un site pas terminé. Avec --allowed-mail, ce frein disparaît, sans compte, sans domaine et sans frais. C'est l'outil que je vais ajouter à ma boîte à outils pour montrer mes sites Joomla en cours de développement.
Comme la protection par e-mail ne coûte rien, je ne vois plus de bonne raison de publier une démo ouverte à tous. Gardez simplement les Quick Tunnels pour ce qu'ils sont, des tunnels de test, et passez à un tunnel nommé dès qu'un service doit tenir dans la durée.
Comment cet article a-t-il été réalisé ? Le texte a été rédigé par mes soins, puis relu avec l'aide d'une intelligence artificielle afin de corriger d'éventuelles erreurs d'orthographe ou de grammaire. L'illustration de présentation a également été créée à l'aide de l'IA.