SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-10-11

Tailscale Serve ou Funnel: qual usar?

Serve mantém o HTTPS restrito à tailnet; Funnel expõe a porta à Internet. Veja a regra de política que bloqueia o Funnel e como escolher.

tailscale serve versus funnel: quem pode aceder ao URL

A diferença entre tailscale serve e tailscale funnel é o público-alvo, e nada mais. serve coloca uma interface HTTPS (hypertext transfer protocol secure) numa porta local e publica-a apenas na sua tailnet. funnel publica essa mesma porta local em toda a Internet pública, através dos servidores de relay operados pela Tailscale. Os dois comandos aceitam as mesmas flags e os mesmos destinos. Uma palavra separa um dashboard privado de um dashboard acessível a qualquer pessoa na Internet.

Ambos fornecem um certificado que os browsers já consideram fidedigno, num nome terminado em ts.net, e nenhum deles precisa de uma porta de entrada aberta na firewall do seu VPS. O daemon tailscaled já mantém uma ligação de saída para a tailnet, por isso o tráfego chega através dessa ligação. Colocar um servidor na tailnet é uma tarefa, e executar um VPS como nó de saída Tailscale ou anunciar um router de sub-rede para uma rede privada trata dessa parte. Publicar um serviço que já está na tailnet é outra.

O que é necessário antes de qualquer um dos comandos funcionar

  • Tailscale 1.52 ou mais recente no VPS, com sessão iniciada no seu tailnet. O Funnel existe desde a versão 1.38.3, mas os comandos serve e funnel mudaram na versão 1.52, e todos os comandos desta página usam a sintaxe mais recente. Verifique com tailscale version e tailscale status.
  • MagicDNS ativado. O MagicDNS é o DNS (sistema de nomes de domínio) integrado do Tailscale. É ele que atribui à máquina um nome como blog-vps.your-tailnet.ts.net, em vez de apenas um endereço 100.x.
  • Certificados HTTPS ativados para o tailnet, na página DNS da consola de administração. Sem isso, não há certificado para colocar à frente da sua porta.
  • Apenas para funnel, o atributo de nó funnel no ficheiro de política do tailnet. É aqui que a maioria das primeiras tentativas para, e o procedimento é explicado abaixo.

Todos os comandos desta página começam com sudo, porque normalmente tailscaled é executado como root e, por predefinição, apenas root pode geri-lo. Conceda a um utilizador o direito de omitir isso, definindo-o como operador:

sudo tailscale set --operator=$USER

Publique na sua tailnet com tailscale serve

Aponte serve para uma porta local e ele trata do resto.

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.

O comando simples 3000 é uma abreviatura de http://127.0.0.1:3000. O Tailscale escuta na porta 443 do endereço da máquina na tailnet, termina o TLS (transport layer security) com o certificado ts.net e encaminha HTTP simples para a sua porta local. A aplicação nunca precisa de saber que existe um certificado. Essa é a principal razão para usar este recurso à frente de um painel de administração que, de outra forma, ficaria exposto apenas em HTTP simples. Uma interface Web que escuta apenas em 127.0.0.1 é a candidata óbvia. A interface Web do dsh na porta 3080 é um bom exemplo: em vez de abrir um túnel SSH sempre que precisar de a utilizar, aponte serve para 3080 uma vez e aceda-lhe a partir de qualquer dispositivo na tailnet.

Agora leia a última linha: Press Ctrl+C to exit. O comando é executado em primeiro plano e o mapeamento fica dentro desse processo. Se fechar o terminal, o URL deixa de funcionar, porque nada foi gravado no disco. Adicione --bg para guardar o mapeamento na configuração serve do nó. Essa configuração sobrevive ao terminal e a um reboot.

sudo tailscale serve --bg 3000

O Serve aceita mais do que um número de porta. --set-path publica um serviço num subcaminho, para que várias aplicações possam partilhar o mesmo hostname:

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

O destino também pode ser um diretório com ficheiros estáticos ou um backend que já utilize TLS com um certificado que não queira validar:

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

Não está limitado a HTTP. --tcp=<port> encaminha um fluxo TCP (transmission control protocol) bruto, e --tls-terminated-tcp=<port> termina o TLS no seu nó e encaminha o conteúdo em texto simples. Assim, coloca um certificado confiável à frente de um serviço que não utiliza HTTP:

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

Por que o funnel informa que o atributo do nó não está definido?

O funnel está desativado por padrão para toda a tailnet. A primeira execução mostra esta mensagem e para:

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

O comando estava correto. A política da tailnet ainda não concedeu a este nó permissão para publicar, por isso o cliente recusa a operação antes de contactar qualquer relay. Edite o ficheiro de política da tailnet na consola de administração, em Access Controls, e adicione o atributo:

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

autogroup:member concede essa permissão a todos os membros da tailnet. Se apenas uma máquina deve publicar, atribua uma tag a essa máquina e use a tag como destino, por exemplo tag:public. Guarde a política e execute novamente o comando funnel.

