> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Domínios Personalizados

> Aprenda como conectar seu próprio nome de domínio ao seu app Replit publicado.

Domínios personalizados permitem que você atribua seu nome de domínio, como `www.meu-app-incrivel.com`, ao seu app Replit publicado.
Enquanto o Replit fornece um subdomínio gratuito no formato `<nome-do-subdominio-do-seu-app>.replit.app`, usar
um domínio personalizado permite criar um endereço mais memorável.

Um nome de domínio personalizado pode ajudar no reconhecimento da marca e na confiança dos usuários do seu app.

Assista ao vídeo a seguir para uma visão geral rápida de como configurar Domínios Personalizados:

<Frame>
  <iframe src="https://www.youtube.com/embed/rGYdyb58wJY" title="Custom Domains with Publishing" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</Frame>

## Conectar um domínio com configuração automática

A maneira mais simples de conectar um domínio é deixar o Replit configurar para você. Ao vincular um domínio que você já possui, o Replit configura os registros DNS necessários em seu nome. Você não precisa mais copiar registros manualmente para o seu provedor de domínio.

<Note>
  Registros DNS são as configurações que informam à internet para onde seu domínio deve apontar. Configurá-los manualmente costumava ser a parte mais complicada de conectar um domínio. O Replit agora cuida dessa etapa para você na maioria dos domínios e provedores.
</Note>

<Steps>
  <Step title="Abrir a ferramenta Publishing">
    Após publicar seu app, abra a ferramenta <img class="icon-svg" src="https://mintcdn.com/replit/rJldsgYVucXB_6kW/images/icons/deploy-icon.svg?fit=max&auto=format&n=rJldsgYVucXB_6kW&q=85&s=853c5ef39a8a7ac3648b3a2ce182fcb8" width="16" height="16" data-path="images/icons/deploy-icon.svg" /> **Publishing** e selecione a aba **Domains**.
  </Step>

  <Step title="Insira o domínio que deseja conectar">
    Selecione **Link a domain** e insira um domínio que você já possui, como `www.meu-app-incrivel.com`.
  </Step>

  <Step title="Confirme e deixe o Replit configurar seu DNS">
    Confirme a conexão e o Replit configurará os registros DNS para você. Pode ser solicitado que você faça login no seu provedor de domínio para que a alteração seja aplicada à sua conta.
  </Step>

  <Step title="Aguarde a verificação do seu domínio">
    Seu domínio exibe o status **Verified** quando a configuração for concluída. Isso geralmente leva alguns minutos. Carregue o domínio no seu navegador para confirmar que funciona.
  </Step>
</Steps>

