yoursite.com/docs con Cloudflare, deberás crear y configurar un Cloudflare Worker.
Antes de comenzar, necesitas una cuenta de Cloudflare y un nombre de dominio (que puede gestionarse dentro o fuera de Cloudflare).
Estructura del repositorio
yoursite.com/docs, crea un directorio docs/ con todos los archivos de documentación.
Configura un Cloudflare Worker
Proxies con implementaciones de Vercel
Lista de rutas permitidas requerida
/.well-known/acme-challenge/*- Obligatorio para la verificación de certificados de Let’s Encrypt/.well-known/vercel/*- Obligatorio para la verificación de dominios de Vercel
Requisitos para el reenvío de encabezados
HOST se reenvíe correctamente en la configuración de tu Worker. Si los encabezados no se reenvían adecuadamente, las solicitudes de verificación fallarán.
Configurar el enrutamiento
Después de configurar tu DNS, los subdominios personalizados suelen estar disponibles en pocos minutos. La propagación del DNS a veces puede tardar entre 1 y 4 horas y, en casos poco frecuentes, hasta 48 horas. Si tu subdominio 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 redirige a tu documentación de Mintlify y a tu sitio web.
Agregar un dominio personalizado
- En tu panel de Cloudflare, ve a tu Worker.
- Ve a Settings > Domains & Routes > Add > Custom Domain.
- Agrega tu dominio.
Resolver conflictos de DNS
- Elimina el registro DNS existente para tu dominio. Consulta Delete DNS records en la documentación de Cloudflare para obtener más información.
- Vuelve a tu Worker y añade tu dominio personalizado.
Enrutamiento personalizado en Webflow
/docs dentro del mismo dominio, tendrás que configurar un enrutamiento personalizado con Cloudflare Workers para enrutar mediante proxy todo el tráfico que no sea de la documentación hacia tu sitio principal.
- En Webflow, configura una landing page para tu sitio principal, por ejemplo
landing.yoursite.com. Esta será la página que verán los visitantes cuando ingresen a tu sitio. - Despliega tu sitio principal en la landing page. 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.
- Selecciona Deploy y espera a que los cambios se propaguen.
Después de configurar tu DNS, los subdominios personalizados suelen estar disponibles en pocos minutos. La propagación del DNS a veces puede tardar entre 1 y 4 horas y, en casos poco frecuentes, hasta 48 horas. Si tu subdominio no está disponible de inmediato, espera antes de intentar solucionarlo.