Soporte
Integration Mode

Solución de problemas del modo de integración: en espera, sincronización detenida y redirecciones que no se activan

Usa esta página cuando un dominio conectado a través de tu propia plataforma (modo de integración) no se conecte, deje de sincronizarse o no se active una redirección. Abre primero el dominio en Hostnames: su estado y el resultado de la última comprobación te indicarán por dónde empezar.

Estado: En espera#

En espera significa que RedirHub aún no ha recibido una respuesta correcta de la ruta de comprobación en tu dominio. Abre https://your-domain/_redirhub/check en un navegador. Debería devolver una línea corta de texto sin formato que empiece por token=.

  • 404 o tu propia página: la integración aún no se está ejecutando en ese hostname. Comprueba que está desplegada, que se ejecuta en este hostname exacto (www y el dominio raíz son independientes) y que tus rutas permiten pasar /_redirhub/check.
  • Next.js: el middleware o el matcher del proxy debe incluir /_redirhub/check.
  • Cloudflare Workers: la ruta del Worker debe cubrir el hostname, por ejemplo shop.example.com/*.
  • Un token diferente: la integración usa la dirección de reglas de otro dominio o espacio de trabajo. Copia de nuevo la dirección de reglas desde el panel.
  • Nada en absoluto (tiempo de espera agotado, página de error): la integración aún no ha descargado su primer archivo de reglas. Hasta que tenga uno, no responde a la ruta de comprobación. Revisa la dirección de reglas en su configuración.

Estado: Sincronización detenida#

Sincronización detenida significa que tu plataforma responde a la ruta de comprobación pero ya no ejecuta las reglas más recientes: sus reglas son anteriores a las que publicó RedirHub. RedirHub también te envía un correo electrónico cuando esto ocurre.

  • Comprueba que la integración todavía puede الوصول a la dirección de las reglas (un firewall, una variable de entorno cambiada o un despliegue caducado suelen ser las causas).
  • Vuelve a desplegar o reinicia la integración después de cambiar su configuración.

Si un dominio permanece desincronizado durante 7 días, RedirHub lo desactiva. Corrige la integración y el dominio se conectará de nuevo en la siguiente comprobación.

No se activa una redirección#

  • Espera un minuto. La integración descarga nuevas reglas aproximadamente una vez por minuto (Caddy puede actualizarse en cuestión de segundos).
  • Prueba en una ventana privada o con curl -I. Los navegadores recuerdan las redirecciones 301, así que tu propio navegador puede mostrar el resultado antiguo.
  • Tu sitio responde primero. Una regla comodín solo responde a las URLs para las que tu sitio devuelve 404. Si la página existe, tu sitio gana. Usa en su lugar una regla exacta para esa ruta.
  • Next.js: llama primero a las redirecciones en tu proxy, antes de las reescrituras y el manejo de idiomas. Un matcher que omite cualquier ruta con un punto también omite reglas como /old.html. Las redirecciones en next.config se ejecutan antes del proxy y pueden ocultar tus reglas. Next.js no sirve reglas comodín, porque el proxy nunca ve el estado final de tu sitio.
  • No se aplica en el modo de integración: HTML personalizado, redirecciones de iframe, protección con contraseña, enlaces pausados o caducados y dominios comodín. Un enlace con varios destinos usa su destino principal.

Las visitas o los 404 no aparecen en las analíticas#

  • Los informes se envían con la clave de integración de tu espacio de trabajo. Comprueba que la clave esté configurada en la integración (como secreto o variable de entorno) y que sea la actual.
  • Los informes de 404 solo se envían cuando la notificación de 404 está activada para el dominio (lo está de forma predeterminada) y la plataforma lo admite.
  • Los informes se envían en segundo plano en pequeños lotes, así que espera uno o dos minutos antes de comprobarlo.

¿Sigues atascado?#

Envíanos el dominio, tu plataforma y lo que devuelve https://your-domain/_redirhub/check. Revisaremos la integración de nuestro lado.

Preguntas frecuentes

RedirHub aún no ha recibido una respuesta correcta de la ruta de comprobación en tu dominio. Normalmente la integración aún no está desplegada, o no se ejecuta en ese hostname o en /_redirhub/check.

La integración descarga las reglas aproximadamente una vez por minuto (Caddy puede actualizar en cuestión de segundos). Los navegadores también recuerdan las redirecciones 301: prueba en una ventana privada o con curl -I.

Un matcher de middleware común omite cualquier ruta con un punto, así que reglas como /old.html nunca llegan al proxy. Las redirecciones en next.config también se ejecutan primero y pueden eclipsar tus reglas.

Ayuda relacionada

Ver todos los artículos