Modo de Integração: use o RedirHub sem alterar o seu DNS

O Modo de Integração conecta um domínio ao RedirHub sem alterar o seu DNS ou adicionar qualquer registro DNS. O seu site mantém o DNS, a hospedagem e o certificado HTTPS. A sua própria plataforma baixa as regras do domínio do RedirHub, atende os redirecionamentos, links curtos e links de código QR que você gerencia no painel, e envia cada visita de volta, para que o domínio apareça no mesmo painel e nas mesmas análises que um domínio conectado por DNS.

Ele foi criado para os casos em que apontar o DNS para o RedirHub não é uma opção: o DNS fica com o TI ou com um cliente, o domínio já serve um site ao vivo, ou você quer links curtos e redirecionamentos no seu domínio principal, ao lado das suas próprias páginas.

Como funciona#

1. Arquivo de regras. O RedirHub publica um arquivo de regras em texto simples para cada domínio conectado desta forma. A sua plataforma o baixa cerca de uma vez por minuto (o Caddy também pode receber um push em um ou dois segundos), então uma alteração no painel entra em vigor sem novo deploy.
2. Caminho de verificação. A sua plataforma responde a /_redirhub/check no domínio. A primeira resposta correta prova que o domínio é seu e o conecta; o RedirHub continua chamando esse caminho para ver se a sua plataforma está executando as regras mais recentes.
3. Redirecionamentos. Regras exatas redirecionam antes das rotas do seu próprio site. Um fallback atende apenas URLs que o seu site retorna 404, então uma página funcional nunca é substituída.
4. Relatórios. Cada redirecionamento é reportado em segundo plano, sem atrasar o visitante. Onde a plataforma oferece suporte, os 404 que o seu site retorna também são reportados, para que links quebrados apareçam após uma migração.

Se o RedirHub não puder ser alcançado, a sua plataforma mantém as últimas regras que baixou e continua redirecionando. As integrações falham de forma aberta: um erro nunca quebra uma página.

Plataformas suportadas#

• Cloudflare Workers: um Worker na frente da sua origem. Código aberto: redirhub/cloudflare-redirects.
• Next.js (no Vercel ou auto-hospedado com next start): executa no seu proxy ou middleware. Código aberto: redirhub/nextjs-redirects.
• Caddy: um módulo Caddy para seus próprios servidores, com HTTPS sob demanda para os nomes de host nas suas regras. Código aberto: redirhub/caddy-redirects.

O formato do arquivo de regras é aberto, então qualquer pessoa pode criar um cliente para outra plataforma: redirhub/integration-spec.

Configure#

1. No painel, adicione o domínio em Nomes de host e escolha Conectar por meio da sua própria plataforma. Nenhum registro DNS é necessário.
2. Escolha sua plataforma. O painel mostra o endereço das regras e a chave de integração da sua workspace, além de um prompt com ambos já preenchidos.
3. Cole o prompt no seu agente de codificação com IA (Claude, Cursor, ChatGPT e outros) ou siga o README da plataforma manualmente. Mantenha a chave de integração em segredo: ela vai em uma variável de ambiente ou segredo, nunca em código público.
4. Implante. O domínio muda para Conectado assim que o caminho de verificação responde.

Conexão DNS ou Modo de Integração?#

Use a conexão DNS quando o domínio apenas redireciona (um domínio reserva, um domínio antigo após uma mudança): a borda da RedirHub o atende e cuida do HTTPS para você. Use o Modo de Integração quando o domínio já executa um site que você deseja manter, ou quando não puder alterar o DNS dele.

O que o Modo de Integração não faz#

• O certificado HTTPS fica com a sua plataforma; a RedirHub não emite um para o domínio.
• Cada domínio comporta até 50.000 regras de redirecionamento. Domínios curinga não são suportados.
• HTML personalizado, redirecionamentos em frame, proteção por senha e links pausados ou expirados não são aplicados. Um link com vários destinos usa seu destino principal.

O Modo de Integração está incluído nos planos Core, Pro e Enterprise. Os redirecionamentos atendidos dessa forma contam para as visitas mensais do plano, da mesma forma que os redirecionamentos atendidos pela edge da RedirHub.