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

# Cómo configurar tu propio dominio (CNAME/DNS)

## 1. Prerrequisitos

Antes de iniciar el proceso, asegúrate de cumplir con los siguientes requisitos:

* **Plan Standard o superior:** Square Cloud permite la configuración de dominios personalizados únicamente para usuarios a partir del plan Standard.
* **Un dominio registrado:** Debes poseer un dominio adquirido en proveedores como **Registro.br**, **Namecheap**, **GoDaddy**, **Google Domains** u otro.
* **Cuenta en Cloudflare:** Utilizaremos Cloudflare para gestionar los registros de DNS, lo que garantiza protección contra ataques DDoS y una mayor velocidad de carga (CDN).

---

## 2. ¿Qué son los Nameservers?

Antes de configurar el sitio, necesitas entender el concepto de **Nameservers** (Servidores de Nombres).

> **Definición:** Los Nameservers son como la "guía telefónica" de internet. Indican qué servicio es el responsable de gestionar los registros de tu dominio. Cuando cambias los Nameservers hacia Cloudflare, le estás diciendo a internet: "Quien se encarga de la ruta hacia mi sitio ahora es Cloudflare".

### Transferencia de la gestión a Cloudflare

Si tu dominio fue comprado en Registro.br, GoDaddy u otro, deberás apuntarlo a Cloudflare siguiendo estos pasos:

1. Crea una cuenta gratuita en [Cloudflare](https://dash.cloudflare.com/sign-up).
2. Haz clic en **"Add a Site"** e introduce tu dominio (ej: `misitio.com`).
3. Cloudflare te proporcionará dos direcciones de Nameservers (ej: `nina.ns.cloudflare.com` y `tom.ns.cloudflare.com`).
4. Accede al panel de tu proveedor (donde compraste el dominio).
5. Busca la opción **Cambiar Servidores de Nombres** o **DNS**.
6. Sustituye las direcciones actuales por las proporcionadas por Cloudflare y guarda los cambios.
7. **Espera:** La propagación puede tardar desde unos minutos hasta 24 horas.

---

## 3. Configuración en Square Cloud

Con la gestión de DNS ya en Cloudflare, vamos a preparar tu aplicación en Square Cloud.

1. Accede al [Dashboard de Square Cloud](https://squarecloud.app/dashboard).
2. Selecciona la aplicación que deseas vincular al dominio.
3. In el menú, haz clic en la pestaña **Configurações** (Configuraciones) y selecciona la subpestaña **Network**.
4. En el campo de texto, escribe tu dominio o subdominio (ej: `misitio.com` o `api.misitio.com`).
5. Haz clic en **Salvar** (Guardar).
6. El sistema mostrará los registros necesarios:
* **CNAME:** Una dirección de destino (cname.squareweb.app).
* **TXT (si se genera):** Un código de verificación para validar la propiedad del dominio.

---

## 4. Configurando los registros en Cloudflare

Ahora, debes trasladar la información de Square Cloud al panel de Cloudflare.

1. En el panel de Cloudflare, selecciona tu dominio y ve a la pestaña **DNS** > **Records**.
2. Haz clic en **Add Record**.

### Registro CNAME (Obligatorio)
* **Type:** CNAME
* **Name:** `@` (si es el dominio principal) o el nombre de tu subdominio (ej: `www` o `app`).
* **Target:** cname.squareweb.app.
* **Proxy Status:** Mantenlo en **Proxied** (Nube naranja) para garantizar la protección SSL y la seguridad.

### Registro TXT (Si aplica)
* **Type:** TXT
* **Name:** `@` o el nombre indicado por el dashboard.
* **Content:** Pega el código de verificación generado.

---

## 5. Validación final

Después de guardar los registros en Cloudflare, regresa a la pestaña **Network** en Square Cloud. 

* El sistema verificará los registros automáticamente. Cuando todo esté correcto, el estado del dominio cambiará a **Active**.

---

## Redirección de www hacia tu dominio
* Para redireccionar el `www` hacia tu dominio, crea un nuevo registro con el nombre **www** y tipo **A**, apuntando a `192.0.2.1` (IP interna de Cloudflare).
* A continuación, en Cloudflare, accede a **Regras de Página** (Page Rules) y crea una nueva regla: 
* Configuración: URL de reenvío (Forwarding URL)
* Código de estado: 301 Redirección permanente
* URL de destino: Tu URL configurada (Ej.: https://misitio.com/)

## Consejos de troubleshooting (Resolución de problemas)
* **Propagación:** Si el sitio no abre, verifica si el CNAME es correcto utilizando herramientas como [DNS Checker](https://dnschecker.org/).
* **Caché:** Si cambiaste los registros y no ves los cambios, intenta limpiar el caché de tu navegador o el caché de Cloudflare en la pestaña **Caching** > **Configuration** > **Purge Everything**.