Ir para o conteúdo
Promovaweb

Serve e Funnel: serviços na tailnet e na internet

Revisado em

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:

Terminal
curl -I http://127.0.0.1:3000

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

Terminal
tailscale serve --bg http://127.0.0.1:3000
tailscale serve status

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

Terminal
tailscale funnel --bg http://127.0.0.1:3000
tailscale funnel status

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

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.