SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-10-19

Tailscale serve oder funnel: Was sollten Sie nutzen?

Tailscale serve macht einen lokalen Port nur im Tailnet per HTTPS erreichbar, Funnel im Internet. Erfahren Sie, welche Policy Funnel blockieren kann.

tailscale serve vs funnel: Wer die URL erreichen kann

Der Unterschied zwischen tailscale serve und tailscale funnel betrifft ausschließlich den Empfängerkreis. serve legt einen HTTPS-Front-End vor einen lokalen Port und veröffentlicht ihn nur in Ihrem Tailnet. funnel veröffentlicht denselben lokalen Port über von Tailscale betriebene Relay-Server im gesamten öffentlichen Internet. Beide Befehle verwenden dieselben Flags und dieselben Ziele. Ein einziges Wort entscheidet darüber, ob ein Dashboard privat bleibt oder weltweit erreichbar ist.

Beide stellen Ihnen ein Zertifikat bereit, dem Browser bereits vertrauen, und verwenden dafür einen Namen mit der Endung ts.net. Bei keinem der beiden Befehle muss an der Firewall Ihres VPS ein eingehender Port geöffnet werden. Ihr tailscaled-Daemon verfügt bereits über eine ausgehende Verbindung zum Tailnet. Der Netzwerkverkehr trifft daher darüber ein. Einen Server in das Tailnet aufzunehmen, ist eine eigene Aufgabe. Einen VPS als Tailscale-Exit-Node zu betreiben oder einen Subnet-Router für ein privates Netzwerk anzukündigen deckt diesen Bereich ab. Hier geht es darum, einen Dienst zu veröffentlichen, der sich bereits im Tailnet befindet.

Was Sie benötigen, bevor einer der beiden Befehle funktioniert

  • Tailscale 1.52 oder neuer auf dem VPS, beim Tailnet angemeldet. Funnel gibt es bereits seit 1.38.3. Die Befehle serve und funnel wurden jedoch in 1.52 geändert. Alle Befehle auf dieser Seite verwenden die neuere Syntax. Prüfen Sie dies mit tailscale version und tailscale status.
  • MagicDNS muss aktiviert sein. MagicDNS ist das integrierte DNS (Domain Name System) von Tailscale. Dadurch erhält die Maschine einen Namen wie blog-vps.your-tailnet.ts.net und nicht nur eine 100.x-Adresse.
  • HTTPS-Zertifikate müssen im Tailnet auf der DNS-Seite der Administrationskonsole aktiviert sein. Andernfalls gibt es kein Zertifikat, das vor Ihrem Port verwendet werden kann.
  • Nur für funnel benötigen Sie das Knotenattribut funnel in der Tailnet-Richtliniendatei. Daran scheitern die meisten ersten Versuche. Dieser Punkt wird weiter unten behandelt.

Jeder Befehl hier beginnt mit sudo, weil tailscaled normalerweise als root ausgeführt wird und standardmäßig nur root diese Verwaltung durchführen darf. Sie können einem Benutzer das Überspringen dieses Präfixes erlauben, indem Sie ihn zum Operator machen:

sudo tailscale set --operator=$USER

Veröffentlichung im Tailnet mit tailscale serve

Verweisen Sie serve auf einen lokalen Port und der Rest geschieht automatisch.

sudo tailscale serve 3000
Available within your tailnet:
https://amelie-workstation.pango-lin.ts.net

 |-- / proxy http://127.0.0.1:3000

Press Ctrl+C to exit.

Das bloße 3000 ist eine Kurzform für http://127.0.0.1:3000. Tailscale lauscht auf Port 443 der Tailnet-Adresse des Geräts, terminiert TLS (Transport Layer Security) mit dem ts.net-Zertifikat und leitet einfaches HTTP an Ihren lokalen Port weiter. Ihre Anwendung muss nicht wissen, dass ein Zertifikat existiert. Dies ist der Hauptgrund, diese Methode vor einem Admin-Panel einzusetzen, das Sie ansonsten über unverschlüsseltes HTTP betreiben würden. Eine Web-UI, die nur an 127.0.0.1 bindet, ist ein offensichtlicher Kandidat. Die dsh Web-UI auf Port 3080 ist ein gutes Beispiel: Anstatt jedes Mal einen SSH-Tunnel zu öffnen, wenn Sie darauf zugreifen möchten, verweisen Sie einmalig serve auf 3080 und erreichen sie von jedem Gerät im Tailnet aus.

