yoursite.com/docs
con Cloudflare, tendrás que crear y configurar un Cloudflare Worker.
Antes de empezar, necesitas una cuenta de Cloudflare y un nombre de domain (puede gestionarse dentro o fuera de Cloudflare).
Estructura del repositorio
yoursite.com/docs
, crea un directorio docs/
con todos tus archivos de documentación.
Configura un Cloudflare Worker
Si tu proveedor de DNS es Cloudflare, no habilites el proxy para el registro CNAME.
Proxies con implementaciones de Vercel
Lista obligatoria de rutas permitidas
/.well-known/acme-challenge/*
- Obligatoria para la verificación de certificados de Let’s Encrypt/.well-known/vercel/*
- Obligatoria para la verificación del domain de Vercel
Requisitos para el reenvío de cabeceras
HOST
se reenvíe correctamente en la configuración de tu Worker. Si no se reenvían correctamente las cabeceras, las solicitudes de verificación fallarán.
Configurar el enrutamiento
Reemplaza
[SUBDOMAIN]
por tu subdomain único, [YOUR_DOMAIN]
por la URL base de tu sitio web y /docs
por la subruta que prefieras, si es diferente.Después de configurar tu DNS, los subdomains personalizados suelen estar disponibles en pocos minutos. La propagación de DNS a veces puede tardar de 1 a 4 horas y, en casos raros, hasta 48 horas. Si tu subdomain no está disponible de inmediato, espera antes de intentar solucionarlo.
Prueba tu Worker
- Prueba usando la URL de vista previa del Worker:
your-worker.your-subdomain.workers.dev/docs
- Verifica que el Worker dirija a tu documentación de Mintlify y a tu sitio web.
Agregar domain personalizado
- En tu dashboard de Cloudflare, ve a tu Worker.
- Ve a Settings > Domains & Routes > Add > Custom Domain.
- Agrega tu domain.
Recomendamos agregar tu domain tanto con
www.
como sin www.
al inicio.Resolver conflictos de DNS
- Elimina el registro DNS existente para tu domain. Consulta Eliminar registros DNS en la documentación de Cloudflare para obtener más información.
- Vuelve a tu Worker y agrega tu domain personalizado.
Enrutamiento personalizado en Webflow
/docs
en el mismo domain, tendrás que configurar un enrutamiento personalizado con Cloudflare Workers para enviar por proxy todo el tráfico que no sea de la documentación a tu sitio principal.
Asegúrate de que tu sitio principal esté configurado en una página de destino antes de implementar este Worker, o los visitantes de tu sitio principal verán errores.
- En Webflow, configura una página de destino para tu sitio principal, por ejemplo
landing.yoursite.com
. Esta será la página que verán los visitantes cuando accedan a tu sitio. - Implementa tu sitio principal en la página de destino. Esto garantiza que tu sitio principal siga siendo accesible mientras configuras el Worker.
- Para evitar conflictos, actualiza cualquier URL absoluta en tu sitio principal para que sea relativa.
- En Cloudflare, selecciona Edit Code y agrega el siguiente script en el código de tu Worker.
Reemplaza
[SUBDOMAIN]
con tu subdomain único, [YOUR_DOMAIN]
con la URL base de tu sitio web, [LANDING_DOMAIN]
con la URL de tu página de destino y /docs
con la subruta que desees si es diferente. - Selecciona Deploy y espera a que los cambios se propaguen.
Después de configurar tu DNS, los subdomains personalizados suelen estar disponibles en pocos minutos. La propagación de DNS a veces puede tardar de 1 a 4 horas y, en casos raros, hasta 48 horas. Si tu subdomain no está disponible de inmediato, espera antes de intentar solucionarlo.