Domínios personalizados
Sirva sua documentação a partir do seu próprio domínio, em vez do subdomínio padrão *.jamdesk.app. Configuração de DNS, SSL e verificação.
Sirva sua documentação a partir do seu próprio domínio, em vez do subdomínio padrão *.jamdesk.app.
Visão geral da configuração
Acesse Settings → Domain do seu projeto e informe seu domínio (por exemplo, docs.example.com ou example.com).
Adicione os registros de DNS exibidos no painel ao seu provedor de DNS. Os registros dependem do tipo de domínio (veja abaixo).
A Jamdesk verifica a propriedade do domínio e provisiona um certificado SSL.
Opções de hospedagem
Escolha um modo de hospedagem ao adicionar um domínio.
Domínio padrão
A Jamdesk serve sua documentação diretamente no seu domínio personalizado:
docs.example.com → acme.jamdesk.app
O DNS aponta para a Jamdesk. A Jamdesk emite e renova o certificado SSL.
Hospedar em /docs (baseado em proxy, subcaminho personalizável)
Sua documentação fica em um subcaminho do seu site existente:
example.com/docs → acme.jamdesk.app/docs
/docs é o padrão. Escolha qualquer subcaminho de um segmento (/help, /guide e assim por diante) pela mesma opção. Configure um proxy (Cloudflare, Vercel, nginx etc.) para encaminhar as requisições desse subcaminho para a Jamdesk. Consulte Hospedagem em subcaminho para guias de configuração e as regras para escolher um subcaminho.
Ativar ou desativar "Hospedar em um subcaminho" ou alterar o subcaminho dispara uma nova build. A estrutura de URLs muda.
Configuração de DNS
Os registros necessários dependem de você usar um subdomínio ou um domínio raiz (apex).
Subdomínios (por exemplo, docs.example.com)
| Tipo | Nome | Valor |
|---|---|---|
| CNAME | docs | cname.jamdesk.com |
| TXT | _jamdesk.docs | (exibido no painel) |
O campo "Nome" é a parte do subdomínio. Para docs.example.com, informe docs.
Domínios raiz (por exemplo, example.com)
| Tipo | Nome | Valor |
|---|---|---|
| A | @ | 76.76.21.21 |
| TXT | _jamdesk | (exibido no painel) |
Domínios raiz usam um registro A em vez de CNAME. Os padrões de DNS (RFC 1034) proíbem registros CNAME no apex da zona.
Alterações de DNS podem levar até 48 horas para se propagar. A maioria se completa em minutos. Verifique o status em whatsmydns.net.
Verificação
A Jamdesk executa estas etapas assim que você adiciona os registros de DNS:
- Detecta seus registros de DNS (CNAME ou A, além do TXT)
- Verifica a propriedade do domínio pelo registro TXT
- Provisiona um certificado SSL via Let's Encrypt
- Direciona o tráfego para sua documentação
Verifique o status da verificação em Settings → Domain. O status aparece como:
- Pending - Aguardando a propagação do DNS
- Active - Domínio verificado e servindo tráfego
- Needs Attention - Incompatibilidade ou conflito de configuração (verifique a notificação por e-mail)
- Error - Problema de configuração (veja os detalhes no painel)
Clique em Refresh no painel para verificar agora o status da verificação.
Certificados SSL
A Jamdesk provisiona certificados SSL e os renova antes de expirarem. Requisições HTTP são redirecionadas para HTTPS.
Domínios raiz
Domínios raiz (apex), como example.com, funcionam. O painel mostra um registro A apontando para 76.76.21.21 em vez de um CNAME. Os padrões de DNS proíbem registros CNAME no apex da zona.
Vários domínios
Cada projeto tem um domínio personalizado. Para direcionar mais domínios para a mesma documentação:
- Configure seu domínio principal na Jamdesk
- Configure os domínios adicionais para redirecionar ao principal no nível do DNS/CDN
Remover um domínio
- Acesse Settings → Domain
- Clique em Remove Domain
- Sua documentação continua acessível no subdomínio
*.jamdesk.app
Remover um domínio com "Hospedar em um subcaminho" ativado dispara uma nova build para atualizar os caminhos das URLs. A Jamdesk também limpa qualquer subcaminho personalizado. Um domínio que você reconectar depois volta ao /docs padrão.
Usuários do Cloudflare
Siga estes passos se a Cloudflare for seu provedor de DNS:
- Defina o status do proxy como DNS only (ícone de nuvem cinza) durante a verificação do domínio
- Deixe a Vercel cuidar do SSL: desative "Always Use HTTPS" da Cloudflare para o subdomínio da documentação
- Depois que a verificação for concluída, você pode reativar o proxy (nuvem laranja)
Usando um Cloudflare Worker? O registro de DNS precisa estar com proxy (nuvem laranja) para que o Worker execute. Use a nuvem cinza apenas durante a verificação e depois volte para a laranja. Veja configuração de Cloudflare Workers para detalhes.
Solução de problemas
| Problema | Solução |
|---|---|
| Domínio preso em "Pending" | Verifique os registros de DNS com dig (CNAME para subdomínios, A para apex) |
| Erros de certificado SSL | Garanta que nenhum registro CAA bloqueie o Let's Encrypt |
| Loops de redirecionamento | Se usar a Cloudflare, deixe em nuvem cinza durante a verificação (veja Usuários da Cloudflare acima) |
| CNAME não resolve | Verifique o registro no provedor de DNS e aguarde a propagação |
| Domínio já em uso | O domínio está registrado na Vercel de uma configuração anterior; a verificação normalmente é concluída automaticamente |
Verificar o DNS com dig
# Check CNAME record (subdomains)
dig CNAME docs.example.com
# Check A record (apex domains)
dig A example.com
# Check TXT record
dig TXT _jamdesk.example.com
Para diagnósticos detalhados, consulte Solução de problemas de DNS.
O subdomínio jamdesk.app compete com meu domínio nas pesquisas?
Não. As páginas servidas pelo seu subdomínio [slug].jamdesk.app incluem um link canônico apontando para seu domínio personalizado ativo. Os mecanismos de busca atribuem os sinais de ranqueamento ao seu domínio.
