Dominios y DNS

Tabla de Contenidos

1. Dominio Raiz
2. Mapa de Subdominios
3. Convencion de Nombres
4. Tipos de Registros DNS
5. Arbol de Subdominios por Ambiente
6. Flujo de Resolucion DNS
7. Configuracion Cloudflare
8. Troubleshooting DNS

1. Dominio Raiz

El dominio principal de Nvito es nvito.mx, registrado y gestionado integramente a traves de Cloudflare Registrar. Esta decision consolida DNS, proxy, SSL, WAF y registrar en un solo proveedor, eliminando la necesidad de coordinar nameservers entre servicios.

2. Mapa de Subdominios

Nvito utiliza 16 subdominios distribuidos en 3 ambientes (produccion, DEV y TEST). Cada subdominio apunta a un servicio especifico con un proposito bien definido.

2.1 Produccion

2.2 DEV (rama develop)

2.3 TEST (rama test)

3. Convencion de Nombres

La convencion de nombres sigue un patron predecible que permite identificar inmediatamente el ambiente y el servicio de cualquier subdominio.

Produccion

{servicio}.nvito.mx

Donde {servicio} es uno de: app, inv, api, cdn, admin, docs. El dominio raiz nvito.mx se reserva para la landing page.

Ambientes no productivos

{env}-{servicio}.nvito.mx

Donde {env} es dev o test, y {servicio} es el mismo identificador que en produccion.

Ejemplos

4. Tipos de Registros DNS

Nvito utiliza 4 tipos principales de registros DNS en Cloudflare, cada uno con un proposito distinto.

4.1 Registro A (Address)

Apunta un subdominio a una direccion IPv4 fija. Se usa para los subdominios que apuntan al VPS de Contabo donde corre Coolify.

dev-api.nvito.mx      A    212.28.185.197    Proxied
dev-admin.nvito.mx    A    212.28.185.197    Proxied
test-api.nvito.mx     A    212.28.185.197    Proxied
test-admin.nvito.mx   A    212.28.185.197    Proxied

Todos apuntan a la misma IP del VPS. Traefik (dentro de Coolify) rutea al contenedor correcto segun el header Host.

4.2 Registro CNAME (Canonical Name)

Apunta un subdominio a otro dominio (alias). Se usa para servicios managed que proveen su propio dominio.

nvito.mx              CNAME    nvito-landing.pages.dev         # Cloudflare Pages
docs.nvito.mx         CNAME    nvito-docs.pages.dev            # Cloudflare Pages
cdn.nvito.mx          CNAME    {account}.r2.cloudflarestorage.com  # R2 Custom Domain
app.nvito.mx          CNAME    {service}.up.railway.app        # Railway (futuro)

4.3 Registro TXT (Text)

Almacena texto arbitrario. Se usa principalmente para verificacion de propiedad y seguridad de email.

nvito.mx              TXT    "v=spf1 include:_spf.google.com ~all"
_dmarc.nvito.mx       TXT    "v=DMARC1; p=quarantine; rua=mailto:dmarc@nvito.mx"

4.4 Registro MX (Mail Exchange)

Define los servidores de correo entrante. Actualmente no se recibe correo en nvito.mx, pero se configura si se necesita en el futuro.

5. Arbol de Subdominios por Ambiente

6. Flujo de Resolucion DNS

Cuando un usuario accede a cualquier subdominio de Nvito, el flujo de resolucion pasa por Cloudflare antes de llegar al origin server.

Puntos clave del flujo

1. Anycast: Cloudflare utiliza una red Anycast global. El DNS siempre resuelve a la IP del edge node mas cercano al usuario, no a la IP real del origin.
2. Proxy mode: Todos los subdominios tienen el proxy de Cloudflare habilitado (icono naranja en el dashboard). Esto oculta la IP real del origin.
3. SSL termination: Cloudflare termina SSL en el edge y re-encripta la conexion al origin (modo Full).
4. Cache: Los assets estaticos (imagenes, CSS, JS) se cachean en el edge. Las respuestas de API no se cachean.

7. Configuracion Cloudflare

7.1 SSL/TLS

7.2 Proxy Mode

Todos los subdominios activos tienen el proxy de Cloudflare habilitado (icono naranja). Esto significa que:

• La IP real del origin nunca se expone en respuestas DNS publicas
• Todo el trafico pasa por el edge de Cloudflare para DDoS protection, WAF y cache
• Los headers CF-Connecting-IP y X-Forwarded-For contienen la IP real del cliente

7.3 TTL de Registros DNS

Cuando un registro esta proxied, Cloudflare ignora el TTL configurado y usa su propio (tipicamente 300 segundos). Esto permite propagacion rapida de cambios.

7.4 Page Rules y Configuration Rules

8. Troubleshooting DNS

8.1 Propagacion DNS

Problema: Un cambio de DNS no se refleja inmediatamente.

Diagnostico:

# Verificar resolucion actual
dig admin.nvito.mx +short

# Verificar directamente contra nameservers de Cloudflare
dig @1.1.1.1 admin.nvito.mx +short

# Verificar TTL restante
dig admin.nvito.mx +noall +answer

Solucion: Los registros proxied de Cloudflare propagan en segundos. Si el cambio no se refleja, limpiar cache DNS local (sudo dscacheutil -flushcache en macOS) y verificar que no haya cache del browser.

8.2 Error 526 (Invalid SSL Certificate)

Problema: Cloudflare muestra error 526 al acceder a un subdominio.

Causa: El modo SSL esta en "Full (Strict)" pero el origin no tiene un certificado valido.

Solucion:

1. Verificar que el origin tiene SSL (Let's Encrypt via Coolify/Traefik, o Railway auto-SSL)
2. Si el certificado expiro, renovar en Coolify o cambiar temporalmente a modo "Full" (sin Strict)
3. Para origins sin SSL propio, usar un Cloudflare Origin Certificate (15 anos, gratuito)

8.3 Proxy Mode vs DNS Only

Problema: Un subdominio no carga o muestra timeout.

Diagnostico: Verificar si el registro esta proxied:

# Si retorna IP de Cloudflare (104.x.x.x, 172.x.x.x) → proxied
# Si retorna IP del VPS (212.28.185.197) → DNS Only
dig admin.nvito.mx +short

Causa comun: Si el registro esta en DNS Only, el trafico va directo al VPS sin pasar por Cloudflare. Si el VPS no tiene SSL configurado para ese dominio, el navegador rechaza la conexion.

8.4 Cache de Cloudflare

Problema: Cambios en la aplicacion no se reflejan en el navegador.

Solucion:

1. Purge cache en Cloudflare: Dashboard > Caching > Purge Everything (o por URL especifica)
2. Development Mode: Activar temporalmente en Cloudflare para bypass de cache (3 horas)
3. Verificar headers de cache: curl -I https://cdn.nvito.mx/path/to/asset y revisar CF-Cache-Status