Configure split DNS para serviços internos
Antes de começar
Configure split DNS na tailnet para consultar domínios internos no servidor correto, confira as rotas e teste a resolução de nomes no sistema operacional.
- Resolvedor DNS interno com domínio e registros conhecidos.
- Caminho de rede até o resolvedor, por cliente Tailscale ou subnet router.
- Permissão para configurar DNS na tailnet e permitir UDP e TCP 53 quando necessários.
O split DNS direciona consultas de um domínio específico para um servidor DNS escolhido. Isso permite resolver nomes internos sem encaminhar todas as consultas da máquina ao mesmo servidor. O MagicDNS continua atendendo aos nomes dos dispositivos da tailnet.
Prepare o servidor de nomes
Anote o domínio interno, o endereço do resolvedor e um registro que já exista. Neste exemplo didático, app.interno.example.com deve responder com o endereço do serviço e o resolvedor é 10.10.0.53. Substitua ambos pelos valores do seu ambiente.
O cliente precisa alcançar o resolvedor. Se o endereço pertence à rede local, configure primeiro o subnet router correspondente. Confira também as permissões de acesso ao DNS, normalmente UDP e TCP na porta 53.
Cadastre o domínio no painel
Abra DNS no painel administrativo da tailnet. Em Nameservers, adicione um servidor personalizado, informe o endereço e habilite a restrição por domínio. Use interno.example.com para o exemplo acima. Confira o domínio antes de confirmar a alteração.
O resolvedor restrito atende somente às consultas correspondentes. Um servidor global atende consultas de qualquer domínio. Para esta configuração, mantenha o servidor limitado ao domínio interno.
No cliente Linux, confira se a configuração DNS da tailnet está aceita:
sudo tailscale set --accept-dns=trueTeste pelo resolvedor do sistema
No Linux, consulte o nome completo pelo mecanismo usado pelas aplicações:
getent hosts app.interno.example.comCompare o endereço retornado com o registro mantido no servidor DNS. Depois, abra a aplicação pela URL e pela porta esperadas. Resolver o nome e acessar o serviço são verificações distintas.
Se uma consulta direta ao servidor responde, mas o sistema não resolve o nome, revise a aceitação do DNS e o domínio cadastrado. Se nenhuma consulta responde, confira primeiro o caminho até o resolvedor. Siga o diagnóstico de DNS sem resposta para separar essas etapas.
Teste também o endereço devolvido pelo DNS
Resolver um nome e alcançar seu endereço são duas verificações. Se o DNS devolver um IP de uma LAN, o cliente precisa de uma rota até essa LAN e de permissão para a porta da aplicação. A rota usada para chegar ao resolvedor pode ser diferente da rota até o serviço.
No Linux com as ferramentas DNS instaladas, uma consulta direta pode separar uma falha do servidor de uma falha de seleção do resolvedor:
dig @10.10.0.53 app.interno.example.comSubstitua o IP e o nome pelo seu ambiente. Esse comando consulta explicitamente o servidor indicado. Ele não comprova que as aplicações do sistema estão usando split DNS. Faça também a consulta pelo resolvedor do sistema, conforme a etapa anterior.
Uma resposta NXDOMAIN informa que o servidor consultado não encontrou aquele nome. Um tempo de espera esgotado exige conferir alcance, serviço DNS e firewall. Evite acrescentar um resolvedor público para tentar resolver um domínio que existe apenas no DNS interno.
Desfaça apenas a configuração adicionada
Para retirar este domínio da tailnet, remova o nameserver restrito correspondente no painel. Preserve as demais entradas. Repita a consulta pelo sistema e confira o comportamento esperado fora do domínio interno.
Confira o resultado
O cliente resolve um nome do domínio interno pelo resolvedor previsto e alcança também o serviço no endereço retornado.
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.