Lesen Sie nun die letzte Zeile: Press Ctrl+C to exit. Der Befehl läuft im Vordergrund und die Zuordnung existiert innerhalb dieses Prozesses. Schließen Sie das Terminal, funktioniert die URL nicht mehr, da nichts auf die Festplatte geschrieben wurde. Fügen Sie --bg hinzu, wird die Zuordnung in die Serve-Konfiguration des Knotens übernommen, welche sowohl das Schließen des Terminals als auch einen Neustart überdauert.

sudo tailscale serve --bg 3000

Serve akzeptiert mehr als nur eine Portnummer. --set-path bindet einen Dienst unter einem Unterpfad ein, sodass sich mehrere Anwendungen einen Hostnamen teilen können:

sudo tailscale serve --bg --set-path=/grafana 3000
sudo tailscale serve --bg --set-path=/metrics 9090

Ein Ziel kann auch ein Verzeichnis mit statischen Dateien sein oder ein Backend, das bereits TLS mit einem Zertifikat spricht, das Sie nicht überprüfen möchten:

sudo tailscale serve --bg /srv/reports
sudo tailscale serve --bg https+insecure://localhost:8443

Es ist zudem nicht auf HTTP beschränkt. --tcp=<port> leitet einen raw TCP (Transmission Control Protocol) Stream weiter und --tls-terminated-tcp=<port> terminiert TLS an Ihrem Knoten und leitet den Klartext weiter, wodurch ein vertrauenswürdiges Zertifikat vor einen Dienst geschaltet wird, der kein HTTP spricht:

sudo tailscale serve --bg --tls-terminated-tcp=443 tcp://127.0.0.1:9899

Warum meldet funnel, dass das Node-Attribut nicht gesetzt ist?

funnel ist standardmäßig für ein gesamtes tailnet deaktiviert. Beim ersten Aufruf wird diese Meldung ausgegeben und der Vorgang beendet:

Funnel not available; "funnel" node attribute not set. See https://tailscale.com/s/no-funnel.

Der Befehl war korrekt. Die Tailnet-Richtlinie hat diesem Node nicht die Berechtigung zum Veröffentlichen erteilt. Daher beendet der Client den Vorgang, bevor er überhaupt einen Relay kontaktiert. Bearbeiten Sie die Tailnet-Richtliniendatei in der Administrationskonsole unter Access Controls und fügen Sie das Attribut hinzu:

"nodeAttrs": [
  {
    "target": ["autogroup:member"],
    "attr":   ["funnel"],
  },
],

autogroup:member erteilt es jedem Mitglied des tailnet. Wenn nur eine Maschine veröffentlichen soll, versehen Sie diese Maschine mit einem Tag und verwenden Sie stattdessen das Tag, zum Beispiel tag:public. Speichern Sie die Richtlinie und führen Sie den funnel-Befehl erneut aus.

Wenn Ihr Konto die Tailnet-Richtlinie bearbeiten kann (mit der Rolle Owner, Admin oder Network admin), bieten aktuelle Clients eine Abkürzung: Die CLI gibt eine URL zu einer Genehmigungsseite aus. Nach der Genehmigung erstellt der Client die HTTPS-Zertifikate und fügt das Attribut automatisch hinzu. Wenn Sie keine dieser Rollen haben, hilft Ihnen die URL nicht. Eine Person mit Zugriff auf die Richtlinie muss die Änderung vornehmen.

Mit tailscale funnel im Internet veröffentlichen

Sobald das Attribut gesetzt ist, verwenden Sie den bereits bekannten Befehl mit einem anderen Verb.

sudo tailscale funnel --bg 3000
Available on the internet:
https://amelie-workstation.pango-lin.ts.net

 |-- / proxy http://127.0.0.1:3000

Press Ctrl+C to exit.

Lesen Sie diese erste Zeile jedes Mal genau. Available within your tailnet und Available on the internet sind der einzige sichtbare Unterschied zwischen einem privaten und einem öffentlichen Dienst. Die Befehle, die sie erzeugen, unterscheiden sich durch ein einziges Wort.

