Modo de integración: usa RedirHub sin cambiar tu DNS

El Modo de integración conecta un dominio a RedirHub sin cambiar su DNS ni añadir ningún registro DNS. Su sitio conserva su DNS, hosting y certificado HTTPS. Su propia plataforma descarga las reglas del dominio desde RedirHub, sirve las redirecciones, los enlaces cortos y los enlaces de códigos QR que gestione en el panel, y notifica cada visita de vuelta, de modo que el dominio aparece en el mismo panel y análisis que un dominio conectado por DNS.

Está diseñado para los casos en los que apuntar el DNS a RedirHub no es una opción: el DNS está en manos de TI o de un cliente, el dominio ya sirve un sitio web en producción, o quiere enlaces cortos y redirecciones en su dominio principal junto a sus propias páginas.

Cómo funciona#

1. Archivo de reglas. RedirHub publica un archivo de reglas de texto plano para cada dominio conectado de esta forma. Su plataforma lo descarga aproximadamente una vez por minuto (Caddy también puede recibir un push en uno o dos segundos), por lo que un cambio en el panel entra en vigor sin necesidad de volver a desplegar.
2. Ruta de comprobación. Su plataforma responde en /_redirhub/check en el dominio. La primera respuesta correcta demuestra que el dominio le pertenece y lo conecta; RedirHub sigue llamándolo para ver si su plataforma ejecuta las reglas más recientes.
3. Redirecciones. Las reglas exactas redirigen antes de las propias rutas de su sitio. Un comodín solo responde a las URL que su sitio devuelve con 404, así que una página que funciona nunca es tomada por completo.
4. Informes. Cada redirección se notifica en segundo plano, sin retrasar al visitante. Cuando la plataforma lo admite, también se notifican los 404 que devuelve su sitio, de modo que los enlaces rotos aparecen después de una migración.

Si RedirHub no puede ser alcanzado, su plataforma conserva las últimas reglas que descargó y sigue redirigiendo. Las integraciones fallan de forma abierta: un error nunca rompe una página.

Plataformas compatibles#

• Cloudflare Workers: un Worker delante de su origen. Código abierto: redirhub/cloudflare-redirects.
• Next.js (en Vercel o autohospedado con next start): se ejecuta en tu proxy o middleware. Código abierto: redirhub/nextjs-redirects.
• Caddy: un módulo de Caddy para tus propios servidores, con HTTPS bajo demanda para los nombres de host en tus reglas. Código abierto: redirhub/caddy-redirects.

El formato del archivo de reglas es abierto, así que cualquiera puede escribir un cliente para otra plataforma: redirhub/integration-spec.

Configúralo#

1. En el panel, añade el dominio en Nombres de host y elige Conectar a través de tu propia plataforma. No se necesita ningún registro DNS.
2. Elige tu plataforma. El panel muestra la dirección de las reglas y la clave de integración de tu espacio de trabajo, además de un aviso con ambos ya rellenados.
3. Pega el aviso en tu agente de codificación con IA (Claude, Cursor, ChatGPT y otros) o sigue a mano el README de la plataforma. Mantén en secreto la clave de integración: va en una variable de entorno o en un secreto, nunca en código público.
4. Despliega. El dominio cambia a Conectado en cuanto la ruta de comprobación responde.

¿Conexión DNS o Modo de Integración?#

Usa la conexión DNS cuando el dominio solo redirige (un dominio de reserva, un dominio antiguo después de una migración): la red perimetral de RedirHub lo sirve y gestiona el HTTPS por ti. Usa el Modo de Integración cuando el dominio ya ejecuta un sitio web que quieres conservar, o cuando no puedes cambiar su DNS.

Lo que no hace el modo de integración#

• El certificado HTTPS permanece con tu plataforma; RedirHub no emite uno para el dominio.
• Cada dominio admite hasta 50.000 reglas de redirección. Los dominios comodín no son compatibles.
• El HTML personalizado, las redirecciones dentro de marcos, la protección con contraseña y los enlaces pausados o caducados no se aplican. Un enlace con varios destinos usa su destino principal.

El modo de integración está incluido en Core, Pro y Enterprise. Las redirecciones servidas de esta manera cuentan para las visitas mensuales del plan, igual que las redirecciones servidas por el edge de RedirHub.