Tailscale serve a funnel: różnice i zastosowanie
Poznaj kluczowe różnice między poleceniami tailscale serve oraz tailscale funnel. Dowiedz się, kiedy udostępnić usługę wewnątrz sieci tailnet, a kiedy w publicznym internecie.
tailscale serve a funnel: kto ma dostęp do adresu URL
Różnica między tailscale serve a tailscale funnel sprowadza się wyłącznie do grupy odbiorców. serve uruchamia interfejs HTTPS (hypertext transfer protocol secure) na lokalnym porcie i udostępnia go wyłącznie wewnątrz sieci tailnet. funnel udostępnia ten sam lokalny port całemu publicznemu internetowi za pośrednictwem serwerów przekaźnikowych obsługiwanych przez Tailscale. Oba polecenia przyjmują te same flagi i cele. Jedno słowo decyduje o tym, czy panel sterowania pozostanie prywatny, czy będzie dostępny dla każdego.
Oba polecenia zapewniają certyfikat zaufany przez przeglądarki, przypisany do nazwy kończącej się na ts.net, i żadne z nich nie wymaga otwierania portów przychodzących na firewallu VPS. Demon tailscaled utrzymuje aktywne połączenie z siecią tailnet, przez które przesyłany jest ruch. Podłączenie serwera do sieci tailnet to jedno zadanie, które opisano w sekcjach uruchamianie VPS jako węzła wyjściowego Tailscale oraz konfiguracja routera podsieci dla sieci prywatnej. Niniejsza sekcja dotyczy publikowania usługi, która już znajduje się wewnątrz sieci tailnet.
Wymagania wstępne przed uruchomieniem poleceń
- Tailscale w wersji 1.52 lub nowszej na serwerze VPS, zalogowany do sieci tailnet. Funkcja Funnel została wprowadzona w wersji 1.38.3, jednak polecenia serve oraz funnel uległy zmianie w wersji 1.52, a wszystkie polecenia na tej stronie korzystają z nowej składni. Wersję można sprawdzić za pomocą
tailscale versionoraztailscale status. - Włączona usługa MagicDNS. MagicDNS to wbudowany w Tailscale system DNS (domain name system), który nadaje maszynie nazwę taką jak
blog-vps.your-tailnet.ts.netzamiast korzystania wyłącznie z adresu100.x. - Włączone certyfikaty HTTPS dla sieci tailnet w sekcji DNS konsoli administracyjnej. Bez tego nie będzie dostępny certyfikat, który można przypisać do portu.
- Wyłącznie w przypadku
funnel, wymagany jest atrybut węzłafunnelw pliku polityki sieci tailnet. To etap, na którym kończy się większość pierwszych prób konfiguracji; szczegóły opisano poniżej.
Każde polecenie w tym miejscu rozpoczyna się od sudo, ponieważ tailscaled zazwyczaj działa z uprawnieniami roota i domyślnie tylko root może nim zarządzać. Można przyznać jednemu użytkownikowi prawo do pominięcia tego wymogu, ustanawiając go operatorem:
sudo tailscale set --operator=$USERPublikacja w sieci tailnet za pomocą tailscale serve
Wskaż serve na lokalny port, a resztą zajmie się narzędzie.
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.Samo 3000 to skrót od http://127.0.0.1:3000. Tailscale nasłuchuje na porcie 443 adresu urządzenia w sieci tailnet, kończy połączenie TLS (transport layer security) certyfikatem ts.net i przekazuje zwykły ruch HTTP na wskazany port lokalny. Aplikacja nie musi posiadać wiedzy o istnieniu certyfikatu, co stanowi główny powód stosowania tego rozwiązania dla paneli administracyjnych, które w innym przypadku działałyby przez niezaszyfrowany protokół HTTP. Interfejs webowy powiązany wyłącznie z 127.0.0.1 jest oczywistym kandydatem, a interfejs webowy dsh na porcie 3080 stanowi dobry przykład: zamiast każdorazowo otwierać tunel SSH, wystarczy raz wskazać serve na port 3080, aby uzyskać dostęp z dowolnego urządzenia w sieci tailnet.
Należy zwrócić uwagę na ostatnią linię: Press Ctrl+C to exit.. Polecenie uruchamia się na pierwszym planie, a mapowanie istnieje tylko w ramach tego procesu. Zamknięcie terminala powoduje przerwanie działania, ponieważ konfiguracja nie została zapisana na dysku. Dodanie flagi --bg sprawia, że mapowanie trafia do konfiguracji serwera węzła, która jest zachowywana po zamknięciu terminala oraz po restarcie systemu.
sudo tailscale serve --bg 3000Polecenie serve obsługuje więcej niż tylko numer portu. --set-path montuje usługę w podkatalogu, dzięki czemu wiele aplikacji może współdzielić jedną nazwę hosta:
sudo tailscale serve --bg --set-path=/grafana 3000
sudo tailscale serve --bg --set-path=/metrics 9090Celem może być również katalog plików statycznych lub backend, który obsługuje już TLS za pomocą certyfikatu, którego weryfikacja nie jest wymagana:
sudo tailscale serve --bg /srv/reports
sudo tailscale serve --bg https+insecure://localhost:8443Narzędzie nie ogranicza się wyłącznie do HTTP. --tcp=<port> przekazuje surowy strumień TCP (transmission control protocol), a --tls-terminated-tcp=<port> kończy połączenie TLS na węźle i przesyła czysty tekst dalej, co pozwala na umieszczenie zaufanego certyfikatu przed usługą, która w ogóle nie obsługuje protokołu HTTP:
sudo tailscale serve --bg --tls-terminated-tcp=443 tcp://127.0.0.1:9899Dlaczego funnel zgłasza, że atrybut węzła nie jest ustawiony?
Funkcja funnel jest domyślnie wyłączona dla całej sieci tailnet. Pierwsze uruchomienie kończy się wyświetleniem tego komunikatu i zatrzymaniem działania:
Funnel not available; "funnel" node attribute not set. See https://tailscale.com/s/no-funnel.Polecenie było poprawne. Polityka sieci tailnet nie nadała temu węzłowi uprawnień do publikowania, więc klient odmawia wykonania operacji, zanim jeszcze nawiąże kontakt z przekaźnikiem. Należy edytować plik polityki tailnet w konsoli administracyjnej, w sekcji Access Controls, i dodać atrybut:
"nodeAttrs": [
{
"target": ["autogroup:member"],
"attr": ["funnel"],
},
],autogroup:member przyznaje to uprawnienie każdemu członkowi sieci tailnet. Jeśli tylko jedna maszyna powinna mieć możliwość publikowania, należy otagować tę maszynę i wskazać dany tag, na przykład tag:public. Po zapisaniu polityki należy ponownie uruchomić polecenie funnel.
Jeśli konto posiada uprawnienia do edycji polityki tailnet (rola Owner, Admin lub Network admin), nowsze wersje klientów oferują skrót: interfejs CLI wyświetla adres URL prowadzący do strony zatwierdzania. Zatwierdzenie operacji powoduje wygenerowanie certyfikatów HTTPS i automatyczne dodanie atrybutu. Jeśli użytkownik nie posiada jednej z tych ról, wspomniany adres URL nie będzie użyteczny. Edycji musi dokonać osoba posiadająca odpowiednie uprawnienia do zarządzania polityką.
Publikowanie w Internecie za pomocą Tailscale Funnel
Po ustawieniu atrybutu używa się znanego już polecenia z innym czasownikiem.
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.Należy każdorazowo czytać pierwszy wiersz. Available within your tailnet oraz Available on the internet to jedyne widoczne różnice między usługą prywatną a publiczną, a polecenia generujące je różnią się jednym słowem.
Według stanu na październik 2026, funnel nasłuchuje wyłącznie na portach 443, 8443 lub 10000. Wartością domyślną jest 443, a --https=8443 lub --https=10000 stanowią alternatywy. Każdy inny port jest odrzucany, ponieważ przekaźniki funnel akceptują połączenia tylko na wymienionych portach. Z tego powodu adres URL typu funnel to zawsze sama nazwa hosta lub nazwa hosta z doklejonym :8443 bądź :10000 na końcu.
Jak sprawdzić, co jest aktualnie opublikowane?
Zgadywanie to najczęstsza przyczyna pozostawienia panelu sterowania publicznie dostępnym przez miesiąc. Należy zapytać o to sam węzeł.
tailscale serve status
tailscale funnel status
tailscale serve status --jsonOba polecenia statusu odczytują tę samą konfigurację, więc każde z nich przedstawia pełny obraz sytuacji. W skryptach lub zaplanowanych zadaniach należy używać formy --json, ponieważ zwykłe wyjście jest przeznaczone dla ludzi. Jeśli nic nie zostało skonfigurowane, wyświetlona zostanie tylko jedna linia:
No serve configJeśli taki komunikat pojawia się po konfiguracji, która wcześniej działała, oznacza to, że mapowanie zostało utworzone w pierwszym planie, a proces został zakończony. Należy utworzyć je ponownie za pomocą --bg.
Aby usunąć pojedyncze mapowanie, należy powtórzyć polecenie, które je utworzyło, dodając na końcu off. Aby usunąć wszystkie mapowania typu serve oraz funnel na węźle, należy użyć reset.
sudo tailscale funnel --https=443 3000 off
sudo tailscale serve resetPo wykonaniu którejkolwiek z tych operacji należy ponownie uruchomić tailscale serve status i sprawdzić stan faktyczny, zamiast zakładać, że polecenie wykonało zamierzone działanie.
Zyski i straty
Zyski są wymierne i stanowią powód, dla którego wybiera się to rozwiązanie zamiast reverse proxy.
- Certyfikat zaufany przez przeglądarki, odnawiany automatycznie. Brak klienta ACME (automatic certificate management environment) do instalacji i brak zadań odnawiania, o których można zapomnieć.
- Brak otwartych portów przychodzących na firewallu VPS.
tailscaledinicjuje połączenia wychodzące, więc domyślna polityka deny na firewallu ufw na VPS może pozostać równie restrykcyjna, jak dotychczas. - Brak konieczności zakupu, kierowania czy oczekiwania na propagację rekordów DNS.
- Brak konieczności przekierowywania portów, co jest kluczowe w przypadku maszyn za NAT (network address translation), w przeciwieństwie do VPS z publicznym adresem IP.
Koszty są równie realne, a wszystkie wynikają ze specyfiki funnel.
- Nazwa nie należy do użytkownika. Publiczni odwiedzający widzą
host.your-tailnet.ts.net. Funnel nie wspiera własnych domen, więc nie można umieścićapp.example.comprzed tym adresem. - Ścieżka nie należy do użytkownika. Ruch najpierw trafia do przekaźnika Tailscale, który przekazuje strumień do węzła przez tailnet. Tailscale informuje, że ruch funnel podlega limitom przepustowości, których nie można konfigurować, a dokumentacja nie podaje konkretnych wartości. Należy samodzielnie zmierzyć przepustowość przed oparciem na niej jakichkolwiek założeń.
- Brak kontroli. Własny reverse proxy zapewnia logi dostępu, limity zapytań, ograniczenia rozmiaru żądań oraz miejsce na implementację uwierzytelniania. Funnel dostarcza jedynie URL. Cała reszta musi zostać obsłużona wewnątrz aplikacji.
- Lista portów jest sztywno określona, jak wspomniano powyżej.
Obie funkcje opierają się na infrastrukturze zarządzanej przez Tailscale: wystawianiu certyfikatów dla nazwy ts.net oraz samych przekaźnikach funnel. Decyzja, czy ta zależność jest akceptowalna, zależy od tego, co te serwery mogą zrobić z ruchem, co szczegółowo opisuje model zaufania Tailscale. Korzystanie z obu funkcji jest bezpłatne: Tailscale udostępnia Funnel w każdym planie, dokumentacja Serve nie wspomina o ograniczeniach planów, a plan darmowy obejmuje do sześciu użytkowników z nieograniczoną liczbą urządzeń. Siódmy użytkownik jest zazwyczaj powodem przejścia tailnetu na plan płatny, choć niektóre funkcje, takie jak SCIM (system for cross-domain identity management) czy logi przepływu sieciowego, wymagają go niezależnie od liczby użytkowników. Powyżej tego punktu opłaty zależą od liczby użytkowników, a nie maszyn, dlatego warto sprawdzić koszty płatnego planu tailnetu, zanim serve lub funnel staną się krytycznymi elementami infrastruktury. W przypadku rozważania samodzielnie hostowanego serwera kontrolnego Headscale, nie należy zakładać, że obie funkcje będą dostępne. Należy sprawdzić informacje o wydaniu (release notes) dla wersji Headscale, która ma zostać uruchomiona.
Które rozwiązanie wybrać?
Zasada jest krótka.
Użyj serve do wszystkiego, co wewnętrzne: interfejsów administracyjnych, paneli nawigacyjnych, interfejsów metryk, których nie chcesz indeksować, lub kopii testowej witryny. Przynależność do sieci tailnet stanowi kontrolę dostępu i jest to rozwiązanie skuteczne. Urządzenie niebędące w sieci tailnet nie jest nawet w stanie rozwiązać nazwy hosta.
Użyj funnel dla linku demonstracyjnego, odbiornika webhook, do którego strona trzecia musi wysłać żądanie POST, lub wywołania zwrotnego OAuth podczas programowania. Jest to najszybsza droga do uzyskania publicznego adresu URL HTTPS, a jedno polecenie off kończy jego działanie. Należy jednak pamiętać, że publiczny oznacza publiczny: nazwa hosta nie jest tajemnicą, a tunel (funnel) przed aplikacją bez logowania to otwarta usługa. Wszystko, co znajduje się za nim, musi uwierzytelniać własne żądania z taką samą starannością, jakiej wymaga wystawiony punkt końcowy Ollama API.
Do wszystkiego, co określiłbyś mianem środowiska produkcyjnego, użyj profesjonalnego reverse proxy. Własna domena, własny certyfikat, własne logi, własne limity zapytań i brak osób trzecich na ścieżce żądania. Porównanie nginx, Caddy i Traefik jako reverse proxy pomoże w wyborze odpowiedniego narzędzia.
Tryby awarii i komunikaty błędów
Funnel nie uruchamia się. Funnel not available; "funnel" node attribute not set. oznacza problem z polityką, a nie z samą komendą. Dodaj atrybut funnel do pliku polityki tailnet, zapisz zmiany i spróbuj ponownie.
Działało, a teraz tailscale serve status zwraca No serve config. Mapowanie zostało utworzone w pierwszym planie, a proces ten zakończył działanie. Uruchom ponownie tę samą komendę z flagą --bg.
Nazwa jest rozpoznawana, ale brak odpowiedzi. To serve przekazuje ruch do wskazanego celu, więc jeśli usługa nie nasłuchuje pod danym adresem, nie ma czego przekazywać. Zweryfikuj za pomocą ss -ltnp | grep 3000 na tej samej maszynie, na której uruchomiono tailscaled, czy usługa działa. Częstą przyczyną jest kontener publikujący port na adresie bridge Docker zamiast na 127.0.0.1, co sprawia, że host nie widzi nasłuchiwania w oczekiwanym miejscu. Jak działa sieć w Docker Compose wyjaśnia, gdzie faktycznie trafia opublikowany port. Jeśli aplikacja już działa w Compose, umieszczenie Tailscale w stosie jako sidecar eliminuje domysły, ponieważ kontener otrzymuje własną nazwę w tailnet i w ogóle nie publikuje portu na hoście.
Błędy certyfikatu dla nazwy ts.net. Certyfikaty HTTPS najprawdopodobniej nie są włączone dla tailnet. Włącz je w konsoli administracyjnej, a następnie wykonaj krok certyfikacji osobno, aby jego błędy nie mieszały się z wynikami działania serve:
sudo tailscale cert your-host.your-tailnet.ts.netFunnel ładuje się w sieci komórkowej, ale zachowuje się inaczej niż na laptopie. Twój laptop znajduje się w tailnet, więc MagicDNS rozpoznaje nazwę jako adres 100.x i łączysz się z usługą przez tailnet, z pominięciem przekaźnika funnel. Jest to poprawne zachowanie, które oznacza, że laptop nie może przetestować publicznej dostępności. Użyj curl z maszyny, która nie znajduje się w tailnet.
FAQ
Jaka jest różnica między tailscale serve a tailscale funnel?
Różnica dotyczy tego, kto ma dostęp do wyniku. tailscale serve udostępnia port lokalny pod adresem HTTPS, który jest dostępny tylko dla urządzeń w Twojej sieci tailnet. tailscale funnel udostępnia ten sam port pod adresem dostępnym dla każdego użytkownika Internetu, kierując ruch przez serwery przekaźnikowe (relay) obsługiwane przez Tailscale. Flagi oraz cele są wspólne dla obu poleceń. Pierwsza linia wyjściowa informuje, który tryb został uruchomiony: Available within your tailnet lub Available on the internet.
Dlaczego tailscale funnel zwraca błąd o nieustawionym atrybucie węzła?
Ponieważ funkcja funnel jest wyłączona dla sieci tailnet, dopóki administrator jej nie włączy. Komunikat Funnel not available; "funnel" node attribute not set. pochodzi z Twojego klienta, zanim nastąpi połączenie z jakimkolwiek przekaźnikiem. Dodaj wpis nodeAttrs, przyznając atrybut funnel dla autogroup:member (lub dla znacznika, jeśli tylko jedna maszyna ma publikować usługi) w pliku polityki sieci tailnet w sekcji Access Controls. Administrator sieci tailnet może również skorzystać z adresu URL zgody, który wyświetla CLI.
Z jakich portów może korzystać Tailscale Funnel?
Tylko z 443, 8443 oraz 10000. Domyślnym portem jest 443, a inny można wybrać za pomocą --https=8443 lub --https=10000. Jest to ograniczenie przekaźników funnel, a nie serwera, więc żadna zmiana w zaporze sieciowej ani konfiguracji VPS go nie zniesie. tailscale serve nie posiada takiego ograniczenia, ponieważ ruch nigdy nie opuszcza sieci tailnet.
Czy adres URL utworzony przez serve lub funnel przetrwa restart?
Tylko jeśli użyto flagi --bg. Bez niej polecenie działa na pierwszym planie, wyświetla Press Ctrl+C to exit., a mapowanie znika wraz z procesem. Z flagą --bg mapowanie jest zapisywane w konfiguracji serve węzła i przywracane wraz z tailscaled po restarcie. Stan można sprawdzić za pomocą tailscale serve status, które wyświetla No serve config, gdy nic nie jest skonfigurowane.
Czy pozostawienie uruchomionego funnel jest bezpieczne?
Jest bezpieczne pod względem transportu: połączenie jest szyfrowane HTTPS, a na zaporze sieciowej nie jest otwarty żaden port. Nie jest jednak bezpieczne w potocznym rozumieniu, ponieważ adres URL jest publiczny, a co za tym idzie – aplikacja za nim również. Utrzymuj funnel tylko przed usługami, które same uwierzytelniają żądania, i wyłączaj go po zakończeniu testów lub prezentacji, używając polecenia, które go utworzyło, z dopiskiem off na końcu.
Źródła powyższych informacji o działaniu poleceń: dokumentacja Tailscale Serve i Funnel oraz dokumentacja CLI pod adresem tailscale.com/docs.