Stand Oktober 2026 lauscht funnel auf Port 443, 8443 oder 10000 und auf keinem anderen Port. Der Standardwert ist 443, --https=8443 oder --https=10000 sind die Alternativen. Jeder andere Port wird abgelehnt, weil die funnel-Relays nur Verbindungen auf diesen Ports akzeptieren. Deshalb besteht eine funnel-URL immer nur aus dem Hostnamen oder aus dem Hostnamen mit :8443 oder :10000 am Ende.

Was ist aktuell veröffentlicht?

Raten ist der Grund, warum ein Dashboard einen Monat lang öffentlich bleibt. Fragen Sie stattdessen den Node.

tailscale serve status
tailscale funnel status
tailscale serve status --json

Beide Statusbefehle lesen dieselbe Konfiguration. Daher zeigt jeder davon das vollständige Bild. Verwenden Sie die Form --json in einem Script oder einem geplanten Check, da die einfache Ausgabe für Menschen formatiert ist. Wenn nichts konfiguriert ist, erhalten Sie eine Zeile:

No serve config

Wenn diese Ausgabe nach einer nachweislich erfolgreichen Einrichtung erscheint, wurde das Mapping im Vordergrund erstellt und der Prozess ist beendet. Erstellen Sie es mit --bg erneut.

Um ein Mapping zu entfernen, wiederholen Sie den Befehl, mit dem es erstellt wurde, und setzen Sie off ans Ende. Um alle serve- und funnel-Mappings auf dem Node zu entfernen, verwenden Sie reset.

sudo tailscale funnel --https=443 3000 off
sudo tailscale serve reset

Führen Sie danach in beiden Fällen erneut tailscale serve status aus und prüfen Sie, was noch vorhanden ist, statt anzunehmen, dass der gewünschte Vorgang ausgeführt wurde.

Was Sie erhalten und worauf Sie verzichten

Die Vorteile sind real. Deshalb entscheiden sich viele dafür statt für einen Reverse Proxy.

  • Ein von Browsern vertrauenswürdiges Zertifikat, das automatisch erneuert wird. Sie müssen keinen ACME-Client (automatic certificate management environment) installieren und keinen Erneuerungsjob einrichten.
  • Kein eingehender Port in der VPS-Firewall. tailscaled baut ausgehende Verbindungen auf. Eine standardmäßig sperrende ufw-Firewall auf Ihrem VPS kann daher unverändert restriktiv bleiben.
  • Kein DNS-Eintrag, den Sie kaufen, setzen oder dessen Wirksamwerden Sie abwarten müssen.
  • Keine Portweiterleitung. Das ist besonders relevant für eine Maschine hinter NAT (network address translation) und nicht für einen VPS mit öffentlicher IP-Adresse.

Die Nachteile sind ebenso real, und Funnel bringt sie alle mit sich.

  • Der Name gehört nicht Ihnen. Öffentliche Besucher sehen host.your-tailnet.ts.net. Funnel unterstützt keine benutzerdefinierten Domains. Sie können daher app.example.com nicht davor schalten.
  • Der Pfad gehört nicht Ihnen. Der Datenverkehr erreicht zuerst ein Tailscale-Relay. Dieses leitet den Stream über das Tailnet zu Ihrem Knoten weiter. Tailscale weist darauf hin, dass für Funnel-Datenverkehr nicht konfigurierbare Bandbreitenbegrenzungen gelten. Die Dokumentation nennt dafür keine konkrete Zahl. Messen Sie daher den eigenen Durchsatz, bevor Sie sich auf einen bestimmten Wert verlassen.
  • Die Steuerungsmöglichkeiten fehlen. Ein von Ihnen betriebener Reverse Proxy bietet Zugriffslogs, Ratenbegrenzungen, Beschränkungen der Anfragegröße und eine Stelle für die Authentifizierung. Funnel stellt Ihnen eine URL bereit. Alles Weitere muss in Ihrer Anwendung umgesetzt werden.
  • Die Portliste ist wie oben beschrieben fest vorgegeben.

