Publier un service avec Cloudflare Tunnel
Publier une application hébergée sur Debian ou Ubuntu sans ouvrir de port entrant grâce à Cloudflare Tunnel, protéger une interface d'administration avec Cloudflare Access, mettre à jour et sauvegarder.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment publier une application hébergée sur votre serveur sans ouvrir de port entrant. Le programme cloudflared établit une connexion sortante vers Cloudflare. Les visiteurs arrivent sur https://app.votre-domaine.com, Cloudflare gère le certificat et transmet les requêtes dans ce tunnel.
À la fin du guide, l’application reste à l’écoute en local, le tunnel démarre avec le serveur et vous savez réserver une interface sensible à des personnes identifiées.
Commander un serveur
Ce guide s’applique aux serveurs que vous administrez vous-même :
Prérequis
- Un serveur sous Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04
- Un accès SSH avec un utilisateur disposant de
sudo - Un compte Cloudflare
- Un domaine actif sur ce compte
- Une application qui écoute en local, par exemple sur
127.0.0.1:3000
Ajouter le domaine à Cloudflare
Si le domaine n’est pas encore sur Cloudflare :
- Ajoutez-le depuis le tableau de bord, puis choisissez une offre.
- Contrôlez les enregistrements DNS importés. Vérifiez surtout les enregistrements MX et ceux de la messagerie, car l’analyse automatique peut en oublier.
- Désactivez DNSSEC chez votre registrar s’il est actif.
- Remplacez les serveurs de noms du domaine par ceux que Cloudflare vous indique. Pour un domaine géré chez HostMyServers, consultez le guide Serveur DNS.
Ports utilisés
| Port | Sens | Rôle | Action |
|---|---|---|---|
| 7844/tcp et 7844/udp | Sortant | Connexion du tunnel vers Cloudflare | À autoriser si les sorties sont filtrées |
| 443/tcp | Sortant | Fonctions annexes, comme la vérification des mises à jour | Facultatif |
| 3000/tcp | Local | Application d’exemple | Ne pas ouvrir |
| Aucun | Entrant | Le tunnel n’a besoin d’aucun port entrant | Rien à ouvrir |
Étape 1 : vérifier l’application
L’application doit répondre sur la boucle locale :
curl -I http://127.0.0.1:3000
sudo ss -ltnp | grep 3000L’adresse d’écoute doit être 127.0.0.1. Si l’application tourne dans Docker, publiez son port sous la forme 127.0.0.1:3000:3000. Une publication 3000:3000 resterait joignable depuis Internet, car Docker insère ses propres règles de pare-feu.
Étape 2 : installer cloudflared
Ajoutez le dépôt officiel de Cloudflare, puis installez le paquet :
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 -y cloudflared
cloudflared --versionÉtape 3 : créer le tunnel
Authentifiez cloudflared. La commande affiche une URL à ouvrir dans votre navigateur, où vous choisissez votre domaine :
sudo cloudflared tunnel loginLe certificat du compte est enregistré dans /root/.cloudflared/cert.pem. Créez ensuite le tunnel :
sudo cloudflared tunnel create hms-tunnel
sudo cloudflared tunnel listNotez l’identifiant affiché, appelé ici TUNNEL_UUID. Copiez son fichier d’identification dans le dossier utilisé par le service :
sudo install -d -m 700 /etc/cloudflared
sudo install -m 600 /root/.cloudflared/TUNNEL_UUID.json /etc/cloudflared/TUNNEL_UUID.jsonÉtape 4 : configurer le tunnel
sudo nano /etc/cloudflared/config.ymltunnel: TUNNEL_UUID
credentials-file: /etc/cloudflared/TUNNEL_UUID.json
ingress:
- hostname: app.votre-domaine.com
service: http://127.0.0.1:3000
- service: http_status:404Les règles sont lues dans l’ordre. La dernière, sans nom d’hôte, est obligatoire : elle répond 404 à toute requête qui ne correspond à aucun service.
Contrôlez le fichier et le routage d’une URL :
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress validate
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress rule https://app.votre-domaine.comÉtape 5 : protéger une interface d’administration
Ne sautez cette étape que si le service est destiné au public et dispose de sa propre authentification. Pour une interface d’administration, créez la protection avant de publier le nom : sans application Access, l’adresse est ouverte à tout Internet.
Dans le tableau de bord Cloudflare :
- Allez dans Zero Trust > Access controls > Applications.
- Sélectionnez Create new application, puis Self-hosted and private.
- Sélectionnez Add public hostname et indiquez
app.votre-domaine.com. - Sous Access policies, créez une politique avec l’action Allow et une règle Include de type Emails, contenant votre adresse.
- Choisissez le mode de connexion. Si vous souhaitez recevoir un code par e-mail, ajoutez One-time PIN dans Zero Trust > Integrations > Identity providers.
- Sélectionnez Create.
Les libellés peuvent évoluer : en cas de différence, suivez la documentation Cloudflare Access.
Vous pouvez aussi demander à cloudflared de vérifier le jeton Access. Le tag Application Audience (AUD) Tag se trouve dans Additional settings de l’application. Dans config.yml, complétez la règle concernée :
ingress:
- hostname: app.votre-domaine.com
service: http://127.0.0.1:3000
originRequest:
access:
required: true
teamName: TEAM_NAME
audTag:
- AUD_TAG
- service: http_status:404TEAM_NAME est le nom de votre équipe Cloudflare One, celui qui précède .cloudflareaccess.com. Relancez ensuite la validation de l’étape 4.
Étape 6 : publier le nom de domaine
Créez l’enregistrement DNS qui pointe vers le tunnel :
sudo cloudflared tunnel route dns hms-tunnel app.votre-domaine.comSi vous gérez plusieurs domaines, vérifiez dans le tableau de bord que l’enregistrement CNAME a bien été créé dans la bonne zone. Il doit pointer vers TUNNEL_UUID.cfargotunnel.com.
Étape 7 : lancer le tunnel comme service
sudo cloudflared service install
systemctl status cloudflared --no-pagerLa commande crée le service cloudflared, l’active au démarrage et le lance avec /etc/cloudflared/config.yml.
Vérifier le résultat
sudo journalctl -u cloudflared --no-pager -n 50 | grep 'Registered tunnel connection'
sudo cloudflared tunnel info hms-tunnel
curl -I https://app.votre-domaine.comLes journaux doivent indiquer des connexions enregistrées, et l’URL doit répondre. Si vous avez créé une application Access, ouvrez l’adresse dans une fenêtre de navigation privée : la page de connexion doit s’afficher avant l’application.
Depuis votre poste, l’accès direct doit échouer :
curl -m 5 -I http://VOTRE_IP_SERVEUR:3000Fermer les accès devenus inutiles
Si l’application était auparavant publiée sur les ports web et que plus rien ne les utilise, retirez leurs règles UFW :
sudo ufw status numbered
sudo ufw delete allow 80/tcp
sudo ufw delete allow 443/tcpLe tunnel fonctionne avec une politique entrante fermée. Conservez bien votre règle SSH, sauf si vous passez par un réseau privé comme Tailscale.
Le fichier cert.pem permet de gérer tous les tunnels du compte, alors que le service n’a besoin que du fichier d’identification du tunnel. Si vous n’administrez pas vos tunnels depuis ce serveur, supprimez-le :
sudo shred -u /root/.cloudflared/cert.pemIl faudra relancer sudo cloudflared tunnel login avant toute commande de gestion, comme tunnel route dns ou tunnel info. Supprimer ce fichier ne révoque pas le jeton qu’il contient : pour cela, supprimez le jeton Cloudflare Tunnel API Token ou Argo Tunnel API Token dans My Profile > API Tokens.
Publier un autre service
Ajoutez une règle avant la règle finale :
ingress:
- hostname: app.votre-domaine.com
service: http://127.0.0.1:3000
- hostname: docs.votre-domaine.com
service: http://127.0.0.1:8080
- service: http_status:404Validez, créez le nom DNS, puis redémarrez le service :
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress validate
sudo cloudflared tunnel route dns hms-tunnel docs.votre-domaine.com
sudo systemctl restart cloudflaredSi cert.pem a été supprimé, vous pouvez aussi créer dans le DNS Cloudflare un enregistrement CNAME vers TUNNEL_UUID.cfargotunnel.com.
Variante : gérer le tunnel depuis le tableau de bord
Cloudflare permet aussi de piloter le tunnel à distance, sans config.yml :
- Allez dans Networking > Tunnels, puis sélectionnez Create a tunnel.
- Nommez le tunnel, choisissez votre système et exécutez sur le serveur la commande proposée. Elle contient un jeton secret.
- Dans l’onglet Routes, sélectionnez Add route, puis Published application.
- Indiquez le sous-domaine, le domaine et l’URL du service, par exemple
http://127.0.0.1:3000.
Une machine ne peut exécuter qu’un seul service cloudflared. Ajoutez vos applications au tunnel existant plutôt que d’en installer un second.
Limites à connaître
- L’application voit les requêtes arriver depuis
cloudflared. L’adresse réelle du visiteur se trouve dans l’en-têteCF-Connecting-IP. - La taille des requêtes dépend de votre offre Cloudflare : 100 Mo sur les offres Free et Pro.
- Les conditions de Cloudflare encadrent la diffusion de vidéos et de fichiers volumineux sur les offres Free, Pro et Business.
- Un sous-domaine à plusieurs niveaux, comme
a.b.votre-domaine.com, demande un certificat avancé. - Ce guide couvre les applications web. SSH ou d’autres protocoles TCP demandent aussi une configuration côté client.
Mettre à jour
cloudflared installé par paquet se met à jour avec APT, puis le service doit être redémarré. Le trafic en cours est brièvement interrompu :
sudo apt-get update
sudo apt-get install --only-upgrade -y cloudflared
sudo systemctl restart cloudflared
cloudflared --versionSauvegarder et restaurer
Le dossier /etc/cloudflared contient la configuration et le fichier d’identification du tunnel :
sudo tar -czf /root/cloudflared-$(date +%F).tar.gz -C /etc cloudflared
sudo chmod 600 /root/cloudflared-$(date +%F).tar.gzCe fichier d’identification n’expire pas et permet d’exécuter le tunnel : conservez l’archive chiffrée, hors du serveur.
Pour restaurer sur un serveur où cloudflared est installé, en remplaçant AAAA-MM-JJ par sa date :
sudo tar -xzf /root/cloudflared-AAAA-MM-JJ.tar.gz -C /etc
sudo cloudflared service installArrêtez d’abord le tunnel sur l’ancien serveur si vous ne souhaitez pas que les deux reçoivent du trafic.
En cas de problème
Erreur 1033
Cloudflare ne trouve aucune instance active du tunnel. Vérifiez le service et ses journaux :
systemctl status cloudflared --no-pager
sudo journalctl -u cloudflared --no-pager -n 100Si le service fonctionne, contrôlez que le CNAME pointe vers le bon TUNNEL_UUID.cfargotunnel.com.
Erreur 502 et Unable to reach the origin service
Le tunnel est connecté, mais cloudflared ne joint pas l’application. Vérifiez qu’elle fonctionne, puis comparez son port et son protocole à la ligne service :
curl -I http://127.0.0.1:3000ERR_TOO_MANY_REDIRECTS
L’application redirige HTTP vers HTTPS alors que la règle utilise http://. Désactivez cette redirection dans l’application, ou utilisez https:// dans service avec un certificat valide.
x509: certificate signed by unknown authority ou certificate is valid for
Avec une application en HTTPS, cloudflared ne reconnaît pas son certificat. Indiquez l’autorité avec caPool, ou le nom attendu avec originServerName, dans originRequest. N’utilisez noTLSVerify que le temps d’un diagnostic.
remote error: tls: handshake failure
Le nom public n’est pas couvert par un certificat, souvent parce qu’il s’agit d’un sous-domaine à plusieurs niveaux. Utilisez un seul niveau ou commandez un certificat avancé.
Tunnel credentials file ... doesn't exist or is not a file
Le chemin credentials-file est incorrect. Vérifiez qu’il correspond au fichier présent dans /etc/cloudflared :
sudo ls -l /etc/cloudflaredAn A, AAAA, or CNAME record with that host already exists
Le nom est déjà utilisé dans votre zone DNS. Supprimez l’ancien enregistrement dans Cloudflare après avoir vérifié qu’il n’est plus utile, ou choisissez un autre nom. Pour remplacer volontairement l’enregistrement :
sudo cloudflared tunnel route dns --overwrite-dns hms-tunnel app.votre-domaine.comcloudflared service is already installed
Un service existe déjà sur la machine. Ajoutez votre application au tunnel existant, ou désinstallez le service avant de recommencer :
sudo cloudflared service uninstallpossible conflicting configuration
Deux fichiers de configuration existent, souvent /root/.cloudflared/config.yml et /etc/cloudflared/config.yml. Gardez celui de /etc/cloudflared, puis indiquez-le explicitement :
sudo cloudflared --config /etc/cloudflared/config.yml service installLe tunnel ne se connecte pas
cloudflared utilise QUIC en UDP et revient à HTTP/2 en TCP si l’UDP ne passe pas. Le port sortant 7844 doit donc être ouvert. Testez-le depuis le serveur :
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 region1.v2.argotunnel.com 7844
nc -uvz -w 3 region1.v2.argotunnel.com 7844Le test UDP peut réussir même si les paquets sont filtrés : le test TCP est le plus parlant. Si vos règles locales sont correctes et que le port reste bloqué, contactez le support depuis votre espace client.
failed to sufficiently increase receive buffer size
Ce message concerne le tampon UDP de QUIC. Il est généralement sans conséquence et ne demande aucune action.