FR

Applications

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.

10 min de lecture, mis à jour le 18 novembre 2026

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 :

  1. Ajoutez-le depuis le tableau de bord, puis choisissez une offre.
  2. 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.
  3. Désactivez DNSSEC chez votre registrar s’il est actif.
  4. 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 :

Terminal
curl -I http://127.0.0.1:3000
sudo ss -ltnp | grep 3000

L’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 :

Terminal
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 :

Terminal
sudo cloudflared tunnel login

Le certificat du compte est enregistré dans /root/.cloudflared/cert.pem. Créez ensuite le tunnel :

Terminal
sudo cloudflared tunnel create hms-tunnel
sudo cloudflared tunnel list

Notez l’identifiant affiché, appelé ici TUNNEL_UUID. Copiez son fichier d’identification dans le dossier utilisé par le service :

Terminal
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

Terminal
sudo nano /etc/cloudflared/config.yml
YAML
tunnel: 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:404

Les 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 :

Terminal
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 :

  1. Allez dans Zero Trust > Access controls > Applications.
  2. Sélectionnez Create new application, puis Self-hosted and private.
  3. Sélectionnez Add public hostname et indiquez app.votre-domaine.com.
  4. Sous Access policies, créez une politique avec l’action Allow et une règle Include de type Emails, contenant votre adresse.
  5. Choisissez le mode de connexion. Si vous souhaitez recevoir un code par e-mail, ajoutez One-time PIN dans Zero Trust > Integrations > Identity providers.
  6. 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 :

YAML
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:404

TEAM_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 :

Terminal
sudo cloudflared tunnel route dns hms-tunnel app.votre-domaine.com

Si 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

Terminal
sudo cloudflared service install
systemctl status cloudflared --no-pager

La commande crée le service cloudflared, l’active au démarrage et le lance avec /etc/cloudflared/config.yml.

Vérifier le résultat

Terminal
sudo journalctl -u cloudflared --no-pager -n 50 | grep 'Registered tunnel connection'
sudo cloudflared tunnel info hms-tunnel
curl -I https://app.votre-domaine.com

Les 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 :

Terminal
curl -m 5 -I http://VOTRE_IP_SERVEUR:3000

Fermer 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 :

Terminal
sudo ufw status numbered
sudo ufw delete allow 80/tcp
sudo ufw delete allow 443/tcp

Le 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 :

Terminal
sudo shred -u /root/.cloudflared/cert.pem

Il 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 :

YAML
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:404

Validez, créez le nom DNS, puis redémarrez le service :

Terminal
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress validate
sudo cloudflared tunnel route dns hms-tunnel docs.votre-domaine.com
sudo systemctl restart cloudflared

Si 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 :

  1. Allez dans Networking > Tunnels, puis sélectionnez Create a tunnel.
  2. Nommez le tunnel, choisissez votre système et exécutez sur le serveur la commande proposée. Elle contient un jeton secret.
  3. Dans l’onglet Routes, sélectionnez Add route, puis Published application.
  4. 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ête CF-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 :

Terminal
sudo apt-get update
sudo apt-get install --only-upgrade -y cloudflared
sudo systemctl restart cloudflared
cloudflared --version

Sauvegarder et restaurer

Le dossier /etc/cloudflared contient la configuration et le fichier d’identification du tunnel :

Terminal
sudo tar -czf /root/cloudflared-$(date +%F).tar.gz -C /etc cloudflared
sudo chmod 600 /root/cloudflared-$(date +%F).tar.gz

Ce 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 :

Terminal
sudo tar -xzf /root/cloudflared-AAAA-MM-JJ.tar.gz -C /etc
sudo cloudflared service install

Arrê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 :

Terminal
systemctl status cloudflared --no-pager
sudo journalctl -u cloudflared --no-pager -n 100

Si 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 :

Terminal
curl -I http://127.0.0.1:3000

ERR_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 :

Terminal
sudo ls -l /etc/cloudflared

An 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 :

Terminal
sudo cloudflared tunnel route dns --overwrite-dns hms-tunnel app.votre-domaine.com

cloudflared 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 :

Terminal
sudo cloudflared service uninstall

possible 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 :

Terminal
sudo cloudflared --config /etc/cloudflared/config.yml service install

Le 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 :

Terminal
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 region1.v2.argotunnel.com 7844
nc -uvz -w 3 region1.v2.argotunnel.com 7844

Le 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.

Références