Beide Funktionen stützen sich außerdem auf Infrastruktur, die Tailscale betreibt: die Ausstellung von Zertifikaten für den Namen ts.net und die Funnel-Relays selbst. Ob diese Abhängigkeit problematisch ist, hängt davon ab, was diese Server mit Ihrem Datenverkehr tun können und was nicht. Genau das beschreibt das Vertrauensmodell von Tailscale. Die Nutzung beider Funktionen ist kostenlos: Tailscale führt Funnel für alle Tarife als verfügbar auf, und die Dokumentation zu Serve nennt keine Tarifbeschränkung. Außerdem umfasst der kostenlose Tarif bis zu sechs Benutzer mit jeweils unbegrenzt vielen Geräten. Ein siebter Benutzer ist normalerweise der Grund, aus dem ein Tailnet auf einen kostenpflichtigen Tarif wechselt. Einige Funktionen wie die SCIM-Benutzerbereitstellung (system for cross-domain identity management) und Netzwerkflussprotokolle benötigen jedoch unabhängig von der Benutzerzahl einen kostenpflichtigen Tarif. Danach richtet sich die Rechnung nach Benutzern und nicht nach Maschinen. Daher sollten Sie die tatsächlichen Kosten eines Tailnets im kostenpflichtigen Tarif prüfen, bevor Serve oder Funnel zu einer tragenden Abhängigkeit wird. Wenn Sie einen selbst gehosteten Headscale-Steuerserver in Betracht ziehen, sollten Sie nicht davon ausgehen, dass eine der beiden Funktionen mit Ihnen umzieht. Prüfen Sie die Release Notes für die Headscale-Version, die Sie einsetzen möchten.

Welche Variante sollte ich verwenden?

Die Regel ist kurz.

Verwenden Sie serve für alles Interne: Administrationsoberflächen, Dashboards, eine Metrikoberfläche, die nicht indexiert werden soll, oder eine Staging-Kopie einer Website. Die Mitgliedschaft im Tailnet ist die Zugriffskontrolle, und sie ist zuverlässig. Ein Gerät, das sich nicht im Tailnet befindet, kann den Namen nicht einmal auflösen.

Verwenden Sie funnel für einen Demo-Link, einen Webhook-Empfänger, an den ein Dritter per POST senden muss, oder einen OAuth-Callback während der Entwicklung. Damit erhalten Sie am schnellsten eine öffentliche HTTPS-URL, und ein einzelner Befehl mit off beendet sie. Öffentlich bedeutet allerdings öffentlich: Der Hostname ist kein Geheimnis, und ein Funnel vor einer Anwendung ohne Anmeldung stellt einen offenen Dienst bereit. Alles dahinter muss seine Anfragen selbst authentifizieren, mit derselben Sorgfalt, die ein offener Ollama-API-Endpunkt erfordert.

Verwenden Sie für alles, was Sie als Produktion bezeichnen würden, einen echten Reverse Proxy. Ihre Domain, Ihr Zertifikat, Ihre Logs, Ihre Rate-Limits und niemand sonst im Anfragepfad. Nginx, Caddy und Traefik als Reverse Proxy im Vergleich erläutert die Auswahl.

Fehlerbilder und die angezeigten Meldungen

Funnel lässt sich nicht starten. Funnel not available; "funnel" node attribute not set. weist auf ein Richtlinienproblem hin, nicht auf ein Befehlsproblem. Fügen Sie das Attribut funnel zur Tailnet-Richtliniendatei hinzu, speichern Sie die Datei und wiederholen Sie den Versuch.

Es hat funktioniert, und jetzt meldet tailscale serve status No serve config. Das Mapping wurde im Vordergrund erstellt, und dieser Prozess wurde beendet. Führen Sie denselben Befehl erneut mit --bg aus.

Der Name wird aufgelöst, aber niemand antwortet. Serve leitet Anfragen an das von Ihnen angegebene Ziel weiter. Wenn dort nichts lauscht, kann auch nichts weitergeleitet werden. Prüfen Sie dies mit ss -ltnp | grep 3000 auf derselben Maschine, auf der tailscaled ausgeführt wird. Eine häufige Ursache ist ein Container, der seinen Port an einer Docker-Bridge-Adresse statt an 127.0.0.1 veröffentlicht. Dadurch sieht der Host an der erwarteten Stelle keinen Listener. So funktioniert die Netzwerkanbindung in Docker Compose zeigt, wo ein veröffentlichter Port tatsächlich gebunden wird. Wenn die Anwendung bereits in Compose läuft, beseitigt Tailscale als Sidecar in den Stack einzubinden diese Unsicherheit. Der Container erhält dann einen eigenen Tailnet-Namen und veröffentlicht überhaupt keinen Host-Port.

