> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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**, **Google Domains** ou outra.
* **Conta na Cloudflare:** Utilizaremos a Cloudflare para gerenciar os registros de DNS, o que garante proteção contra ataques DDoS e maior velocidade de carregamento (CDN).

---

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

1.  Crie uma conta gratuita na [Cloudflare](https://dash.cloudflare.com/sign-up).
2.  Clique em **"Add a Site"** e digite o seu domínio (ex: `meusite.com.br`).
3.  A Cloudflare fornecerá dois endereços de Nameservers (ex: `nina.ns.cloudflare.com` e `tom.ns.cloudflare.com`).
4.  Acesse o painel da sua provedora (onde você comprou o domínio).
5.  Procure pela opção **Alterar Servidores de Nome** ou **DNS**.
6.  Substitua os endereços atuais pelos fornecidos pela Cloudflare e salve.
7.  **Aguarde:** A propagação pode levar de alguns minutos até 24 horas.

---

## 3. Configuração na Square Cloud

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

1.  Acesse o [Dashboard da Square Cloud](https://squarecloud.app/dashboard).
2.  Selecione a aplicação que você deseja vincular ao domínio.
3.  No menu, clique na aba **Configurações** e selecione a sub-aba **Network**.
4.  No campo de texto, digite o seu domínio ou subdomínio (ex: `meusite.com` ou `api.meusite.com`).
5.  Clique em **Salvar**.
6.  O sistema exibirá os registros necessários:
*  **CNAME:** Um endereço de destino (cname.squareweb.app).
* **TXT (se gerado):** Um código de verificação para validar a propriedade do domínio.

---

## 4. Configurando os registros na Cloudflare

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

1.  No painel da Cloudflare, selecione o seu domínio e vá na aba **DNS** > **Records**.
2.  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.

### Registro TXT (Se houver)
* **Type:** TXT
* **Name:** `@` ou o nome indicado pelo dashboard.
* **Content:** Cole o código de verificação gerado.

---

## 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 novo registro com o nome **www** e tipo **A**, apontando para `192.0.2.1` (IP interno do Cloudflare).
* Em seguida, no Cloudflare, acesse **Regras de Página** e crie uma nova regra: 
* Configuração: URL de encaminhamento
* 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](https://dnschecker.org/).
* **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**.