> ## 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

> Compre, conecte e gerencie um domínio personalizado para o seu app Replit publicado.

Os domínios personalizados permitem atribuir o seu próprio nome de domínio, como `www.meu-app-incrivel.com`, ao seu app Replit publicado.
Embora o Replit forneça um subdomínio gratuito no formato `<nome-do-subdominio-do-seu-app>.replit.app`, um domínio
personalizado dá ao seu app um endereço mais memorável, que constrói reconhecimento de marca e confiança com seus visitantes.

A aba **Domains** na ferramenta Publishing reúne tudo o que você precisa em um só lugar. Você pode:

* **Comprar um novo domínio** pelo Replit e conectá-lo ao seu projeto em uma única etapa.
* **Conectar um domínio que você já possui** de outro registrador.
* **Gerenciar** os seus domínios conectados — veja para qual projeto cada um aponta, acompanhe renovações e desconecte um domínio.

Assista ao vídeo a seguir para uma visão geral rápida da configuração de domínios personalizados:

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

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          | Apenas subdomínio     | Qualquer domínio que você possua |
| Tempo de atualização do DNS         | Instantâneo           | Até 48 horas                     |
| Certificados de segurança (TLS/SSL) | Fornecido pelo Replit | Fornecido pelo Replit            |
| Preço                               | Gratuito              | Pague ao seu provedor de domínio |

<Note>
  Publique o seu app antes de conectar um domínio. A aba **Domains** fica disponível depois que o seu app tiver um
  Deployment bem-sucedido.
</Note>

## Comprar um novo domínio no Replit

Se você ainda não possui um domínio, pode pesquisar e comprar um sem sair do Replit. O seu novo
domínio aponta para o seu projeto automaticamente.

<Steps>
  <Step title="Abrir a aba Domains">
    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" alt="ícone do Publishing" width="16" height="16" data-path="images/icons/deploy-icon.svg" /> **Publishing** e selecione a aba **Domains**.
  </Step>

  <Step title="Pesquisar um domínio">
    Selecione **Buy a new domain** e digite o nome que você deseja. O Replit mostra as opções disponíveis em
    diversas extensões, como `.com`, `.ai` e outras. Se você não tiver certeza de como chamá-lo, o Replit também
    sugere nomes disponíveis com base no que o seu app faz, para que você possa escolher um sem começar do
    zero.

    <Frame>
      <img src="https://mintcdn.com/replit/jSmYU1wBTvl8UMyc/images/deployments/custom-domains/buy-domain.png?fit=max&auto=format&n=jSmYU1wBTvl8UMyc&q=85&s=b9370b56ffc2f86fba93b05309ed25d8" alt="Interface de pesquisa de domínio mostrando domínios disponíveis com extensões como .com e .ai" width="2172" height="1222" data-path="images/deployments/custom-domains/buy-domain.png" />
    </Frame>
  </Step>

  <Step title="Comprar e conectar">
    Selecione o domínio de sua preferência e conclua a compra usando o método de pagamento da sua conta Replit.
    O seu app fica acessível no novo domínio imediatamente, sem nenhuma configuração de DNS adicional.
  </Step>
</Steps>

Domínios comprados pelo Replit incluem [proteção de privacidade WHOIS](/pt/build/domain-purchasing) sem custo adicional, renovam-se automaticamente e permitem adicionar registros DNS personalizados (por exemplo, registros MX para e-mail). Para a referência completa sobre a compra de domínios — preços, renovações, transferências e registros DNS personalizados — consulte [Comprar um domínio](/pt/build/domain-purchasing).

## Conectar um domínio que você já possui

Se você já possui um domínio em outro registrador, conecte-o ao seu projeto pela aba **Domains**. O Replit
oferece uma configuração guiada que configura o seu DNS para você, com uma opção manual como alternativa.

### Configuração guiada (recomendada)