Se a sua conta puder editar a política da tailnet (com a função Owner, Admin ou Network admin), os clientes recentes oferecem um atalho: a CLI mostra um URL para uma página de aprovação, e a aprovação cria os certificados HTTPS e adiciona o atributo automaticamente. Se não tiver uma dessas funções, esse URL não será útil. Alguém com acesso à política terá de fazer a alteração.

Publicar na Internet com tailscale funnel

Depois de definir o atributo, o comando é aquele que já conhece, mas com um verbo diferente.

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.

Leia sempre a primeira linha. Available within your tailnet e Available on the internet são a única diferença visível entre um serviço privado e um público, e os comandos que os produzem diferem por uma palavra.

Em outubro de 2026, o funnel escuta na porta 443, 8443 ou 10000, e em nenhuma outra. O padrão é 443, e --https=8443 ou --https=10000 são as alternativas. Qualquer outra porta é recusada, porque os relays do funnel aceitam ligações apenas nessas portas. Por isso, um URL do funnel é sempre o hostname simples, ou o hostname com :8443 ou :10000 acrescentado no fim.

Como vejo o que está publicado neste momento?

Adivinhar é a forma de manter um dashboard público durante um mês. Consulte o nó diretamente.

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

Ambos os comandos de estado leem a mesma configuração, por isso qualquer um deles mostra o panorama completo. Use a forma --json num script ou numa verificação agendada, porque a saída normal foi feita para leitura humana. Quando não há nada configurado, é apresentada uma linha:

No serve config

Se vir isto depois de uma configuração que sabe que funcionou, o mapeamento foi criado em primeiro plano e o processo terminou. Crie-o novamente com --bg.

Para remover um mapeamento, repita o comando que o criou e acrescente off no fim. Para eliminar todos os mapeamentos de serve e funnel no nó, use reset.

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

Execute tailscale serve status novamente depois de qualquer uma das operações e veja o que permaneceu, em vez de assumir que o resultado foi o pretendido.

O que obtém e o que abdica

As vantagens são reais e explicam por que motivo algumas pessoas escolhem esta opção em vez de um reverse proxy.

  • Um certificado reconhecido pelos browsers, renovado automaticamente. Não é necessário instalar um cliente ACME (ambiente de gestão automática de certificados), nem configurar uma tarefa de renovação que possa ser esquecida.
  • Nenhuma porta de entrada na firewall do VPS. O tailscaled estabelece ligações de saída, por isso uma firewall ufw com política default-deny no seu VPS pode continuar exatamente tão restritiva como antes.
  • Não é necessário comprar, apontar ou aguardar por um registo DNS.
  • Não é necessário port forwarding, que é o essencial numa máquina atrás de NAT (tradução de endereços de rede), em vez de um VPS com um IP público.

Os custos também são reais, e o Funnel implica todos eles.

  • O nome não lhe pertence. Os visitantes públicos veem host.your-tailnet.ts.net. O Funnel não suporta domínios personalizados, por isso não pode colocar app.example.com à frente dele.
  • O caminho não lhe pertence. O tráfego chega primeiro a um relay do Tailscale, que faz proxy do stream para o seu nó através do tailnet. O Tailscale afirma que o tráfego do Funnel está sujeito a limites de largura de banda que não podem ser configurados. A documentação não indica um valor, por isso meça o seu próprio débito antes de depender de um número.
  • Faltam os controlos. Um reverse proxy que execute dá-lhe logs de acesso, limites de taxa, limites de tamanho dos pedidos e um local para configurar autenticação. O Funnel fornece um URL. Tudo o resto tem de existir dentro da sua aplicação.
  • A lista de portas é fixa, como indicado acima.

Ambas as funcionalidades também dependem da infraestrutura operada pelo Tailscale: a emissão de certificados para o nome ts.net e os próprios relays do Funnel. A importância dessa dependência depende do que esses servidores podem ou não fazer com o seu tráfego, que é precisamente o que o modelo de confiança do Tailscale descreve. Nenhuma das duas funcionalidades tem custo de utilização: o Tailscale indica que o Funnel está disponível em todos os planos, a documentação do Serve não menciona qualquer restrição de plano e o plano gratuito abrange até seis utilizadores, com dispositivos ilimitados por utilizador. Um sétimo utilizador é o motivo habitual para um tailnet passar para um plano pago, embora algumas funcionalidades, como o aprovisionamento de utilizadores SCIM (gestão de identidades entre domínios) e os logs de fluxo de rede, exijam um plano pago independentemente do número de utilizadores. A partir daí, a fatura depende dos utilizadores e não das máquinas, por isso vale a pena verificar quanto custa realmente um tailnet num plano pago antes de o serve ou o funnel se tornar essencial. Se estiver a considerar um servidor de controlo Headscale autoalojado, não assuma que qualquer uma das funcionalidades funciona com ele. Consulte as notas de versão da versão do Headscale que pretende executar.

Qual devo usar?

A regra é simples.

Use serve para qualquer serviço interno: interfaces de administração, dashboards, uma interface de métricas que não quer indexada ou uma cópia de staging de um site. A participação na tailnet é o controlo de acesso, e é um bom controlo. Um dispositivo que não esteja na tailnet nem sequer consegue resolver o nome.

