Dominios Personalizados

Sirve tu documentación desde tu propio dominio en lugar del subdominio predeterminado *.jamdesk.app.

Descripción General de la Configuración

Opciones de Alojamiento

Al añadir un dominio, elige tu modo de alojamiento:

Dominio Estándar

Tu documentación se sirve directamente desde Jamdesk en tu dominio personalizado:

docs.example.com → acme.jamdesk.app

El DNS apunta a Jamdesk y los certificados SSL se gestionan automáticamente.

Alojar en /docs (Basado en Proxy)

Tu documentación se sirve en una subruta de tu sitio web existente:

example.com/docs → acme.jamdesk.app/docs

Configuras un proxy (Cloudflare, Vercel, nginx, etc.) para reenviar las solicitudes de /docs/* a Jamdesk. Consulta Alojamiento en Subruta para las guías de configuración.

Configuración DNS

Los registros que necesitas dependen de si usas un subdominio o un dominio apex (raíz).

Subdominios (p. ej., docs.example.com)

El campo "Nombre" es solo la parte del subdominio. Para docs.example.com, introduce docs.

Dominios Apex (p. ej., example.com)

Los dominios apex usan un registro A en lugar de CNAME porque los estándares DNS (RFC 1034) prohíben los registros CNAME en el apex de zona.

Verificación

Después de añadir los registros DNS, Jamdesk automáticamente:

1. Detecta tus registros DNS (CNAME o registro A, más TXT)
2. Verifica la propiedad del dominio mediante el registro TXT
3. Aprovisiona un certificado SSL a través de Let's Encrypt
4. Enruta el tráfico hacia tu documentación

Comprueba el estado de verificación en Configuración → Dominio. El estado se muestra como:

• Pendiente - Esperando la propagación DNS
• Activo - Dominio verificado y sirviendo tráfico
• Requiere Atención - Discrepancia o conflicto en la configuración (consulta la notificación por correo electrónico)
• Error - Problema de configuración (consulta los detalles en el dashboard)

Haz clic en Actualizar en el dashboard para comprobar manualmente el estado de verificación.

Certificados SSL

Los certificados SSL se aprovisionan automáticamente y se renuevan antes de su vencimiento. HTTPS es obligatorio, por lo que las solicitudes HTTP redirigen a HTTPS.

No se necesita configuración manual de certificados.

Dominios Raíz

Los dominios raíz (apex) como example.com son totalmente compatibles. El dashboard muestra automáticamente los registros correctos: un registro A apuntando a 76.76.21.21 en lugar de un CNAME, ya que los estándares DNS prohíben los registros CNAME en el apex de zona.

Si prefieres un subdominio como docs.example.com, también funciona.

Múltiples Dominios

Cada proyecto admite un dominio personalizado. Para varios dominios que apunten a la misma documentación:

1. Configura tu dominio principal en Jamdesk
2. Configura los dominios adicionales para que redirijan al principal a nivel DNS/CDN

Eliminar un Dominio

Para desconectar un dominio personalizado:

1. Ve a Configuración → Dominio
2. Haz clic en Eliminar Dominio
3. Tu documentación permanece accesible en el subdominio *.jamdesk.app

Usuarios de Cloudflare

Si usas Cloudflare como proveedor DNS:

1. Establece el estado del proxy en Solo DNS (icono de nube gris) durante la verificación del dominio
2. Deja que Vercel gestione SSL: desactiva "Usar siempre HTTPS" de Cloudflare para el subdominio de la documentación
3. Tras completar la verificación, puedes volver a activar el proxy (nube naranja)

Solución de Problemas

Verificar DNS con dig

# Check CNAME record (subdomains)
dig CNAME docs.example.com

# Check A record (apex domains)
dig A example.com

# Check TXT record
dig TXT _jamdesk.example.com

Para diagnósticos detallados, consulta Solución de Problemas DNS.

¿Qué sigue?