A forma mais simples de conectar um domínio existente é deixar o Replit configurá-lo para você. O Replit usa o
[Entri](https://entri.com), um serviço de conexão de domínios de terceiros: depois que você autoriza, o Entri
faz login no seu provedor de DNS e grava os registros DNS necessários em seu nome, então você não precisa
copiá-los manualmente.

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

<Steps>
  <Step title="Abrir a aba Domains">
    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" alt="ícone do Publishing" width="16" height="16" data-path="images/icons/deploy-icon.svg" /> **Publishing** e selecione a aba **Domains**.

    <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="Aba Domains" width="2422" height="1130" data-path="images/deployments/custom-domains/01.png" />
    </Frame>
  </Step>

  <Step title="Digitar o domínio que você deseja conectar">
    Selecione **Connect your own domain** e digite um domínio que você já possui, como `www.meu-app-incrivel.com`.
  </Step>

  <Step title="Autorizar a configuração guiada">
    Confirme a conexão. O Replit abre o fluxo guiado, no qual você faz login no seu provedor de DNS para que os
    registros DNS possam ser aplicados à sua conta automaticamente. Se o fluxo guiado não conseguir gravar os
    registros para o seu provedor, ele mostra os registros para você adicionar manualmente.
  </Step>

  <Step title="Aguardar a verificação do domínio">
    O seu domínio mostra o status **Verified** quando a configuração é concluída. Isso geralmente leva alguns minutos,
    mas as alterações de DNS podem levar até 48 horas para se propagar. Carregue o domínio no seu navegador para confirmar que está funcionando.
  </Step>
</Steps>

<Tip>
  Se o seu provedor não for compatível com a configuração guiada, ou se você preferir adicionar os registros manualmente, você pode
  conectar o seu domínio manualmente. Consulte [Conectar um domínio manualmente](#conectar-um-domínio-manualmente) abaixo.
</Tip>

### Conectar um domínio manualmente

Se o seu provedor não for compatível com a configuração guiada, ou se você preferir adicionar os registros manualmente, siga os
passos abaixo para configurar o seu domínio personalizado manualmente.

<Warning>
  Você pode enfrentar problemas de configuração se tiver um dos seguintes casos:

  * 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, já que o Replit só oferece suporte a registros `A`.
  * Registros de domínio com proxy do Cloudflare, já que o Replit não consegue renovar automaticamente certificados de segurança para esse tipo. Defina o seu registro como **DNS only** (a nuvem cinza).
  * Um registro `TXT` `replit-verify` ausente ou removido. O Replit precisa que esse registro permaneça em vigor para renovar o seu certificado SSL/TLS. Consulte [Mantenha o registro TXT em vigor](#mantenha-o-registro-txt-em-vigor) abaixo.
</Warning>

<Steps>
  <Step title="Adicionar o seu domínio personalizado">
    Digite o nome do seu 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="captura de tela das configurações de DNS" 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 o 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 oferecer suporte a `@` como hostname, use o seu nome de domínio registrado.

    <Warning>
      **Mantenha o registro TXT em vigor.** O Replit emite e renova o certificado SSL/TLS do seu domínio
      personalizado por meio de validação de DNS. O registro `TXT` `replit-verify=...` precisa 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 depois da verificação, a próxima renovação do certificado falhará
      e o seu domínio acabará servindo um certificado expirado, deixando o 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">
    Os subdomínios — incluindo `www` — não são resolvidos automaticamente quando você vincula o seu domínio
    raiz (apex). Cada subdomínio que você quiser servir precisa ser adicionado como sua própria entrada na aba
    **Domains** e receber seus próprios registros DNS no seu registrador.

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

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

    <Note>
      **`www` é um subdomínio.** Vincular `hat-tip.cc` não faz com que `www.hat-tip.cc` seja servido
      automaticamente. Se você quiser que os visitantes acessem o 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 querem
      um endereço `www` também configura um redirecionamento do domínio raiz para o `www` (ou vice-versa) no
      seu registrador.
    </Note>

    Assim como no domínio raiz, o registro `TXT` `replit-verify=...` que você adiciona para cada subdomínio
    precisa permanecer no DNS permanentemente. Consulte
    [Mantenha o registro TXT em vigor](#mantenha-o-registro-txt-em-vigor) abaixo.
  </Step>

  <Step title="Aguardar a conclusão da propagação do DNS">
    Depois de adicionar os registros, você precisa esperar que eles se propaguem online.
    Isso pode levar de alguns minutos a 48 horas.

    Quando a propagação for concluída, a sua aba Domains deve mostrar o status "Verified" ao lado do nome do domínio, como 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="captura de tela do status de domínio verificado" 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>

## Gerenciar seus domínios

A aba **Domains** lista todos os domínios conectados ao seu projeto e permite gerenciar cada um deles. Selecione um domínio
e escolha **Manage** para:

* **Ver para qual projeto o domínio aponta.** Se você tentar conectar um domínio que já está vinculado a
  outro dos seus projetos, o Replit avisa e permite que você o mova para o projeto atual.
* **Revisar renovações (para domínios comprados no Replit).** A visualização de gerenciamento mostra a data de renovação e
  o preço de renovação, e permite desativar a **Auto renewal** se você não quiser que o domínio renove automaticamente.
* **Editar registros DNS (para domínios comprados no Replit).** Adicione registros `A`, `TXT` ou `MX` personalizados — por
  exemplo, registros MX para usar o seu domínio com e-mail. Consulte [Registros DNS personalizados](/pt/build/domain-purchasing#custom-dns-records).
* **Desconectar o domínio.** Ao desconectar, o seu app deixa de ser servido nesse domínio. O domínio em si não é
  excluído — ele continua disponível para ser vinculado a outro dos seus projetos.

<Frame>
  <img src="https://mintcdn.com/replit/jSmYU1wBTvl8UMyc/images/deployments/custom-domains/replit-domains.png?fit=max&auto=format&n=jSmYU1wBTvl8UMyc&q=85&s=af1ea8f250c6ab83ff016fc2fe075851" alt="Interface de gerenciamento de domínios mostrando os domínios conectados e o status de conexão de cada um" width="3176" height="1556" data-path="images/deployments/custom-domains/replit-domains.png" />
</Frame>

## Solução de problemas

### Falha na vinculação do domínio ou verificação pendente sem avançar

Se uma conexão falhar ou o domínio permanecer em **Verifying**, siga estas verificações:

1. **Dê tempo para o DNS se propagar.** A verificação pode levar de alguns minutos até 48 horas. Use uma ferramenta de
   consulta de DNS para confirmar que os seus registros estão visíveis globalmente antes de alterar qualquer outra coisa.
2. **Remova registros conflitantes.** Mantenha apenas um registro `A` no seu domínio raiz apontando para o Replit, e
   remova quaisquer registros `AAAA` (IPv6) no mesmo hostname — eles podem bloquear o SSL.
3. **Desative o proxy do Cloudflare.** Defina o seu registro `A` como **DNS only** (a nuvem cinza). O modo de proxy
   (a nuvem laranja) interfere no provisionamento de SSL.
4. **Confirme que o registro `TXT` está presente.** Um registro `TXT` `replit-verify=...` ausente ou modificado bloqueia
   a verificação e a renovação do certificado. Consulte [Mantenha o registro TXT em vigor](#mantenha-o-registro-txt-em-vigor).
5. **Desconecte e reconecte o domínio** pela aba **Domains** para forçar um novo certificado, depois
   espere alguns minutos e recarregue a página.

Se você comprou o seu domínio pelo Replit e ele ainda não verificar, [contate o Suporte do Replit](https://replit.com/support).

### As alterações de DNS ainda não tiveram efeito

As alterações de DNS não são instantâneas. Depois de adicionar ou alterar registros, espere de alguns minutos
a 48 horas para que se propaguem globalmente. O seu app continua funcionando no subdomínio `replit.app` durante
esse período. Se o status **Verified** não aparecer depois de 48 horas, verifique novamente os seus registros com o que
o Replit mostra — os erros mais comuns são um ponto final, um subdomínio extra ou um registro obsoleto.

### Registros `CNAME` e autenticação

Você não precisa de um registro `CNAME` para que o login ou a autenticação funcionem no seu domínio personalizado. O login funciona
automaticamente em todo o seu domínio publicado depois que o domínio é verificado.

Os registros `CNAME` em um domínio personalizado só são necessários para o **envio de e-mail** — por exemplo, para que
e-mails de verificação ou transacionais possam ser enviados a partir do seu domínio. Se a ferramenta Publishing mostrar um aviso
solicitando que você adicione registros `CNAME`, isso se refere à entrega de e-mail, não ao login. Adicionar os registros só é
necessário se você enviar e-mail a partir do seu domínio; isso não bloqueia a verificação, o SSL ou o login do seu domínio.
Para as etapas de configuração relacionadas a e-mail, consulte
[Autenticação com Clerk](/pt/features/auth-and-identity/clerk-auth).

### Mantenha o registro TXT em vigor

O Replit emite e renova o certificado SSL/TLS de cada domínio personalizado por meio de validação de 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 precisa permanecer no seu DNS durante toda a vida útil do domínio. Se o registro for removido, editado ou substituído depois que o seu domínio for verificado, a próxima renovação falhará silenciosamente e o certificado existente acabará expirando. Os visitantes verão então um aviso de segurança no navegador e o app ficará inacessível.

Se domínios mais antigos na sua conta começarem a mostrar erros de certificado enquanto os mais novos funcionam normalmente, 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 mostra para o domínio.
3. Adicione o registro `TXT` de volta no seu registrador de domínio exatamente como mostrado, incluindo o hostname e o valor.
4. Remova o domínio no Replit e adicione-o novamente para acionar uma nova emissão.
5. Espere a propagação do DNS e verifique novamente o status **Verified** na aba **Domains**.