Solução de problemas no Modo de Integração: waiting, sync stopped e redirecionamentos que não disparam

Use esta página quando um domínio conectado por meio da sua própria plataforma (Modo de Integração) não se conecta, para de sincronizar ou um redirecionamento não é acionado. Abra o domínio em Hostnames primeiro: o status e o resultado da última verificação dizem por onde começar.

Status: Aguardando#

Aguardando significa que a RedirHub ainda não recebeu uma resposta correta do caminho de verificação no seu domínio. Abra https://your-domain/_redirhub/check em um navegador. Ela deve retornar uma pequena linha de texto simples que começa com token=.

• 404 ou sua própria página: a integração ainda não está em execução nesse hostname. Verifique se ela foi implantada, se está sendo executada neste hostname exato (www e o domínio raiz são separados) e se suas rotas permitem /_redirhub/check.
• Next.js: o middleware ou matcher do proxy deve incluir /_redirhub/check.
• Cloudflare Workers: a rota do Worker deve abranger o hostname, por exemplo shop.example.com/*.
• Um token diferente: a integração usa o endereço de regras de outro domínio ou workspace. Copie novamente o endereço de regras do painel.
• Nada (timeout, página de erro): a integração ainda não baixou seu primeiro arquivo de regras. Até que tenha um, ela não responde ao caminho de verificação. Verifique o endereço de regras nas configurações.

Status: Sincronização interrompida#

Sincronização interrompida significa que sua plataforma responde ao caminho de verificação, mas não executa mais as regras mais recentes: suas regras estão mais antigas do que as publicadas pela RedirHub. A RedirHub também envia um e-mail quando isso acontece.

• Verifique se a integração ainda consegue alcançar o endereço das regras (um firewall, uma variável de ambiente alterada ou uma implantação expirada são as causas mais comuns).
• Reimplante ou reinicie a integração após alterar as configurações.

Se um domínio permanecer fora de sincronização por 7 dias, o RedirHub o desativa. Corrija a integração e o domínio volta a se conectar na próxima verificação.

Um redirecionamento não dispara#

• Aguarde um minuto. A integração baixa novas regras cerca de uma vez por minuto (o Caddy pode atualizar em segundos).
• Teste em uma janela privada ou com curl -I. Os navegadores lembram redirecionamentos 301, então seu próprio navegador pode mostrar o resultado antigo.
• Seu site responde primeiro. Uma regra curinga só responde às URLs para as quais o seu site retorna 404. Se a página existir, o seu site vence. Use uma regra exata para esse caminho em vez disso.
• Next.js: chame os redirecionamentos primeiro no seu proxy, antes das reescritas e do tratamento de locale. Um matcher que ignora todos os caminhos com ponto também ignora regras como /old.html. Redirecionamentos em next.config são executados antes do proxy e podem sobrepor suas regras. O Next.js não serve regras curinga, porque o proxy nunca vê o status final do seu site.
• Não aplicado no Modo de Integração: HTML personalizado, redirecionamentos em frame, proteção por senha, links pausados ou expirados e domínios curinga. Um link com vários destinos usa seu destino principal.

Visitas ou 404s não aparecem nas análises#

• Os relatórios são enviados com a chave de integração do seu workspace. Verifique se a chave está definida na integração (como segredo ou variável de ambiente) e se é a atual.
• Os relatórios de 404 são enviados apenas quando o reporte de 404 está ativado para o domínio (por padrão, está) e a plataforma oferece suporte a isso.
• Os relatórios são enviados em segundo plano em pequenos lotes, então aguarde um ou dois minutos antes de verificar.

Ainda com problemas?#

Envie-nos o domínio, a sua plataforma e o que https://your-domain/_redirhub/check retorna. Verificaremos a integração do nosso lado.