Ir para o conteúdo
Promovaweb

Publique um serviço na internet com Funnel

Revisado em

Antes de começar

Use Funnel para publicar uma aplicação na internet. Confira autenticação, permissões e a URL pública antes de compartilhar o endereço com outros usuários.

  • Aplicação local funcionando e preparada para acesso público.
  • MagicDNS, HTTPS e autorização de Funnel na tailnet.
  • Cliente compatível com a CLI e conexão externa para teste.

Funnel torna um serviço acessível pela internet. Visitantes sem Tailscale podem alcançar a URL publicada. Use essa função somente depois de preparar a aplicação para receber tráfego público.

Prepare o serviço

Teste a aplicação em 127.0.0.1:3000 no próprio servidor. Configure a autenticação da aplicação e retire páginas de depuração, registros de teste privados e interfaces administrativas sem proteção.

Confira na documentação os requisitos atuais de MagicDNS, HTTPS e autorização para Funnel. A política da tailnet precisa permitir que o dispositivo utilize a função. Os grants da rede privada não autenticam visitantes da internet.

Ative a publicação

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

Siga o fluxo de autorização apresentado pelo cliente. Confira a URL e o destino mostrados no estado. Funnel e Serve não devem ser tratados como duas publicações independentes na mesma porta: alterar o modo pode mudar o alcance daquele endpoint.

Confira pela internet

Abra a URL em um dispositivo sem conexão à sua tailnet. O serviço deve responder e exigir a autenticação que você configurou na própria aplicação.

Faça também um teste com uma sessão anônima do navegador. Estar autenticado no servidor durante a configuração pode esconder uma página que ficou acessível sem login.

Antes de compartilhar a URL, confira também os limites descritos a seguir. O exemplo não determina a capacidade disponível para sua aplicação.

Confira o alcance antes de distribuir a URL

As portas públicas aceitas pelo recurso são 443, 8443 e 10000. Elas se referem à publicação, não obrigam o processo local a usar a mesma porta. A documentação também prevê limites de largura de banda que não podem ser ajustados pelo administrador. Considere esses limites antes de usar o recurso para uma transferência extensa.

Faça dois testes separados: primeiro abra o backend local na máquina que executa Funnel. Depois use a URL pública por uma conexão externa. Se o primeiro falhar, corrija a aplicação. Se apenas o segundo falhar, confira o estado do Funnel, a URL e a autorização do dispositivo.

Ao encerrar a publicação, teste novamente pelo acesso externo. Retirar Funnel não encerra o processo da aplicação nem remove outras formas de publicação configuradas no servidor.

Encerre a publicação

Consulte o estado para identificar os endpoints existentes. Para remover toda a configuração Funnel da máquina, execute tailscale funnel reset. Abra novamente a URL a partir da internet e confirme que o serviço não está mais publicado por esse caminho.

Confira o resultado

A URL abre fora da tailnet, exige o login definido na aplicação e deixa de publicar o serviço após a retirada da configuração.

Fontes e conferência

Procedimento revisado a partir da documentação oficial em 2 de novembro de 2026. Não executado em uma tailnet de laboratório nesta edição.