Use funnel para um link de demonstração, um recetor de webhook para o qual um terceiro tenha de fazer POST ou um callback OAuth durante o desenvolvimento. É a forma mais rápida de obter um URL HTTPS público, e um comando off termina a exposição. Público significa público: o hostname não é um segredo, e um funnel à frente de uma aplicação sem login é um serviço aberto. O que estiver atrás dele tem de autenticar os próprios pedidos, com o mesmo cuidado que um endpoint de API do Ollama exposto exige.

Use um reverse proxy real para qualquer serviço que considere de produção. O seu domínio, o seu certificado, os seus logs, os seus limites de pedidos e ninguém mais no caminho do pedido. Comparação entre nginx, Caddy e Traefik como reverse proxy explica como escolher um.

Modos de falha e as mensagens que verá

O Funnel recusa-se a iniciar. Funnel not available; "funnel" node attribute not set. é um problema de política, não um problema do comando. Adicione o atributo funnel ao ficheiro de política do tailnet, guarde-o e tente novamente.

Funcionou e agora tailscale serve status indica No serve config. O mapeamento foi criado em primeiro plano e esse processo terminou. Execute novamente o mesmo comando com --bg.

O nome é resolvido, mas nada responde. O Serve faz proxy para o destino indicado. Se não houver nada a escutar nesse destino, não há nada para encaminhar. Confirme com ss -ltnp | grep 3000 na mesma máquina que executa tailscaled. A causa frequente é um contentor publicar a porta num endereço de bridge do Docker em vez de 127.0.0.1. Nesse caso, o host não encontra nenhum serviço a escutar no local esperado. Como funciona a rede do Docker Compose mostra onde uma porta publicada fica efetivamente disponível. Se a aplicação já for executada no Compose, colocar o Tailscale na stack como sidecar elimina essa incerteza, porque o contentor obtém o seu próprio nome no tailnet e não publica nenhuma porta no host.

Erros de certificado no nome ts.net. É muito provável que os certificados HTTPS não estejam ativados para o tailnet. Ative-os na consola de administração. Depois, execute o passo do certificado isoladamente, para que os erros não se misturem com a saída do serve:

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

O Funnel carrega através dos dados móveis, mas comporta-se de forma diferente no portátil. O portátil está no tailnet, por isso o MagicDNS resolve o nome para o endereço 100.x e acede ao serviço através do tailnet, sem contactar um relay do Funnel. Esse comportamento é correto. Significa que o portátil não consegue testar a acessibilidade pública. Use curl numa máquina que não esteja no tailnet.

FAQ

Qual é a diferença entre tailscale serve e tailscale funnel?

Quem pode aceder ao resultado. tailscale serve publica uma porta local num URL HTTPS que apenas os dispositivos da sua tailnet podem aceder. tailscale funnel publica a mesma porta num URL que qualquer pessoa na internet pode aceder, encaminhado através dos servidores de relay geridos pela Tailscale. As flags e os destinos são partilhados entre ambos. A primeira linha da saída indica qual dos dois foi obtido: Available within your tailnet ou Available on the internet.

Porque é que tailscale funnel indica que o atributo do nó não está definido?

Porque o funnel está desativado para uma tailnet até alguém o ativar. A mensagem é Funnel not available; "funnel" node attribute not set. e é gerada pelo seu próprio cliente, antes de qualquer relay ser contactado. Adicione uma entrada nodeAttrs que conceda o atributo funnel a autogroup:member, ou a uma tag se apenas uma máquina dever publicar, no ficheiro de política da tailnet, em Access Controls. Um administrador da tailnet pode, em alternativa, seguir o URL de consentimento apresentado pela CLI.

Que portas o Tailscale Funnel pode utilizar?

Apenas 443, 8443 e 10000. O valor predefinido é 443, e pode escolher outro com --https=8443 ou --https=10000. Este é um limite dos relays do funnel, não do seu servidor. Por isso, nenhuma alteração à firewall ou à configuração da VPS o elimina. tailscale serve não tem essa restrição, porque o tráfego nunca sai da sua tailnet.

Um URL de serve ou funnel mantém-se depois de um reboot?

Apenas se tiver utilizado --bg. Sem essa opção, o comando é executado em primeiro plano, apresenta Press Ctrl+C to exit. e o mapeamento desaparece juntamente com o processo. Com --bg, o mapeamento é escrito na configuração de serve do nó e regressa com tailscaled depois de um reboot. Verifique com tailscale serve status. O comando apresenta No serve config quando não existe nenhuma configuração.

É seguro deixar um funnel em execução?

É seguro do ponto de vista do transporte: a ligação utiliza HTTPS e nenhuma porta é aberta na firewall. Não é seguro no sentido habitual, porque o URL é público e, por isso, a aplicação por trás dele também é pública. Mantenha um funnel ativo apenas à frente de algo que autentique os próprios pedidos. Desative-o quando a demonstração ou o teste do webhook terminar, utilizando o comando que o criou com off no fim.

Fontes sobre o comportamento dos comandos acima: a documentação do Tailscale Serve e Funnel e a referência da CLI em tailscale.com/docs.

Este artigo foi útil?