<Tip>
  Se o seu provedor não é compatível com a configuração automática, ou se preferir adicionar os registros você mesmo, ainda é possível conectar seu domínio manualmente. Veja [Conectar um domínio manualmente](#conectar-um-domínio-manualmente) abaixo.
</Tip>

## Recursos

Domínios Personalizados estão disponíveis para os seguintes tipos de Deployment:

* [Autoscale](/references/publishing/autoscale-deployments/)
* [Reserved VM](/references/publishing/reserved-vm-deployments/)
* [Static](/references/publishing/static-deployments/)

A tabela a seguir compara os subdomínios do Replit com os domínios personalizados:

| Recurso                             | Subdomínio Replit      | Domínio Personalizado            |
| :---------------------------------- | :--------------------- | :------------------------------- |
| Personalização do hostname          | Somente subdomínio     | Qualquer domínio que você possua |
| Tempo de atualização de DNS         | Instantâneo            | Até 48 horas                     |
| Certificados de segurança (TLS/SSL) | Fornecidos pelo Replit | Fornecidos pelo Replit           |
| Preço                               | Gratuito               | Pague ao seu provedor de domínio |

## Uso

<Accordion title="Como acessar Domínios Personalizados">
  1. Após publicar seu app, abra a ferramenta <img class="icon-svg" src="https://mintcdn.com/replit/rJldsgYVucXB_6kW/images/icons/deploy-icon.svg?fit=max&auto=format&n=rJldsgYVucXB_6kW&q=85&s=853c5ef39a8a7ac3648b3a2ce182fcb8" width="16" height="16" data-path="images/icons/deploy-icon.svg" /> **Publishing**.
  2. Selecione a aba **Domains**.
  3. Selecione **Link a domain** ou **Manually connect from another registrar** conforme mostrado na captura de tela abaixo.

  <Frame>
    <img src="https://mintcdn.com/replit/jSmYU1wBTvl8UMyc/images/deployments/custom-domains/01.png?fit=max&auto=format&n=jSmYU1wBTvl8UMyc&q=85&s=5dc58a0cab37877093e55c9a2b3b1367" alt="Domains tab" width="2422" height="1130" data-path="images/deployments/custom-domains/01.png" />
  </Frame>
</Accordion>

## Conectar um domínio manualmente

Se o seu provedor não é compatível com a configuração automática, ou se preferir adicionar os registros você mesmo, siga as etapas abaixo para configurar seu domínio personalizado manualmente.

<Warning>
  Você pode encontrar problemas de configuração se tiver um dos seguintes: - Múltiplos
  registros `A` para o mesmo nome de domínio apontando para servidores diferentes. - Registros `A`
  e `AAAA` coexistindo para o mesmo domínio, pois o Replit suporta apenas registros `A`. - Registros de domínio com proxy do Cloudflare, pois o Replit não consegue renovar automaticamente

  * Múltiplos registros `A` para o mesmo nome de domínio apontando para servidores diferentes.
  * Registros `A` e `AAAA` coexistindo para o mesmo domínio, pois o Replit suporta apenas registros `A`.
  * Registros de domínio com proxy do Cloudflare, pois o Replit não consegue renovar automaticamente os certificados de segurança para esse tipo.
  * Um registro `TXT` `replit-verify` ausente ou removido. O Replit precisa que esse registro permaneça no lugar para renovar seu certificado SSL/TLS. Veja [Manter o registro TXT no lugar](#manter-o-registro-txt-no-lugar) abaixo.
</Warning>

<Steps>
  <Step title="Adicionar seu domínio personalizado">
    Insira seu nome de domínio personalizado no campo de texto. Você pode usar um domínio registrado ou incluir um subdomínio.

    Por exemplo, `hat-tip.cc` é o domínio registrado e `my.hat-tip.cc` inclui o subdomínio `my`.

    <Frame>
      <img src="https://mintcdn.com/replit/jSmYU1wBTvl8UMyc/images/deployments/custom-domains/02.png?fit=max&auto=format&n=jSmYU1wBTvl8UMyc&q=85&s=38485a8680fe6ae256ec2d7b0665a784" alt="screenshot of the DNS settings" width="1940" height="718" data-path="images/deployments/custom-domains/02.png" />
    </Frame>
  </Step>

  <Step title="Adicionar os registros DNS ao seu registrador de domínio">
    O Replit gera registros DNS que você deve fornecer ao seu **registrador de domínio**.
    Um registrador de domínio é o serviço que gerencia seu nome de domínio, como GoDaddy ou Namecheap.

    Copie os valores dos registros `A` e `TXT` do Replit e cole-os na seção de gerenciamento de DNS do seu registrador de domínio. Se o seu registrador de domínio não suportar `@` como hostname, use seu nome de domínio registrado.

    <Warning>
      **Mantenha o registro TXT no lugar.** O Replit emite e renova o certificado SSL/TLS para o seu
      domínio personalizado por meio de validação DNS. O registro `TXT` `replit-verify=...` deve permanecer
      no seu DNS durante toda a vida útil do domínio — não apenas durante a configuração inicial. Se você
      remover ou alterar o registro após a verificação, a próxima renovação do certificado falhará
      e seu domínio eventualmente exibirá um certificado expirado, tornando seu app inacessível
      nos navegadores. Trate o registro `TXT` como permanente, assim como o seu registro `A`.
    </Warning>
  </Step>

  <Step title="Opcional: Adicionar um subdomínio">
    Subdomínios — incluindo `www` — não são resolvidos automaticamente quando você vincula seu domínio
    apex. Cada subdomínio que você deseja servir deve ser adicionado como uma entrada separada na aba
    **Domains** e ter seus próprios registros DNS no seu registrador.

    Para adicionar um subdomínio, vincule-o na aba **Domains** da mesma forma que vinculou o domínio
    apex e, em seguida, adicione os registros DNS que o Replit gera para ele ao seu registrador de domínio.
    Por exemplo, para adicionar `meu-subdominio.hat-tip.cc`:

    * Na ferramenta **Publishing**, selecione a aba **Domains** e vincule `meu-subdominio.hat-tip.cc`.
    * No seu registrador, adicione um novo registro `A` com o hostname `meu-subdominio` apontando para o
      endereço IP que o Replit exibe para a nova entrada.
    * No seu registrador, adicione o registro `TXT` `replit-verify=...` correspondente no hostname
      `meu-subdominio` — cada subdomínio tem seu próprio registro `TXT`, separado do apex.

    <Note>
      **`www` é um subdomínio.** Vincular `hat-tip.cc` não serve automaticamente
      `www.hat-tip.cc`. Se você quiser que os visitantes acessem seu app tanto em `hat-tip.cc` quanto em
      `www.hat-tip.cc`, adicione `www.hat-tip.cc` como uma entrada separada na aba **Domains** e
      publique os registros `A` e `TXT` que ele gera no hostname `www`. A maioria dos criadores que desejam
      um endereço `www` também configura um redirecionamento do apex para `www` (ou vice-versa) no
    </Note>

    Assim como no domínio apex, o registro `TXT` `replit-verify=...` que você adiciona para cada subdomínio
    deve permanecer no DNS permanentemente. Veja
    [Manter o registro TXT no lugar](#manter-o-registro-txt-no-lugar) abaixo.
  </Step>

  <Step title="Aguardar a propagação do DNS ser concluída">
    Após adicionar os registros, você deve aguardar a propagação online.
    Isso pode levar de alguns minutos a 48 horas.

    Quando a propagação for concluída, sua aba Domains deve mostrar o status "Verified" ao lado do nome do domínio conforme mostrado abaixo:

    <Frame>
      <img src="https://mintcdn.com/replit/jSmYU1wBTvl8UMyc/images/deployments/custom-domains/domain-verified.png?fit=max&auto=format&n=jSmYU1wBTvl8UMyc&q=85&s=fe5c99d84ff0334119d2e94b2f07c99a" alt="screenshot of the verified domain status" width="1866" height="890" data-path="images/deployments/custom-domains/domain-verified.png" />
    </Frame>

    Carregue o domínio no seu navegador para verificar que está funcionando.
  </Step>
</Steps>

## Solução de problemas

### Manter o registro TXT no lugar

O Replit emite e renova o certificado SSL/TLS para cada domínio personalizado por meio de validação DNS, que depende do registro `TXT` `replit-verify=...` que você adicionou durante a configuração. O registro `TXT` não é um artefato de configuração único — ele deve permanecer no seu DNS durante toda a vida útil do domínio. Se o registro for removido, editado ou substituído após a verificação do seu domínio, a próxima renovação falhará silenciosamente e o certificado existente eventualmente expirará. Os visitantes verão então um aviso de segurança do navegador e o app ficará inacessível.

Se domínios mais antigos na sua conta apresentarem erros de certificado enquanto os mais novos funcionam, um registro `TXT` ausente ou modificado é a causa mais provável.

Para restaurar um domínio afetado:

1. Abra a ferramenta **Publishing** e selecione a aba **Domains**.
2. Confirme o registro `TXT` `replit-verify=...` que o Replit exibe para o domínio.
3. Adicione o registro `TXT` de volta no seu registrador de domínio exatamente como exibido, incluindo o hostname e o valor.
4. Remova o domínio no Replit e adicione-o novamente para acionar uma nova emissão.
5. Aguarde a propagação do DNS e verifique novamente o status **Verified** na aba **Domains**.