Solução de problemas de DNS
Resolva atrasos de propagação de DNS, conflitos de CNAME e falhas de verificação TXT ao configurar domínios personalizados. Inclui comandos dig e correções por provedor.
Problemas de DNS são a causa mais comum de falhas em domínios personalizados.
Verificar a propagação de DNS
Alterações de DNS podem levar até 48 horas para se propagar. A maioria se completa em algumas horas.
Verifique o status da propagação:
# Check if your CNAME is resolving
dig CNAME docs.yourdomain.com
# Or use nslookup
nslookup -type=CNAME docs.yourdomain.com
A saída esperada mostra seu CNAME apontando para cname.jamdesk.com:
docs.yourdomain.com. 300 IN CNAME cname.jamdesk.com.
Ferramentas online como whatsmydns.net mostram a propagação em várias regiões.
Problemas comuns
CNAME não resolve
Sintoma: dig não mostra nenhum registro CNAME ou mostra um destino incorreto.
Causas:
- Registro não salvo no provedor de DNS
- Erro de digitação no nome ou valor do registro
- Propagação do DNS ainda em andamento
Correção:
- Acesse seu provedor de DNS
- Verifique se o registro CNAME existe com os valores corretos
- Aguarde de 15 a 30 minutos e verifique novamente
CNAME no domínio raiz
Sintoma: O provedor de DNS rejeita um registro CNAME para yourdomain.com (sem subdomínio).
Causa: Os padrões de DNS (RFC 1034) proíbem registros CNAME no apex da zona (domínio raiz).
Correção: O painel da Jamdesk mostra automaticamente um registro A (76.76.21.21) em vez de CNAME para domínios apex. Se o painel ainda exibir um CNAME para um domínio apex, clique em Refresh para obter os registros atualizados.
Conflitos com o proxy da Cloudflare
Sintoma: Erros de SSL ou loops de redirecionamento ao usar o Cloudflare.
Causa: O proxy do Cloudflare (nuvem laranja) pode interferir no SSL da Vercel.
Correção:
- Nas configurações de DNS do Cloudflare, clique no ícone da nuvem laranja
- Mude para "DNS only" (nuvem cinza) para o subdomínio da sua documentação
- Deixe a Vercel emitir o certificado SSL
Registros conflitantes
Sintoma: A verificação do CNAME falha mesmo com o registro aparentemente correto.
Causa: Um registro A existente entra em conflito com o CNAME.
Correção:
- Verifique se há registros A no mesmo subdomínio
- Exclua os registros A conflitantes
- Garanta que apenas o CNAME permaneça
# Check for A records
dig A docs.yourdomain.com
Falha na verificação TXT
Sintoma: O registro TXT para hospedagem em subcaminho não é verificado.
Causas:
- Registro adicionado ao domínio errado
- Erro de digitação no valor do registro
- Registros TXT conflitantes
Correção:
- Verifique se o registro TXT está em
_jamdesk.yourdomain.com - Copie o valor de verificação exato do painel
- Verifique se há registros TXT conflitantes
# Check TXT records
dig TXT _jamdesk.yourdomain.com
Certificado SSL não é emitido
Sintoma: O domínio permanece com status "pending" indefinidamente.
Causas:
- Registros CAA bloqueando a emissão do certificado
- DNS não totalmente propagado
- Domínio inacessível
Correção:
Verifique os registros CAA:
dig CAA yourdomain.com
Se existirem registros CAA, adicione um que permita o Let's Encrypt:
yourdomain.com. CAA 0 issue "letsencrypt.org"
Comandos de diagnóstico
# Full DNS lookup
dig +trace docs.yourdomain.com
# Check all record types
dig ANY docs.yourdomain.com
# Check specific nameservers
dig @8.8.8.8 docs.yourdomain.com
# Check TTL (time to live)
dig +noall +answer docs.yourdomain.com
Observações específicas dos provedores de DNS
Cloudflare
- Defina o status do proxy como "DNS only" (nuvem cinza) durante a verificação do domínio
- Volte para proxy (nuvem laranja) após a conclusão da verificação
- Um Worker só executa quando o registro DNS está com proxy (nuvem laranja). Use a nuvem cinza apenas durante a verificação.
- Desative "Always Use HTTPS" para o subdomínio da documentação para evitar conflitos de SSL com a Vercel
GoDaddy
- O destino do CNAME não deve terminar com ponto
- As alterações podem levar mais tempo para se propagar
Namecheap
- Use o tipo "CNAME Record"
- O campo Host deve conter apenas o subdomínio (
docs, nãodocs.yourdomain.com)
Route 53
- O destino do CNAME deve terminar com ponto (
cname.jamdesk.com.) - Avaliar a integridade do destino: No
Quando entrar em contato com o suporte
Entre em contato com o suporte se:
- Os registros DNS estiverem corretos, mas o domínio continuar pendente após 48 horas
- Erros de certificado SSL persistirem após seguir todos os passos
- Ocorrerem erros específicos da infraestrutura da Jamdesk
Inclua na sua solicitação de suporte:
- O nome do seu domínio
- O nome do provedor de DNS
- A saída dos comandos
dig - Uma captura de tela da configuração de DNS
