Apenas domínio personalizado
Ative o modo Somente domínio personalizado no Jamdesk para bloquear o acesso direto pelo subdomínio e disponibilizar a documentação apenas no seu domínio.
Sua documentação está hospedada em YOUR_SLUG.jamdesk.app. O subdomínio continua respondendo depois que você conecta um domínio personalizado. Todas as páginas servidas por ele incluem uma tag <link rel="canonical"> que aponta para o seu domínio. Os mecanismos de busca indexam seu domínio, nunca o subdomínio.
Custom domain only desativa o subdomínio para visitantes diretos. Uma solicitação direta a YOUR_SLUG.jamdesk.app retorna um erro 404. Sua documentação só pode ser acessada pelo seu próprio domínio.
As capturas de tela mostram a interface em inglês.
Isso oculta seu subdomínio. Não é uma senha. Qualquer pessoa que acessar seu site pelo seu domínio continuará vendo sua documentação. Controle quem pode acessá-la com a proteção por senha. Você pode ativar os dois recursos.
Ativação
Adicione e verifique seu domínio no painel. Consulte Domínios personalizados. O controle exige que o domínio tenha o status Active.
Se seu domínio for um CNAME simples apontado para o Jamdesk (como docs.acme.com), ignore esta etapa. Se você servir a documentação em yoursite.com/docs por meio de um proxy, ele deverá se identificar em todas as solicitações encaminhadas. Consulte Configurações de proxy abaixo.
Abra Settings do seu projeto no painel. Expanda o cartão Custom Domain e ative Custom domain only. O Jamdesk verifica primeiro seu domínio ativo. O controle permanece desativado até que a configuração seja aprovada. Se a verificação falhar, a mensagem informa o que você precisa corrigir.

As alterações chegam a todos os servidores de borda em até um minuto.
Configurações de proxy
O Jamdesk só atende a uma solicitação para YOUR_SLUG.jamdesk.app se identificar que ela veio do seu proxy. Para isso, é necessário o cabeçalho X-Jamdesk-Forwarded-Host ou o marcador de consulta ?jd_proxy=1. Estes guias de configuração incluem a opção adequada:
- Vercel: as reescritas em
vercel.jsonincluem?jd_proxy=1. O Edge Middleware define o cabeçalho. - Cloudflare Workers: o Worker define o cabeçalho.
- AWS CloudFront: use o cabeçalho personalizado de origem.
- Proxy reverso: nginx, Apache, Caddy e HAProxy definem o cabeçalho.
Está usando MCP ou o widget de chat por meio de um proxy reverso? Encaminhe /api/mcp/:path* e /api/chat/:path* da mesma forma que /docs. Na Vercel:
{
"rewrites": [
{ "source": "/api/mcp/:path*", "destination": "https://YOUR_SLUG.jamdesk.app/api/mcp/:path*?jd_proxy=1" },
{ "source": "/api/chat/:path*", "destination": "https://YOUR_SLUG.jamdesk.app/api/chat/:path*?jd_proxy=1" }
]
}O MCP e o chat não exigem alterações em domínios com CNAME apontado para o Jamdesk. Configure os clientes MCP para usar https://docs.acme.com/_mcp.
Informações importantes
- Tudo retorna erro 404 no subdomínio sem caminho: páginas,
sitemap.xml,robots.txt,llms.txte exportações em Markdown. Os navegadores exibem uma página de não encontrado do Jamdesk. - As imagens continuam acessíveis. Imagens, vídeos e imagens de pré-visualização para redes sociais (OG) são exceções. A pré-visualização do site no painel as carrega diretamente do subdomínio.
- Você não pode perder o acesso. Se o DNS do seu domínio parar de funcionar, o Jamdesk deixa de aplicar o bloqueio. O subdomínio volta a servir conteúdo até que o domínio se recupere. Se você alterar incorretamente a configuração do proxy (por exemplo, removendo o marcador de uma reescrita), desative o controle enquanto corrige o problema.
- A API de busca não é afetada. A autenticação é feita por chave de API.
O que vem a seguir?
