Serve e Funnel: serviços na tailnet e na internet
Serve e Funnel são o mesmo mecanismo com alcances diferentes. O cliente Tailscale recebe requisições HTTPS e as repassa para uma aplicação da máquina. Com Serve, só a tailnet chega até ela. Com Funnel, qualquer visitante da internet chega.
Em telas pequenas, role as tabelas para o lado para consultar todas as colunas.
Uma aplicação que roda na sua máquina, como um painel em 127.0.0.1:3000, só responde a conexões feitas na própria máquina. O Serve coloca um proxy HTTPS do Tailscale na frente dela e entrega uma URL com certificado válido para os dispositivos da tailnet. O Funnel usa a mesma configuração e abre essa URL para a internet, sem exigir cliente Tailscale do visitante.
Os dois recursos encaminham conexões para um processo que já existe. Nenhum deles inicia a aplicação, corrige uma falha dela ou substitui o login que ela exige. A diferença entre os dois está no alcance da URL. É essa diferença que define o cuidado necessário antes de cada publicação.
Serve: um serviço dentro da tailnet
O Serve encaminha requisições para uma aplicação da sua máquina e disponibiliza o endereço dentro da tailnet. No exemplo desta seção, a aplicação já atende em 127.0.0.1:3000.
O backend local antes da URL
No computador que executa a aplicação, este comando confere a resposta local:
curl -I http://127.0.0.1:3000Uma resposta HTTP indica que houve comunicação. O código retornado define o próximo passo: redirecionamento, autenticação obrigatória e erro interno exigem ações diferentes. Algumas aplicações não aceitam o método HEAD usado por essa opção. O navegador local substitui o teste nesses casos.
Quando o serviço local para, a URL deixa de entregar a página mesmo com o dispositivo conectado à tailnet. O login da aplicação continua valendo, porque o proxy apenas repassa a conexão.
Ativação e certificado
A publicação dentro da tailnet usa:
tailscale serve --bg http://127.0.0.1:3000tailscale serve statusA opção --bg mantém a configuração em segundo plano. Quando a tailnet ainda não tem HTTPS habilitado, o cliente mostra as instruções. A emissão de certificado pode publicar o nome no registro de transparência de certificados, por isso o hostname da máquina precisa estar definido antes de habilitar HTTPS. O endereço que funciona é exatamente o exibido pelo comando.
Porta publicada e permissões
Numa publicação HTTPS na porta 443, a política precisa permitir o acesso a essa porta. A porta 3000 do backend não é a porta usada pelo cliente remoto. Os grants definem quais usuários chegam à porta publicada.
O teste completo usa um celular conectado à tailnet, com a identidade que realmente vai utilizar o serviço, além da identidade administrativa usada na configuração. Uma identidade que não deve acessar o serviço também precisa ser testada, porque uma permissão ampla já existente pode continuar liberando o acesso depois de você adicionar um grant restrito.
tailscale serve reset apaga toda a configuração Serve do dispositivo, inclusive outros endpoints configurados na mesma máquina, então o estado precisa ser consultado antes da remoção.
Funnel: o mesmo serviço na internet
O Funnel torna um serviço acessível pela internet. Visitantes sem Tailscale alcançam a URL publicada. Os grants da rede privada não autenticam esses visitantes, então a aplicação precisa estar preparada para receber tráfego público antes da ativação.
Aplicação pronta para visitantes
A aplicação em 127.0.0.1:3000 responde no próprio servidor, com autenticação configurada e sem páginas de depuração, registros de teste privados ou interfaces administrativas desprotegidas. A documentação lista os requisitos atuais de MagicDNS, HTTPS e autorização. A política da tailnet precisa permitir que o dispositivo use a função.
A ativação segue o mesmo formato do Serve:
tailscale funnel --bg http://127.0.0.1:3000tailscale funnel statusO cliente apresenta o fluxo de autorização. O estado mostra a URL e o destino. Funnel e Serve não são duas publicações independentes na mesma porta: alterar o modo muda o alcance daquele endpoint.
Teste externo e sessão anônima
A URL precisa abrir num dispositivo sem conexão à sua tailnet e exigir a autenticação configurada na própria aplicação. Uma sessão anônima do navegador completa o teste, porque estar autenticado no servidor durante a configuração pode esconder uma página que ficou acessível sem login.
São dois testes separados. O backend local abre na máquina que executa o Funnel. A URL pública abre por uma conexão externa. Quando o primeiro falha, o problema está na aplicação. Quando só o segundo falha, o estado do Funnel, a URL e a autorização do dispositivo são os pontos a conferir.
Portas e largura de banda
As portas públicas aceitas pelo recurso são 443, 8443 e 10000. Elas se referem à publicação e não obrigam o processo local a usar a mesma porta. A documentação também prevê limites de largura de banda que o administrador não ajusta, o que pesa antes de usar o recurso para uma transferência extensa.
tailscale funnel reset remove toda a configuração Funnel da máquina. Depois da remoção, a URL aberta pela internet mostra se a publicação por esse caminho terminou. Retirar o Funnel não encerra o processo da aplicação nem remove outras formas de publicação configuradas no servidor.
Serve e Funnel lado a lado
Os dois recursos compartilham o comando, o proxy HTTPS e a forma de apontar para o backend local. O que muda é o alcance da URL e, por consequência, a camada que controla o acesso. A tabela resume as diferenças descritas nas seções anteriores:
| Aspecto | Serve | Funnel |
|---|---|---|
| Alcance da URL | Dispositivos da tailnet | Qualquer visitante da internet |
| Controle de acesso de rede | Grants da tailnet para a porta publicada | Autorização do dispositivo para usar Funnel |
| Autenticação do visitante | Identidade da tailnet e login da aplicação | Somente o login da aplicação |
| Portas públicas | Porta HTTPS configurada na publicação | 443, 8443 ou 10000 |
| Comando de consulta | tailscale serve status |
tailscale funnel status |
Para um painel administrativo usado só por você e por dispositivos da sua tailnet, o Serve mantém a URL fora da internet e soma a identidade da tailnet ao login da aplicação. O Funnel faz sentido para um serviço que precisa receber visitantes sem Tailscale, como um webhook de outro sistema ou uma página de demonstração. Nesse caso, toda a proteção fica com a aplicação.
