Tailscale Serve ou Funnel : lequel choisir ?
Serve reste limité au tailnet, tandis que Funnel expose le port sur Internet. Découvrez la règle ACL qui peut bloquer Funnel et le choix adapté à votre service.
tailscale serve ou funnel : qui peut accéder à l’URL
La différence entre tailscale serve et tailscale funnel concerne uniquement le public. serve place une interface HTTPS (hypertext transfer protocol secure) devant un port local et le publie uniquement sur votre tailnet. funnel publie ce même port local sur l’ensemble de l’Internet public, par l’intermédiaire des serveurs relais gérés par Tailscale. Les deux commandes utilisent les mêmes options et les mêmes cibles. Un seul mot sépare un tableau de bord privé d’un tableau de bord accessible depuis Internet.
Les deux vous fournissent un certificat déjà approuvé par les navigateurs, pour un nom se terminant par ts.net. Aucune des deux solutions ne nécessite l’ouverture d’un port entrant dans le pare-feu de votre VPS. Votre daemon tailscaled maintient déjà une connexion sortante vers le tailnet. Le trafic arrive donc par cette connexion. Ajouter un serveur au tailnet est une tâche distincte. Exécuter un VPS comme nœud de sortie Tailscale ou annoncer un routeur de sous-réseau pour un réseau privé couvre ce sujet. Cette section concerne la publication d’un service déjà présent sur le tailnet.
Ce qu’il faut avant d’exécuter l’une ou l’autre commande
- Tailscale 1.38.3 ou une version ultérieure sur le VPS, connecté à votre tailnet. Vérifiez avec
tailscale versionettailscale status. - MagicDNS activé. MagicDNS est le DNS (Domain Name System) intégré à Tailscale. Il attribue à la machine un nom tel que
blog-vps.your-tailnet.ts.netau lieu d’une simple adresse100.x. - Les certificats HTTPS activés pour le tailnet, dans la page DNS de la console d’administration. Sans cela, vous n’avez aucun certificat à placer devant votre port.
- Uniquement pour
funnel, l’attribut de nœudfunneldans le fichier de stratégie du tailnet. C’est généralement à cette étape que les premières tentatives échouent. La procédure est détaillée ci-dessous.
Toutes les commandes de cette page commencent par sudo, car la CLI communique avec tailscaled via un socket sur lequel seul root peut écrire. Pour autoriser un utilisateur à s’en passer :
sudo tailscale set --operator=$USERPublier sur votre tailnet avec tailscale serve
Pointez serve vers un port local et tailscale serve s’occupe du reste.
sudo tailscale serve 3000Available within your tailnet:
https://amelie-workstation.pango-lin.ts.net
|-- / proxy http://127.0.0.1:3000
Press Ctrl+C to exit.La commande simple 3000 est un raccourci pour http://127.0.0.1:3000. Tailscale écoute sur le port 443 de l’adresse tailnet de la machine, termine TLS (transport layer security) avec le certificat ts.net, puis transmet les requêtes HTTP en clair vers votre port local. Votre application n’a jamais besoin de savoir qu’un certificat existe. C’est la principale raison d’utiliser cette configuration devant un panneau d’administration que vous laisseriez sinon en HTTP simple. Une interface web liée uniquement à 127.0.0.1 est une candidate évidente. L’interface web dsh sur le port 3080 en est un bon exemple : au lieu d’ouvrir un tunnel SSH à chaque utilisation, pointez serve vers 3080 une seule fois et accédez-y depuis n’importe quel appareil du tailnet.
Lisez maintenant la dernière ligne : Press Ctrl+C to exit. La commande s’exécute au premier plan et le mappage reste associé à ce processus. Fermez le terminal et l’URL cesse de fonctionner, car rien n’a été écrit sur disque. Ajoutez --bg pour enregistrer le mappage dans la configuration serve du nœud. Celle-ci survit à la fermeture du terminal et au redémarrage.
sudo tailscale serve --bg 3000Serve accepte autre chose qu’un numéro de port. --set-path monte un service sous un sous-chemin, afin que plusieurs applications puissent partager un même nom d’hôte :
sudo tailscale serve --bg --set-path=/grafana 3000
sudo tailscale serve --bg --set-path=/metrics 9090La cible peut également être un répertoire contenant des fichiers statiques ou un backend qui utilise déjà TLS avec un certificat dont vous ne voulez pas vérifier la validité :
sudo tailscale serve --bg /srv/reports
sudo tailscale serve --bg https+insecure://localhost:8443L’interface web de Proxmox sur le port 8006, avec son certificat autosigné, est l’exemple typique de cible https+insecure, mais localhost ne la désigne que si Tailscale tourne sur l’hôte lui-même : installer Tailscale sur l’hôte Proxmox, dans un conteneur LXC ou dans une VM ne donne pas accès aux mêmes cibles.
La commande ne se limite pas non plus à HTTP. --tcp=<port> transmet un flux TCP (transmission control protocol) brut. --tls-terminated-tcp=<port> termine TLS sur votre nœud et transmet ensuite le flux en clair. Vous pouvez ainsi placer un certificat de confiance devant un service qui ne parle pas du tout HTTP :
sudo tailscale serve --bg --tls-terminated-tcp=443 tcp://127.0.0.1:9899Pourquoi funnel indique-t-il que l’attribut du nœud n’est pas défini ?
Funnel est désactivé par défaut pour l’ensemble d’un tailnet. La première exécution affiche ce message, puis s’arrête :
Funnel not available; "funnel" node attribute not set. See https://tailscale.com/s/no-funnel.La commande était correcte. La policy du tailnet n’a pas autorisé ce nœud à publier, donc le client refuse la demande avant même de contacter un relay. Modifiez le fichier de policy du tailnet dans la console d’administration, sous Access Controls, puis ajoutez l’attribut :
"nodeAttrs": [
{
"target": ["autogroup:member"],
"attr": ["funnel"],
},
],autogroup:member l’accorde à tous les membres du tailnet. Si une seule machine doit pouvoir publier, attribuez un tag à cette machine et ciblez plutôt ce tag, par exemple tag:public. Enregistrez la policy, puis exécutez à nouveau la commande funnel.
Si votre compte peut modifier la policy du tailnet (rôle Owner, Admin ou Network admin), les clients récents proposent un raccourci : la CLI affiche l’URL d’une page d’approbation. Son approbation crée les certificats HTTPS et ajoute l’attribut pour vous. Si vous ne disposez d’aucun de ces rôles, cette URL ne vous aidera pas. Une personne ayant accès à la policy doit effectuer la modification.
Publier sur Internet avec tailscale funnel
Une fois l’attribut défini, la commande est celle que vous connaissez déjà, avec un verbe différent.
sudo tailscale funnel --bg 3000Available on the internet:
https://amelie-workstation.pango-lin.ts.net
|-- / proxy http://127.0.0.1:3000
Press Ctrl+C to exit.Lisez toujours cette première ligne. Available within your tailnet et Available on the internet sont les seules différences visibles entre un service privé et un service public, et les commandes qui les produisent ne diffèrent que d’un mot.
En octobre 2026, funnel écoute sur le port 443, 8443 ou 10000, et sur aucun autre. Le port par défaut est 443 ; --https=8443 ou --https=10000 sont les alternatives. Tout autre port est refusé, car les relays funnel acceptent uniquement les connexions sur ces ports. C’est pourquoi une URL funnel contient toujours le nom d’hôte seul, ou le nom d’hôte suivi de :8443 ou :10000.
Comment voir ce qui est publié actuellement ?
Les suppositions peuvent laisser un dashboard public pendant un mois. Interrogez plutôt le nœud.
tailscale serve status
tailscale funnel status
tailscale serve status --jsonLes deux commandes d’état lisent la même configuration. L’une ou l’autre affiche donc une vue complète. Utilisez la forme --json dans un script ou un contrôle planifié, car la sortie standard est destinée aux utilisateurs. Lorsqu’aucun élément n’est configuré, vous obtenez une seule ligne :
No serve configSi cette sortie apparaît après une configuration qui fonctionnait, le mapping a été créé au premier plan et le processus a disparu. Recréez-le avec --bg.
Pour supprimer un mapping, répétez la commande qui l’a créé et ajoutez off à la fin. Pour supprimer tous les mappings serve et funnel du nœud, utilisez reset.
sudo tailscale funnel --https=443 3000 off
sudo tailscale serve resetExécutez de nouveau tailscale serve status après l’une ou l’autre opération et vérifiez ce qui reste, au lieu de supposer que la commande a fait ce que vous vouliez.
Ce que vous obtenez et ce à quoi vous renoncez
Les avantages sont réels. C’est pourquoi certains choisissent cette solution plutôt qu’un reverse proxy.
- Un certificat reconnu par les navigateurs, renouvelé automatiquement. Aucun client ACME (automatic certificate management environment) à installer et aucune tâche de renouvellement à ne pas oublier.
- Aucun port entrant dans le firewall du VPS.
tailscaledétablit une connexion sortante ; un firewall ufw en deny par défaut sur votre VPS peut donc rester aussi restrictif qu’avant. - Aucun enregistrement DNS à acheter, à configurer ou dont il faut attendre la propagation.
- Aucun port forwarding. C’est le principal avantage sur une machine derrière un NAT (network address translation), plutôt que sur un VPS doté d’une IP publique.
Les inconvénients sont tout aussi réels, et funnel les entraîne tous.
- Le nom ne vous appartient pas. Les visiteurs voient
host.your-tailnet.ts.net. Funnel ne prend pas en charge les domaines personnalisés ; vous ne pouvez donc pas placerapp.example.comdevant ce nom. - Le chemin réseau ne vous appartient pas. Le trafic atteint d’abord un relay Tailscale, qui relaie le flux vers votre nœud sur le tailnet. Tailscale indique que le trafic funnel est soumis à des limites de bande passante configurables, sans en préciser la valeur dans sa documentation. Mesurez donc votre propre débit avant de dépendre d’un chiffre.
- Les contrôles habituels manquent. Un reverse proxy que vous administrez vous donne accès aux logs d’accès, aux limites de débit, aux limites de taille des requêtes et à un emplacement pour l’authentification. Funnel vous donne une URL. Tout le reste doit être géré par votre application.
- La liste des ports est fixe, comme indiqué plus haut.
Les deux fonctionnalités dépendent également de l’infrastructure exploitée par Tailscale : l’émission du certificat pour le nom ts.net et les relays funnel eux-mêmes. L’importance de cette dépendance dépend de ce que ces serveurs peuvent ou ne peuvent pas faire avec votre trafic. C’est précisément ce que décrit le modèle de confiance de Tailscale. Aucune des deux fonctionnalités n’est payante, car le plan gratuit couvre jusqu’à six utilisateurs avec un nombre illimité d’appareils par utilisateur. C’est le nombre de sièges, et non la liste des fonctionnalités, qui finit par faire passer un tailnet à un plan payant. Ensuite, la facture dépend des utilisateurs plutôt que des machines. Il est donc utile de vérifier le coût réel d’un tailnet avec un plan payant avant que serve ou funnel ne devienne indispensable. Si vous envisagez un serveur de contrôle Headscale auto-hébergé, ne supposez pas que ces fonctionnalités vous suivent. Consultez les notes de version de la version de Headscale que vous prévoyez d’utiliser.
Lequel choisir ?
La règle est simple.
Utilisez serve pour tout ce qui est interne : interfaces d’administration, tableaux de bord, interface de métriques que vous ne voulez pas faire indexer, copie de préproduction d’un site. L’appartenance au tailnet sert de contrôle d’accès, et c’est un contrôle efficace. Un appareil qui n’est pas sur le tailnet ne peut même pas résoudre le nom.
Utilisez funnel pour un lien de démonstration, un récepteur de webhook auquel un tiers doit envoyer une requête POST, ou un callback OAuth pendant le développement. C’est le moyen le plus rapide d’obtenir une URL HTTPS publique, et une commande off suffit à l’arrêter. Public signifie public : le hostname n’est pas un secret, et un funnel placé devant une application sans authentification expose un service ouvert. Le service situé derrière doit authentifier lui-même ses requêtes, avec la même rigueur que celle requise par un endpoint d’API Ollama exposé.
Utilisez un véritable reverse proxy pour tout ce que vous considérez comme de la production. Votre domaine, votre certificat, vos journaux, vos limites de débit, et aucun autre intervenant dans le chemin des requêtes. Comparatif de nginx, Caddy et Traefik comme reverse proxy explique comment faire votre choix.
Modes de panne et messages affichés
Funnel refuse de démarrer. Funnel not available; "funnel" node attribute not set. indique un problème de policy, pas un problème de commande. Ajoutez l’attribut funnel au fichier de policy du tailnet, enregistrez-le, puis réessayez.
La commande fonctionnait, mais tailscale serve status indique maintenant No serve config. Le mapping a été créé au premier plan, puis le processus s’est terminé. Relancez la même commande avec --bg.
Le nom est résolu, mais aucune réponse n’arrive. Serve fait proxy vers la cible indiquée. Si aucun service n’écoute à cette adresse, il n’y a donc rien à proxifier. Vérifiez avec ss -ltnp | grep 3000 sur la même machine que celle qui exécute tailscaled. La cause fréquente est un conteneur qui publie son port sur une adresse de bridge Docker au lieu de 127.0.0.1. Le host ne voit alors aucun service en écoute à l’endroit attendu. Fonctionnement du réseau Docker Compose explique où un port publié est réellement attaché. Si l’application s’exécute déjà dans Compose, ajouter Tailscale à la stack comme sidecar supprime cette incertitude, car le conteneur obtient son propre nom dans le tailnet et ne publie aucun port sur le host.
Erreurs de certificat sur le nom ts.net. Les certificats HTTPS ne sont probablement pas activés pour le tailnet. Activez-les dans la console d’administration, puis exécutez séparément l’étape de génération du certificat afin que ses erreurs ne soient pas mélangées à la sortie de serve :
sudo tailscale cert your-host.your-tailnet.ts.netFunnel se charge en données mobiles, mais se comporte différemment depuis votre laptop. Votre laptop est connecté au tailnet. MagicDNS résout donc le nom vers l’adresse 100.x, et vous accédez directement au service sans passer par un relay. Ce comportement est normal. Votre laptop ne peut donc pas tester l’accessibilité publique. Utilisez curl depuis une machine qui n’est pas connectée au tailnet.
FAQ
Quelle est la différence entre tailscale serve et tailscale funnel ?
Qui peut accéder au résultat. tailscale serve publie un port local à une URL HTTPS accessible uniquement par les appareils de votre tailnet. tailscale funnel publie le même port à une URL accessible par n’importe qui sur Internet, via les serveurs relais gérés par Tailscale. Les options et les cibles sont communes aux deux commandes. La première ligne de sortie indique le mode utilisé : Available within your tailnet ou Available on the internet.
Pourquoi tailscale funnel indique-t-il que l’attribut du nœud n’est pas défini ?
Parce que funnel est désactivé pour un tailnet tant qu’un administrateur ne l’a pas activé. Le message est Funnel not available; "funnel" node attribute not set. et provient de votre propre client, avant toute connexion à un relais. Ajoutez une entrée nodeAttrs qui accorde l’attribut funnel à autogroup:member, ou à un tag si une seule machine doit publier un service, dans le fichier de stratégie du tailnet, sous Access Controls. Un administrateur du tailnet peut aussi suivre l’URL de consentement affichée par la CLI.
Quels ports Tailscale Funnel peut-il utiliser ?
Uniquement 443, 8443 et 10000. La valeur par défaut est 443 ; vous pouvez en choisir une autre avec --https=8443 ou --https=10000. Cette limite concerne les relais funnel, pas votre serveur. Aucun changement de pare-feu ou de configuration sur le VPS ne permet donc de la contourner. tailscale serve n’est soumis à aucune restriction de ce type, car le trafic ne quitte jamais votre tailnet.
Une URL serve ou funnel reste-t-elle disponible après un redémarrage ?
Uniquement si vous avez utilisé --bg. Sans cette option, la commande s’exécute au premier plan, affiche Press Ctrl+C to exit., puis la configuration disparaît avec le processus. Avec --bg, la configuration est enregistrée dans la configuration serve du nœud et est restaurée par tailscaled après un redémarrage. Vérifiez son état avec tailscale serve status ; la commande affiche No serve config lorsqu’aucune configuration n’est définie.
Est-il sûr de laisser un funnel actif ?
C’est sûr du point de vue du transport : la connexion utilise HTTPS et aucun port n’est ouvert sur votre pare-feu. Ce n’est pas sûr au sens habituel, car l’URL est publique et l’application placée derrière l’URL l’est donc également. N’activez un funnel que devant une application qui authentifie elle-même ses requêtes. Désactivez-le lorsque la démonstration ou le test du webhook est terminé, en ajoutant off à la commande qui l’a créé.
Sources concernant le comportement des commandes ci-dessus : la documentation et la référence CLI de Tailscale Serve et Funnel sur tailscale.com/docs.