Zertifikatsfehler für den Namen ts.net. Wahrscheinlich sind HTTPS-Zertifikate für das Tailnet nicht aktiviert. Aktivieren Sie sie in der Administrationskonsole. Führen Sie anschließend den Zertifikatsschritt separat aus, damit sich seine Fehlermeldungen nicht mit der Ausgabe von Serve vermischen:

sudo tailscale cert your-host.your-tailnet.ts.net

Funnel wird über mobile Daten geladen, verhält sich aber anders als auf Ihrem Laptop. Ihr Laptop ist mit dem Tailnet verbunden. MagicDNS löst den Namen daher in die 100.x-Adresse auf, und Sie erreichen den Dienst über das Tailnet, ohne ein Funnel-Relay zu verwenden. Das ist das erwartete Verhalten. Ihr Laptop kann die öffentliche Erreichbarkeit daher überhaupt nicht testen. Verwenden Sie curl auf einer Maschine, die nicht mit dem Tailnet verbunden ist.

FAQ

Was ist der Unterschied zwischen tailscale serve und tailscale funnel?

Wer kann das Ergebnis erreichen? tailscale serve veröffentlicht einen lokalen Port unter einer HTTPS-URL, die nur Geräte in Ihrem Tailnet erreichen können. tailscale funnel veröffentlicht denselben Port unter einer URL, die jeder im Internet erreichen kann. Die Verbindung wird über Relay-Server geleitet, die Tailscale betreibt. Die Flags und Ziele sind bei beiden Befehlen gleich. Die erste Ausgabezeile zeigt, welchen Befehl Sie erhalten haben: Available within your tailnet oder Available on the internet.

Warum meldet tailscale funnel, dass das Node-Attribut nicht gesetzt ist?

Weil funnel für ein Tailnet deaktiviert ist, bis es jemand aktiviert. Die Meldung lautet Funnel not available; "funnel" node attribute not set.. Sie stammt von Ihrem eigenen Client, bevor ein Relay kontaktiert wird. Fügen Sie in der Tailnet-Richtliniendatei unter Access Controls einen Eintrag nodeAttrs hinzu, der das Attribut funnel für autogroup:member oder für ein Tag gewährt, wenn nur eine Maschine veröffentlichen soll. Ein Tailnet-Administrator kann stattdessen der vom CLI ausgegebenen Zustimmungs-URL folgen.

Welche Ports kann Tailscale Funnel verwenden?

Nur 443, 8443 und 10000. Der Standardwert ist 443. Einen anderen Port wählen Sie mit --https=8443 oder --https=10000. Dies ist eine Einschränkung der Funnel-Relays und nicht Ihres Servers. Daher hebt weder eine Firewall-Änderung noch eine Konfigurationsänderung auf dem VPS diese Einschränkung auf. Für tailscale serve gilt diese Einschränkung nicht, weil der Datenverkehr Ihr Tailnet nie verlässt.

Bleibt eine serve- oder funnel-URL nach einem Reboot erhalten?

Nur wenn Sie --bg verwendet haben. Ohne diese Option läuft der Befehl im Vordergrund, gibt Press Ctrl+C to exit. aus und die Zuordnung verschwindet zusammen mit dem Prozess. Mit --bg wird die Zuordnung in die Serve-Konfiguration des Nodes geschrieben und kommt nach einem Reboot mit tailscaled wieder. Prüfen Sie dies mit tailscale serve status. Wenn nichts gesetzt ist, gibt der Befehl No serve config aus.

Ist es sicher, einen Funnel laufen zu lassen?

Im Hinblick auf den Transport ist es sicher: Die Verbindung verwendet HTTPS und an Ihrer Firewall wird kein Port geöffnet. Im üblichen Sinn ist es jedoch nicht sicher, weil die URL öffentlich ist und damit auch die dahinterliegende Anwendung öffentlich erreichbar ist. Lassen Sie einen Funnel nur vor einer Anwendung laufen, die ihre Anfragen selbst authentifiziert. Beenden Sie ihn, sobald die Demo oder der Webhook-Test abgeschlossen ist. Verwenden Sie dazu den Befehl, mit dem Sie ihn erstellt haben, und hängen Sie off an.

Quellen zum oben beschriebenen Befehlsverhalten sind die Tailscale-Dokumentation zu Serve und Funnel sowie die CLI-Referenz unter tailscale.com/docs.

War dieser Artikel hilfreich?