Como configurar seu próprio domínio (CNAME/DNS)

1. Pré-requisitos

Antes de iniciar o processo, certifique-se de que você cumpre os seguintes requisitos:

Plano Standard ou superior: A Square Cloud permite a configuração de domínios customizados apenas para usuários a partir do plano Standard.
Um domínio registrado: Você deve possuir um domínio comprado em provedoras como Registro⁠.br, Namecheap, GoDaddy, Cloudflare Registrar, Squarespace Domains ou outra.
Recomendado (opcional): gerenciar o DNS na Cloudflare (gratuito), o que garante proteção contra ataques DDoS e maior velocidade de carregamento (CDN). Você também pode criar os registros direto no painel DNS do seu provedor.

2. O que são Nameservers?

Antes de configurar o site, você precisa entender o conceito de Nameservers (Servidores de Nome).

Definição: Os Nameservers são como a "lista telefônica" da internet. Eles indicam qual serviço é responsável por gerenciar os registros do seu domínio. Quando você altera os Nameservers para a Cloudflare, você está dizendo à internet: "Quem cuida do caminho para o meu site agora é a Cloudflare".

Transferência de gerência para a Cloudflare

Se o seu domínio foi comprado no Registro⁠.br, GoDaddy ou outra, você precisará apontá-lo para a Cloudflare seguindo estes passos:

Crie uma conta gratuita na Cloudflare.
Clique em "Add a Site" e digite o seu domínio (ex: meusite⁠.com⁠.br).
A Cloudflare fornecerá dois endereços de Nameservers (ex: nina⁠.ns⁠.cloudflare⁠.com e tom⁠.ns⁠.cloudflare⁠.com).
Acesse o painel da sua provedora (onde você comprou o domínio).
Procure pela opção Alterar Servidores de Nome ou DNS.
Substitua os endereços atuais pelos fornecidos pela Cloudflare e salve.
Aguarde: A propagação pode levar de alguns minutos até 24 horas. Troque os nameservers primeiro e só anexe o domínio na Square Cloud depois que o dnschecker⁠.org (tipo NS) mostrar os novos. Um domínio pendente por mais de 24 h é desvinculado automaticamente: nesse caso, cadastre-o de novo na aba Network.

3. Configuração na Square Cloud

Com a gerência de DNS na Cloudflare, vamos preparar a sua aplicação na Square Cloud.

Acesse o Dashboard da Square Cloud.
Selecione a aplicação que você deseja vincular ao domínio.
No menu, clique na aba Configurações e selecione a sub-aba Network.
No campo de texto, digite o seu domínio ou subdomínio (ex: meusite⁠.com ou api⁠.meusite⁠.com).
Clique em Salvar.
O sistema exibirá os registros necessários:

CNAME: Um endereço de destino (cname⁠.squareweb⁠.app).
TXT: _cf-custom-hostname.<domínio> e um ou dois _acme-challenge.<domínio>, para validar o domínio e emitir o certificado SSL.

4. Configurando os registros na Cloudflare

Agora, você deve levar as informações da Square Cloud para o painel da Cloudflare.

No painel da Cloudflare, selecione o seu domínio e vá na aba DNS > Records.
Clique em Add Record.

Registro CNAME (Obrigatório)

Type: CNAME
Name: @ (se for o domínio principal) ou o nome do seu subdomínio (ex: www ou app).
Target: cname⁠.squareweb⁠.app.
Proxy Status: Mantenha em Proxied (Nuvem laranja) para garantir a proteção SSL e segurança.

Registros TXT (Obrigatórios)

Crie todos os registros que a aba Network mostrar, com o nome exato de cada um (nunca @):

TXT _cf-custom-hostname.<domínio> com o valor indicado.
Um ou dois TXT _acme-challenge.<domínio> (crie os dois quando aparecerem dois).
Se aparecer um CNAME _acme-challenge marcado como alternativa, use-o no lugar dos TXT _acme-challenge, nunca junto.

5. Validação final

Após salvar os registros na Cloudflare, retorne à aba Network na Square Cloud.

O sistema verificará os registros automaticamente. Quando tudo estiver correto, o status do domínio mudará para Active.

Redirecionamento de www para seu domínio

Para redirecionar o www para seu domínio, crie um registro A com o nome www apontando para 192.0.2.1 com o proxy ATIVO (é um IP fictício: o tráfego para na Cloudflare).
Em seguida, no Cloudflare, acesse Regras > Redirect Rules e crie uma nova regra:
Tipo: redirecionamento de www para o seu domínio
Código de status: 301 Redirecionamento permanente
URL de destino: Sua url configurada (Ex.: https://meusite.com/)

Dicas de troubleshooting

Propagação: Se o site não abrir, verifique se o CNAME está correto usando ferramentas como o DNS Checker.
Cache: Se você alterou os registros e não vê mudanças, tente limpar o cache do seu navegador ou o cache da Cloudflare na aba Caching > Configuration > Purge Everything.

Atualizado em: 04/10/2026

Este artigo foi útil?

Obrigado!