Solución alternativa para la página de mantenimiento: ¿se puede hacer esto?

Soporte Instalación
23

jaja me alegra que lo preguntes porque no me tomé el tiempo de explicar esta parte (debería haberlo hecho, ¡hay mucho que explicar y Cloudflare es complejo!).

Cuando se configura la ruta de workers, cada carga de imagen y visualización de página en el foro se enruta a través de ese worker.

El plan gratuito de CDN de Cloudflare incluye un límite de 100.000 solicitudes/día en una ruta de worker.

Por lo tanto, si tienes un foro relativamente activo, para evitar alcanzar el límite de tu nivel gratuito en un día, es una buena idea no tenerlo activado todo el tiempo. Esto se refiere solo a la ruta del worker, no a la página de mantenimiento; puedes dejar la página de mantenimiento activada todo el tiempo, ya que no se activa a menos que tengas la ruta del worker asignada. Esto se refiere solo a la parte del paso 2 donde asignaste la ruta (que es fácil de configurar y eliminar). A menos que uses un plan de pago de Cloudflare, es una buena práctica tenerlo activado solo cuando estás realizando tu propio mantenimiento.

  1. Ve a la página de rutas de workers de Cloudflare para tu dominio y haz clic en el botón del lado derecho de la ruta.

Screenshot 2026-08-01 at 5.06.14 PM
Screenshot 2026-08-01 at 5.06.14 PM1652×552 43.9 KB

  1. En la parte inferior de la pantalla de edición, haz clic en el botón remove para desvincular la página de worker de la ruta.

Screenshot 2026-08-01 at 5.09.01 PM
Screenshot 2026-08-01 at 5.09.01 PM742×658 40.5 KB

  1. No te preocupes, el código del worker en sí no se eliminará, solo la regla de enrutamiento. La próxima vez que realices una reconstrucción/actualización, simplemente puedes volver a agregarlo como en el paso 2 anterior.

Si tienes un plan de pago de Cloudflare, no tienes nada de qué preocuparte. Sin embargo, en ese caso, puedes usar las páginas de error de Cloudflare en lugar de una página de workers… (¿mencioné que Cloudflare es bastante complejo? jajaja).

:warning: configuración avanzada de administrador a continuación

Si alguien desea automatizar completamente sus actualizaciones en el plan gratuito, debería usar un token de API de Cloudflare, su zone-id y un comando curl para obtener el route id de los workers. Luego, edita el script /root/update-web.sh con algunas cosas más divertidas para activar y desactivar la ruta del worker automáticamente:

#!/bin/bash
cd /var/discourse

CF_TOKEN="tu_token_real_aquí" #<---token de API de Cloudflare
ZONE_ID="xxxx" #<---de tu página de perfil de Cloudflare
ROUTE_ID="xxxx"
WORKER_NAME="my-site-maintenance-page"

echo "➡️ Descargando los últimos scripts de Docker de Discourse..."
git pull

echo "➡️ Preparando nuevo contenedor web en segundo plano..."
./launcher bootstrap web_only

if [ $? -eq 0 ]; then
    echo "✅ ¡Bootstrap exitoso!"
    
    # Activar el Worker de Mantenimiento de Cloudflare
    echo "🚧 Habilitando página de mantenimiento..."
    curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/workers/routes/$ROUTE_ID" \
         -H "Authorization: Bearer $CF_TOKEN" \
         -H "Content-Type: application/json" \
         --data '{"pattern":"*your-site.com/*","script":"'$WORKER_NAME'"}' > /dev/null

    # Intercambiar los contenedores (Ventana de tiempo de inactividad de 30 segundos)
    echo "🔄 Intercambiando contenedores..."
    ./launcher destroy web_only && ./launcher start web_only
    
    # Desactivar el Worker de Mantenimiento de Cloudflare
    echo "🌍 Deshabilitando página de mantenimiento..."
    curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/workers/routes/$ROUTE_ID" \
         -H "Authorization: Bearer $CF_TOKEN" \
         -H "Content-Type: application/json" \
         --data '{"pattern":"*your-site.com/*","script":null}' > /dev/null

    echo "🚀 ¡Hecho! Sitio actualizado con cero tiempo de inactividad visible."
else
    echo "❌ ¡Bootstrap fallido! Abortando intercambio para mantener el sitio actual en línea."
fi

Uso la versión anterior del script porque no me importa automatizar todo y me gusta estar presente para hacer actualizaciones/reconstrucciones. Simplemente añado la ruta de workers justo antes de hacer una actualización y luego la elimino después. Solo toma unos segundos.

Mis pasos generales son:

  1. Añadir la ruta de workers en Cloudflare
  2. Conectarse vía SSH a Hetzner
  3. Realizar cualquier actualización del sistema (por ejemplo: sudo apt update && sudo apt upgrade -y, luego reiniciar el servidor si es necesario)
  4. Volver a conectarse vía SSH si fue necesario reiniciar
  5. Ejecutar ./update-web.sh
  6. Eliminar la ruta de workers en Cloudflare