# Domínio personalizado e HTTPS: DNS, verificação e o certificado

Adicione um domínio personalizado com HTTPS no Pro. Crie o registro DNS do Cloud, espere a verificação e o certificado, e mantenha o hostname padrão.

Canonical URL: https://unbroker.cloud/pt/blog/custom-domain-https
Published: 2026-11-05
Reviewed: 2026-11-09
Author: Timoteo Borgobello

## A resposta curta

No Pro, um domínio personalizado com HTTPS são três passos. Você adiciona o hostname em Domains, cria o registro DNS exato que o Cloud mostra e espera a verificação e o certificate readiness. O hostname padrão da Unbroker fica, então os health checks ainda podem usá-lo.

Um domínio custom não é mais um deploy. DNS, verificação do hostname e o certificado TLS são estados separados. Primeiro teste o app no hostname da Unbroker. Fazer deploy de novo do mesmo commit não conserta o DNS.

O fluxo do produto está em [Domains and TLS](https://docs.unbroker.cloud/deployments/domains). O passo a passo é [Connect a custom domain and HTTPS](https://docs.unbroker.cloud/guides/custom-domain). Como esse app ficou live está em [Deploy com git push](https://unbroker.cloud/pt/blog/deploy-on-git-push).

## Confira o app antes de mexer no DNS

Abra a URL que a Unbroker fornece e chame uma rota que você espera. Se essa request falha, leia o deployment e os logs de runtime. A falha está no app. Editar o DNS não explica isso. A leitura por etapa está em [Depurar um deploy com falha](https://unbroker.cloud/pt/blog/debug-failed-deployment).

Mantenha o hostname padrão depois de adicionar o seu. A página de domínios diz que ele continua útil para health checks e para diagnosticar a configuração do domínio. O guia pede para verificar essa URL antes de mudar o roteamento de produção.

Domínios personalizados pedem Unbroker Pro, um serviço HTTP em execução e permissão para mudar o DNS do domínio. A tabela de planos lista domínios personalizados e TLS gerenciado como indisponíveis no Free e disponíveis no Pro. O Pro custa $25 por mês, com $25 de crédito de uso. O crédito reinicia a cada ciclo e não acumula. Se o uso elegível fica abaixo do crédito, a cobrança mensal continua sendo o preço do plano. Os valores atuais estão em [preços](https://unbroker.cloud/pt/precos).

## Adicione o hostname no Cloud

Abra a visão Domains do serviço e adicione o hostname que você quer publicar, por exemplo `api.example.com` ou `www.example.com`. É assim que se adiciona um domínio custom ao app que já está no ar. O registro dessa tela é o que aponta o domínio para o serviço.

O Cloud mostra o tipo, o nome e o destino do registro DNS. Copie esses valores no seu provedor de DNS. Use os valores dessa tela. Não invente um destino a partir da URL de outro serviço ou de outro projeto.

Um domínio apex e um subdomínio podem precisar de registros diferentes. Siga o tipo de registro que o Cloud mostra e o tipo que o seu provedor aceita para esse hostname. O guia diz isso para um apex: siga o tipo de registro que o provedor aceita e as instruções de destino mostradas no Cloud.

Adicionar o hostname configura o serviço. Não edita o registrador e não cria o registro DNS por você. Você cria esse registro no provedor da zona autoritativa.

## Adicione o hostname com a CLI

Os comandos documentados são:

```bash
ubctl apps domains add <serviceId> api.example.com
ubctl apps domains ls <serviceId>
ubctl apps domains status <serviceId>
```

Substitua o id do serviço e o hostname de exemplo. `add` anexa o hostname ao serviço. `ls` lista os domínios desse serviço. `status` é como você lê o estado do domínio no terminal. O mesmo limite vale: esses comandos não gravam registros no registrador. A fonte é o [guia de domínio custom](https://docs.unbroker.cloud/guides/custom-domain).

## Três estados: DNS, verificação e o certificado

Espere o Cloud informar a verificação do domínio e o certificate readiness. Não são o mesmo momento.

Você cria o registro DNS. A atualização pode aparecer em resolvedores diferentes em momentos diferentes. Confira se há um registro conflitante no mesmo hostname e se você editou a zona autoritativa. Um registro na zona errada não verifica.

Depois da verificação, o certificate readiness é acompanhado na mesma visão Domains. Esse sinal é o certificado TLS gerenciado do hostname. Também se chama certificado SSL do domínio próprio. Quando estiver pronto, chame a URL HTTPS e teste uma rota da aplicação.

Se a URL padrão funciona e o domínio personalizado não responde depois do deploy, fique em DNS, verificação do hostname e certificado. Fazer deploy de novo de código sem mudanças não repara um erro de DNS. O guia pede para evitar deploys repetidos nesse caso.

## Atualize as URLs do app

O hostname que as pessoas digitam é um ajuste da aplicação, além de um registro DNS. Inclua a origin nova nas allowlists de callback de OAuth, na configuração de CORS e nos trusted hosts. Se um frontend gravou a origin da API no bundle, gere o build de novo. Atualize as URLs canônicas, a origin do sitemap e os links absolutos para usarem o domínio público que você quer. Um site Astro define essa origin em `site` antes do build. Saída estática ou adaptador de servidor está em [hospedagem Astro](https://unbroker.cloud/pt/blog/astro-hosting). O que atualizar na API e no frontend quando essas origens mudam está em [deploy de um frontend e uma API separados](https://unbroker.cloud/pt/blog/frontend-and-api).

Um serviço Node começa em [Deploy de Node.js](https://unbroker.cloud/deploy/nodejs). Um app Next.js começa em [Deploy de Next.js](https://unbroker.cloud/deploy/nextjs). Se o app foi feito no Lovable, no Bolt ou no Cursor, as verificações que uma página pública não cobre estão em [App feito com IA em produção](https://unbroker.cloud/pt/blog/ai-built-app-to-production). O hostname público é um passo separado dessa lista.

## Migrar o tráfego

Se esse hostname já aponta para outro lugar, baixe o TTL antes do corte e leve em conta o tempo de cache do registro atual. O guia pede para preparar o destino e levar em conta esse tempo de cache antes de trocar o tráfego de produção. Mantenha o hostname padrão da Unbroker durante a mudança.

Uma mudança de DNS não migra um banco de dados e não revoga as credenciais do host anterior. Se o tráfego antigo ainda pode chegar a esse host, os dois lados não devem escrever em armazenamentos de dados divergentes.

Sair do Railway são duas páginas. A comparação é [Unbroker como alternativa ao Railway](https://unbroker.cloud/pt/alternativas/railway). A mudança é [Migrar do Railway](https://unbroker.cloud/pt/migrar/railway). Sair do Heroku é [Migrar do Heroku](https://unbroker.cloud/pt/migrar/heroku). Este post não repete esses roteiros.

## Quando o domínio custom falha e a URL padrão funciona

O app está no ar. O hostname não. Siga a lista nesta ordem:

1. O registro está na zona DNS autoritativa desse domínio.
2. Não há um registro conflitante no mesmo hostname.
3. O tipo, o nome e o destino batem com o que o Cloud mostra. Eles não foram copiados de outro serviço.
4. A visão Domains informa a verificação.
5. A mesma visão informa o certificate readiness.
6. Uma rota da aplicação na URL HTTPS devolve o que você espera.

Se a URL padrão também falha, volte aos logs do deployment. Isso é uma request com falha contra o app, não um estado do domínio personalizado.

## Checklist

1. Chame a URL padrão da Unbroker. Se falhar, depure o deployment antes de mexer no DNS.
2. No Pro, adicione o hostname na visão Domains do serviço.
3. Crie o registro DNS que o Cloud mostra. O tipo, o nome e o destino precisam coincidir.
4. Deixe o hostname padrão no lugar.
5. Espere a verificação e depois o certificate readiness.
6. Atualize callbacks, CORS, trusted hosts, origins de API embutidas, URLs canônicas e o sitemap.
7. Chame a URL HTTPS. Se só o domínio personalizado falha, confira a zona, os registros conflitantes, a verificação e o certificado. Não faça deploy de novo do mesmo commit para consertar o DNS.

## Perguntas frequentes

### Como adiciono um domínio personalizado com HTTPS ao meu app num PaaS?

No Pro, adicione o hostname na visão Domains do serviço, crie o registro DNS que o Cloud mostra e espere a verificação e o certificate readiness. O hostname padrão da Unbroker fica para os health checks. O fluxo está em [Domains and TLS](https://docs.unbroker.cloud/deployments/domains).

### Por que o domínio personalizado falha se a URL da plataforma funciona?

O app responde no hostname da Unbroker, então o deployment já está live. Confira a zona DNS autoritativa, registros conflitantes nesse hostname, a verificação e o certificate readiness. Fazer deploy de novo do mesmo commit não conserta o DNS.

### Preciso do Pro para um domínio personalizado?

Sim. A tabela de planos lista domínios personalizados e TLS gerenciado como indisponíveis no Free e disponíveis no Pro. O guia também parte de um serviço HTTP em execução e de permissão para mudar o DNS. O Pro custa $25 por mês, com $25 de crédito de uso. Veja [preços](https://unbroker.cloud/pt/precos) e [Plans](https://docs.unbroker.cloud/billing/plans).

### Devo apagar o hostname padrão da Unbroker?

Não. Mantenha. Ele continua útil para health checks e para separar uma falha do app de um problema de domínio. A página de domínios manda não removê-lo.

### Adicionar um domínio altera o DNS no registrador automaticamente?

Não. Adicionar o hostname configura o serviço. Você cria o registro DNS no provedor da zona autoritativa. A Unbroker não edita o registrador.

### Domínio apex ou subdomínio?

Use o tipo, o nome e o destino do registro que o Cloud mostra para esse hostname. Num apex, siga também o tipo de registro que o seu provedor de DNS aceita. Não copie o destino da URL de outro serviço.

### Uma mudança de DNS migra o banco de dados?

Não. Uma mudança de DNS aponta o hostname para o serviço. Ela não move linhas, arquivos nem credenciais. Se o host anterior ainda pode receber tráfego, impeça que os dois lados escrevam em armazenamentos de dados divergentes.

## Related reading

- [Depurar um deploy com falha](https://unbroker.cloud/pt/blog/debug-failed-deployment)
- [Deploy com git push](https://unbroker.cloud/pt/blog/deploy-on-git-push)
- [App feito com IA em produção](https://unbroker.cloud/pt/blog/ai-built-app-to-production)
- [Migrar do Railway](https://unbroker.cloud/pt/migrar/railway)
- [Migrar do Render](https://unbroker.cloud/pt/migrar/render)
- [Migrar do Heroku](https://unbroker.cloud/pt/migrar/heroku)
- [Deploy de Node.js](https://unbroker.cloud/deploy/nodejs)
- [Deploy de Next.js](https://unbroker.cloud/deploy/nextjs)
- [Hospedagem Astro](https://unbroker.cloud/pt/blog/astro-hosting)
- [Alternativa ao Railway](https://unbroker.cloud/pt/alternativas/railway)
- [Preços](https://unbroker.cloud/pt/precos)
