Cómo usar un dominio personalizado en tu app

Toda app alojada nace con una dirección técnica, algo como miapp.ejemplo-host.app. Funciona, pero nadie quiere enviar ese enlace a un cliente. Un dominio personalizado cambia esa dirección por misitio.com o app.misitio.com, y la app sigue siendo la misma.

El proceso siempre involucra tres piezas: el dominio, registrado en tu registrador; el DNS, donde indicas a dónde apunta cada nombre; y el hosting, que debe reconocer ese nombre para servir la app y emitir el certificado. Si una pieza no coincide con las otras, el dominio no carga.

¿Qué necesito antes de empezar?#

• Un dominio registrado a tu nombre, en cualquier registrador (Namecheap, GoDaddy, Porkbun y otros).
• Acceso al panel de DNS del dominio. Si el DNS está delegado a otro proveedor, como Cloudflare, lo editas allí.
• Una app web en línea en el hosting, respondiendo en su dirección técnica.
• Un plan que permita dominio propio. No todos los hostings lo ofrecen en todos los planes, así que compruébalo antes de empezar.

Si aún no tienes clara la diferencia entre comprar un dominio y contratar hosting, mira dominio vs. hosting.

¿Raíz, www o subdominio: cuál uso?#

Para el DNS, los tres son nombres distintos:

• Raíz (misitio.com): el nombre sin prefijo, también llamado apex.
• www (www.misitio.com): un subdominio como cualquier otro.
• Otro subdominio (app.misitio.com, api.misitio.com): útil para separar la app del sitio corporativo.

La diferencia práctica está en el tipo de registro. Según la RFC 1034, un CNAME no puede convivir con otros datos en el mismo nombre, y la raíz siempre tiene registros NS y SOA. Por eso la raíz suele usar un registro A (o AAAA, para IPv6), mientras que www y los demás subdominios usan CNAME. Algunos proveedores de DNS ofrecen CNAME flattening, que permite apuntar la raíz a un nombre; otros llaman ALIAS o ANAME a funciones parecidas.

Si dudas, empieza por un subdominio: es el camino con menos restricciones.

¿Cómo añado el dominio, paso a paso?#

1. Añade el dominio en el hosting. En el panel de la app, escribe exactamente el nombre que la gente va a teclear, por ejemplo app.misitio.com.

2. Copia los registros que muestra el hosting. Te indica el tipo (A o CNAME) y el valor de destino. Usa siempre esos valores, nunca los de otro tutorial.

3. Crea los registros en el DNS. Ejemplo genérico para un subdominio:

   Tipo	Nombre (host)	Valor	TTL
   CNAME	app	destino-del-hosting.ejemplo	300

   Y para la raíz y el www:

   Tipo	Nombre (host)	Valor	TTL
   A	@	203.0.113.10	300
   CNAME	www	misitio.com.	300

   Los valores destino-del-hosting.ejemplo y 203.0.113.10 son ficticios.

4. Elimina conflictos. Un registro A o AAAA antiguo en el mismo nombre que un CNAME suele hacer que el panel rechace el registro.

5. Espera al DNS y a la validación. Cuando el hosting vea el registro, aceptará el dominio.

Si tu panel de DNS completa el dominio solo, escribe únicamente el prefijo (app). Si escribes el nombre entero, el resultado es app.misitio.com.misitio.com, un error muy común. Los pasos de DNS con más detalle están en cómo apuntar un dominio a tu hosting.

¿Cómo sé si el dominio funciona?#

Consulta el DNS directamente, sin pasar por la caché del navegador:

dig app.misitio.com CNAME +short
dig misitio.com A +short

La respuesta debe ser el destino que te dio el hosting. Después comprueba el HTTP y el certificado:

curl -I https://app.misitio.com

Un estado 200 (o una redirección esperada) con el certificado aceptado significa que todo está bien. Si dig ya responde bien pero el navegador muestra la dirección antigua, la causa es la caché: prueba en una ventana de incógnito.

El tiempo que tarda el cambio depende del TTL del registro anterior, que los resolvedores guardan en caché. Un nombre nuevo suele resolver en minutos; cambiar un registro existente con TTL de 3600 puede tardar hasta una hora. Antes de migrar un dominio en uso, baja el TTL a 300 y espera a que caduque el valor antiguo.

¿Y el HTTPS?#

El certificado solo puede emitirse cuando el dominio ya resuelve hacia el hosting, porque tienes que demostrarle a la autoridad certificadora que controlas el nombre. En hostings con TLS automático, la emisión ocurre sola justo después. Para entender el mecanismo, mira cómo funciona Let's Encrypt.

Los registros CAA restringen qué autoridades pueden emitir certificados para tu dominio (RFC 8659). Sin ningún CAA, cualquier autoridad puede emitir. Si tienes alguno, incluye la autoridad que usa tu hosting. En el caso de Let's Encrypt, el valor es letsencrypt.org, según su documentación:

misitio.com.  CAA  0 issue "letsencrypt.org"

Confirma con tu hosting qué autoridad usa antes de crear un registro CAA.

¿Cuáles son los errores más comunes?#

• CNAME en la raíz: el panel lo rechaza. Usa A o un proveedor con CNAME flattening.
• Registro en conflicto: un A antiguo en el mismo nombre que el CNAME.
• Nameservers equivocados: editas el DNS en el registrador, pero el dominio está delegado a otro proveedor. Compruébalo con dig NS misitio.com +short.
• Solo un nombre configurado: misitio.com abre y www.misitio.com no. Añade los dos.
• Proxy de Cloudflare activo durante la validación: un registro con proxy oculta el destino real y puede interferir con la validación. Prueba en solo DNS.
• CAA bloqueando la emisión: mira la sección anterior.
• Error de dominio inexistente: mira DNS_PROBE_FINISHED_NXDOMAIN.

Si el navegador muestra un error de certificado, la guía de errores de certificado SSL explica las causas.

Cómo hacerlo en Square Cloud#

En Square Cloud, las tres piezas de esta guía quedan bien separadas. El dominio sigue registrado a tu nombre en tu registrador, la zona DNS sigue en el registrador o en el proveedor de DNS que elegiste, y la plataforma reconoce el nombre y entrega el HTTPS. El dominio personalizado está disponible desde el plan Standard (desde R$44,99 al mes). El Hobby no lo incluye y usa el subdominio *.squareweb.app, que toda aplicación web recibe con HTTPS en todos los planes.

Los pasos son los de la sección anterior, con valores fijos. En el panel de la aplicación, agregas el dominio y ves los dos registros que debes crear: un CNAME a cname.squareweb.app y un TXT de validación. El estado de la validación aparece en tiempo real, y el certificado se emite y se renueva automáticamente cuando el DNS resuelve. Para usar la raíz, tu proveedor de DNS tiene que aceptar CNAME en la raíz (flattening o ALIAS); para www, lo recomendado es redirigirlo al dominio principal. Se aceptan dominios con tildes (Punycode), y el panel ofrece purga de caché.

Con el dominio activo, el mismo nombre puede atender a más de una aplicación con load balancing. Consulta los detalles en dominios personalizados y compara los planes en precios.