Criando Redirecionamentos Sem Servidor com Cloudflare Workers

Usar o Cloudflare Workers para criar redirecionamentos sem servidor significa capturar a solicitação do visitante na rede de borda da Cloudflare antes de chegar ao servidor de origem, retornando uma resposta de redirecionamento 301, 302 ou condicional. Com este método, você pode criar redirecionamentos rápidos e escaláveis sem tocar na configuração do servidor web, com base em domínio, caminho da URL, país, dispositivo, idioma, parâmetros de campanha ou correspondência de páginas antigas. Esta é uma solução de baixa latência, centralizada e de fácil manutenção, especialmente para transições de SEO, alterações de domínio, rotas de páginas de campanha e gerenciamento de múltiplos sites.

Os redirecionamentos tradicionais são geralmente feitos através do Apache .htaccess, do bloco de servidor Nginx, do código de aplicação ou do painel de controle de hospedagem. Essas abordagens ainda são válidas; no entanto, para sites com alto tráfego, equipes que gerenciam vários domínios ou projetos que exigem decisões dinâmicas com base em diferentes localidades, o Cloudflare Workers oferece uma camada mais flexível. Isso porque a lógica de redirecionamento opera no data center da Cloudflare mais próximo do usuário. Assim, tanto a carga no servidor de origem é reduzida quanto o risco de desempenho e interrupções devido a regras de servidor mal configuradas é diminuído.

Neste guia, você encontrará exemplos práticos que vão desde o redirecionamento 301 básico até cenários de redirecionamentos baseados em caminho, parâmetros de consulta, país, dispositivos móveis e redirecionamentos em massa. Também abordaremos, passo a passo, em quais situações SEO você deve usar 301 ou 302, o que observar durante o processo de teste e quais verificações na infraestrutura da Hostragons são benéficas em relação a domínio, SSL e hospedagem. Você pode naturalmente conferir as páginas sobre Registro de domínio e gestão de DNS, soluções de certificados SSL e Pacotes de hospedagem web para gerenciamento de domínio seguro e publicações de alto desempenho.

O que é Cloudflare Workers e por que usá-lo para redirecionamentos?

Cloudflare Workers é uma plataforma sem servidor que permite executar trechos de código baseados em JavaScript nos pontos de extremidade da rede Cloudflare. O termo sem servidor não significa que não há servidor; significa que você não precisa se preocupar com gerenciamento de servidores, escalabilidade, manutenção do sistema operacional e capacidade de infraestrutura. Quando um visitante envia uma solicitação ao seu site, o Worker atende essa solicitação na borda, executa suas regras e, se necessário, redireciona o usuário para outro endereço.

A maior vantagem de usar Workers para redirecionamentos é o nível de controle. Você pode fazer uma simples correspondência de URL, bem como ler os cabeçalhos da solicitação, o país, o caminho, os parâmetros de consulta, as informações do user-agent e o valor do host. Por exemplo, você pode mover permanentemente sua antiga página /produtos/hospedagem para a página /hospedagem-web, redirecionar apenas usuários que vêm de fora do Brasil para um subdiretório em inglês, ou direcionar o tráfego que chega com um parâmetro de campanha específico para uma página de destino especial.

Na prática, essa abordagem também acelera a operação entre as equipes de SEO e as equipes técnicas. Imagine que você está transferindo 450 URLs de um site antigo para um novo. Em vez de editar o arquivo de configuração do servidor, publicar e reverter em caso de erro, você pode gerenciar o mapa de redirecionamento dentro do Worker ou em um espaço de dados externo, como o KV. Isso torna os processos de publicação, teste e reversão mais controlados.

Diferenças entre redirecionamentos baseados em servidor e Cloudflare Workers

Não existe um único método correto para cada projeto. Para um site pequeno, algumas redireções 301 podem ser facilmente gerenciadas com a ferramenta de redirecionamento do painel de controle de hospedagem. No entanto, se houver lógica complexa, alto tráfego, múltiplos domínios e necessidade de mudanças rápidas, o Cloudflare Workers se torna mais eficiente. A tabela abaixo resume as principais diferenças que você deve considerar ao tomar sua decisão.

Você pode interpretar essa tabela com uma regra simples: se o número de redirecionamentos for baixo, suas condições forem simples e o acesso ao servidor for tranquilo, o método clássico pode servir. No entanto, se seus redirecionamentos envolverem migração de SEO, distribuição baseada em países, fluxo de campanhas A/B ou arquitetura de múltiplos domínios, a camada do Worker será mais sustentável.

Preparativos Necessários Antes de Começar

Completar a preparação técnica antes de redirecionar com o Cloudflare Workers ajuda a reduzir erros. Primeiro, seu domínio deve estar ativo na Cloudflare e seus registros DNS devem estar configurados corretamente. Registros DNS com a função proxy da Cloudflare desativada podem não ativar a rota do Worker como esperado. Portanto, verifique o estado do proxy da Cloudflare para o host onde o redirecionamento será aplicado.

• Conta Cloudflare e domínio ativo para redirecionamento.
• Registros DNS corretos A, CNAME ou registros relacionados.
• Ativação do proxy da Cloudflare e escolha correta do modo SSL/TLS.
• Mapa de redirecionamento: URL antiga, URL nova e código de status.
• Checklist de SEO: canonical, sitemap, links internos e status de indexação.
• Ferramenta de teste para navegador, curl ou verificação de cabeçalhos HTTP.

A saúde do seu servidor de origem também é importante. O redirecionamento do Worker pode reduzir a carga na origem, mas não compensará configurações DNS ou SSL incorretas. Especialmente se você estiver fazendo redirecionamentos HTTPS, é aconselhável garantir que seu certificado SSL esteja ativo na sua conta de hospedagem Hostragons. Para isso, você pode consultar Como realizar a instalação de SSL gratuito e processos de redirecionamento através do cPanel como guias complementares.

Passo a Passo para Criar Redirecionamento Sem Servidor com Cloudflare Workers

1. Crie um Worker

Selecione a conta relevante no painel da Cloudflare, vá para a seção Workers and Pages e crie um novo Worker. Na primeira etapa, a Cloudflare fornecerá um script de exemplo. Você pode apagar esse exemplo e escrever sua lógica de redirecionamento. Seja descritivo ao nomear; por exemplo, nomes como seo-redirects, domain-migration-redirects ou campaign-router facilitarão a manutenção futura.

No básico da lógica de redirecionamento, uma solicitação é recebida, um objeto URL é criado e, se uma determinada condição for atendida, o redirecionamento é feito com Response.redirect. Para migrações permanentes de SEO, 301 é preferido; para campanhas temporárias ou testes, 302 é usado. O código 308 também pode ser usado para redirecionamentos permanentes; no entanto, o código de status 301 ainda é a opção mais comum e compreensível em migrações de SEO.

2. Adicione uma Regra de Redirecionamento Simples 301

O cenário mais básico é mover permanentemente uma página antiga para uma nova. A lógica é a seguinte: Se o caminho da solicitação for /pagina-antiga, redirecione o usuário para /pagina-nova com 301. Dentro do Worker, você pode ler o valor da URL da solicitação e fazer a verificação do pathname. Assim, o redirecionamento só ocorrerá quando o caminho correspondente for igual, e outras solicitações continuarão com seu fluxo normal.

Por exemplo, se você passou de um antigo modelo de URL de categoria de hospedagem para um novo, você pode mover o endereço /pacotes-de-hospedagem para /hospedagem-web. Isso informa aos motores de busca que a página foi movida permanentemente. Dentro de algumas semanas, o Google começará a associar mais claramente a nova URL; no entanto, para isso, é necessário evitar criar uma cadeia de redirecionamentos e garantir que a URL antiga vá diretamente para a URL final.

3. Defina a Rota do Worker

Escrever o código do Worker sozinho não é suficiente; você deve especificar com uma rota em quais solicitações ele funcionará. Por exemplo, a rota example.com/* cobre todos os caminhos sob o domínio principal. Se você quiser que ele funcione apenas em um subdiretório específico, pode definir uma rota mais restrita, como example.com/antigo-blog/*. Manter o escopo da rota mais amplo do que necessário pode levar a redirecionamentos inesperados.

Antes de colocar em produção, é uma boa prática testar o escopo da rota em um subdomínio de staging ou teste. Por exemplo, você pode executar a regra em test.example.com/* e verificar o comportamento do cabeçalho e do redirecionamento. Se tudo estiver correto, você pode passar para a rota do domínio de produção. Este método previne redirecionamentos em massa errôneos, especialmente em grandes projetos de migração de SEO.

4. Publique e Teste o Código de Status HTTP

Após a publicação do Worker, apenas verificar se a página abre no navegador não é suficiente. O cache do navegador pode, às vezes, mostrar resultados antigos. Em vez disso, verifique o cabeçalho HTTP para garantir que o código de status 301 ou 302 está retornando corretamente. Além disso, verifique se o cabeçalho Location contém o URL final que você esperava.

• A URL antiga está indo diretamente para a nova URL?
• O código de redirecionamento é 301 ou 302?
• Está se formando uma cadeia extra de HTTP para HTTPS?
• As variações www e non-www estão consistentes?
• O uso de barra no final da URL foi padronizado?
• Os usuários móveis e de desktop estão vendo o mesmo objetivo de SEO?

Cenários Comuns de Redirecionamento

Redirecionamento de Página Única

O redirecionamento de página única é o início mais simples e seguro. É usado quando uma página de serviço antiga, uma página de campanha ou um post de blog é movido para um novo endereço. O ponto a ser observado aqui é que a intenção de conteúdo da página antiga deve ser compatível com a nova. Redirecionar um guia SSL antigo diretamente para a página inicial pode enfraquecer a experiência do usuário e dispersar os sinais de SEO. Em vez disso, é mais correto redirecionar para o novo guia SSL mais próximo ou para a página da categoria.

Redirecionamento em Massa com Mapa de URLs

Em projetos de migração de site, pode ser necessário redirecionar dezenas ou até milhares de URLs. Você pode definir um objeto de mapa dentro do Worker para fazer a correspondência entre o caminho antigo e o novo. Por exemplo, você pode corresponder /antigo-blog/o-que-e-cloudflare com /blog/o-que-e-cloudflare. Essa abordagem é prática para listas pequenas e médias. No entanto, para 1000 URLs ou mais, embutir uma longa lista no código pode dificultar a manutenção. Nesse caso, ler um mapa de redirecionamento através do Cloudflare KV, R2 ou uma API externa proporciona uma arquitetura mais profissional.

Ao fazer redirecionamentos em massa, prepare uma tabela com três colunas no Excel ou Google Sheets: URL antiga, URL nova, código de status. Em seguida, certifique-se de que a mesma URL não está indo para múltiplos destinos, que a URL final está retornando um código de status 200 e que não está sendo bloqueada pelo robots.txt. O erro mais comum em migrações de SEO é enviar URLs antigas em massa para páginas irrelevantes no novo site. Embora isso possa parecer diminuir a perda de rastreamento a curto prazo, a longo prazo pode enfraquecer os sinais de qualidade.

Redirecionamento Baseado em País

O Cloudflare permite que você use a informação do país de onde a solicitação está vindo. Por exemplo, você pode redirecionar usuários que vêm do Brasil para /br e usuários que vêm da Alemanha para /de. No entanto, é preciso ter cuidado com redirecionamentos automáticos baseados em país do ponto de vista de SEO. O Googlebot geralmente rastreia a partir de localidades específicas, e uma configuração incorreta pode dificultar a descoberta de diferentes versões de idioma. Portanto, as etiquetas hreflang, links de seleção de idioma e separação de sitemaps devem ser corretamente estruturados.

Fazer redirecionamentos baseados em país com 302, em vez de 301 permanente, é mais seguro na maioria das situações. Isso porque você está oferecendo uma experiência temporária com base na localização do usuário; você não afirma que a página foi movida permanentemente para outro endereço. Além disso, é importante dar ao usuário a oportunidade de alterar a seleção de idioma ou país, para melhorar a experiência.

Redirecionamento Baseado em Dispositivo ou User-Agent

Redirecionar usuários móveis para uma página diferente costumava ser uma prática comum; no entanto, o design responsivo é considerado mais saudável hoje em dia. Mesmo assim, redirecionamentos baseados em user-agent podem ser usados para páginas de download de aplicativos especiais, fluxos de campanhas móveis ou experiências de página de destino leves. Aqui também deve-se ter cuidado em termos de SEO. Apresentar conteúdo completamente diferente para usuários de desktop e móveis pode causar sinais inconsistentes.

Se você estiver fazendo redirecionamento baseado em dispositivo, o conteúdo da página mostrada ao usuário móvel deve ser compatível com a intenção da página de desktop. Além disso, não se esqueça da abordagem de indexação mobile-first do Google. A experiência móvel é um dos sinais principais de indexação, portanto, otimizar apenas a página de desktop não é suficiente.

Redirecionamento de Campanha com Base em Parâmetros de Consulta

Para equipes de marketing digital, os redirecionamentos de Workers são muito úteis. Por exemplo, você pode redirecionar usuários que chegam com o parâmetro utm_campaign=blackfriday para uma página de campanha especial. Este processo pode ser solucionado na parte de borda sem exigir desenvolvimentos adicionais na aplicação de origem. No entanto, tenha cuidado para não perder completamente os parâmetros UTM. Se necessário para medições analíticas, transfira os parâmetros para a nova URL ou monitore-os corretamente em sua plataforma de campanha.

Escolha entre 301, 302, 307 e 308 do ponto de vista de SEO

A escolha do código de redirecionamento não é apenas um detalhe técnico; ela comunica aos motores de busca a intenção por trás da mudança de página. O código 301 é para mudanças permanentes e é o mais utilizado em migrações de SEO. O código 302 é um redirecionamento temporário; ele é preferido para fluxos de campanha, teste, localização ou por tempo limitado. O código 307 oferece um comportamento de redirecionamento temporário que preserva o método. O 308 é um redirecionamento permanente semelhante ao 301, mas que também preserva o método.

A regra de ouro para SEO é: use 301 para páginas que foram movidas permanentemente e têm um novo correspondente claro; prefira 302 para redirecionamentos temporários, personalizados ou condicionais. Além disso, evite cadeias de redirecionamento. Se a URL antiga vai primeiro de HTTP para HTTPS, depois de non-www para www, e em seguida para a nova página, uma cadeia de três etapas se forma. A estrutura ideal é que a URL antiga vá diretamente para a URL final HTTPS em um único passo.

Melhores Práticas para Desempenho e Segurança

Cloudflare Workers é rápido; no entanto, uma lógica de redirecionamento mal escrita ainda pode gerar atrasos e erros. Mantenha suas regras simples, não escreva expressões regulares desnecessariamente complexas e evite aumentar descontroladamente grandes listas dentro do código. Para listas de redirecionamento muito grandes, estruturas de armazenamento de chave-valor como KV são mais adequadas em termos de desempenho e manutenção. Além disso, para evitar loops infinitos, certifique-se de que a URL de destino não seja a mesma do host e do caminho atuais.

• Defina uma propriedade clara para cada regra: SEO, equipe de software ou marketing.
• Faça um backup do mapa de redirecionamento antes de alterações.
• Teste no domínio de staging antes de colocar em produção.
• Antes de decidir pelo 301, verifique se a nova URL é realmente permanente.
• Após cada publicação, verifique manualmente de 10 a 20 URLs de exemplo.
• Monitore os relatórios de 404 e os dados de cobertura do Google Search Console.
• Não deixe links internos na URL antiga; atualize para a nova URL.

No lado da segurança, deve-se ter atenção ao risco de redirecionamentos abertos. Usar diretamente parâmetros como next, redirect ou url fornecidos pelo usuário como alvo pode levar os agressores a abusar do seu domínio confiável. Se você estiver fazendo redirecionamentos baseados em parâmetros, apenas adicione domínios permitidos à lista de permissões. Por exemplo, apenas seus próprios domínios ou domínios de campanhas verificadas podem ser alvos.

A configuração de SSL também é um ponto crítico. Ao usar SSL Flexível na Cloudflare, se o lado da origem não tiver HTTPS, pode haver ciclos de redirecionamento complexos. A estrutura mais saudável geralmente é o modo Full ou Full strict SSL. Para isso, seu servidor de origem deve ter um certificado SSL válido. As soluções de SSL da Hostragons podem facilitar esse processo: comprar certificado SSL e Segurança de hosting corporativo.

Pontos a serem observados na infraestrutura da Hostragons

Ao usar redirecionamentos de Cloudflare Workers em sites hospedados na Hostragons, é preciso considerar três camadas: DNS do domínio, configuração de hospedagem e redirecionamentos da aplicação. Primeiro, os registros de nameserver do domínio devem estar direcionados para a Cloudflare. Em seguida, seus registros DNS devem apontar para o servidor de hospedagem da Hostragons e os registros que usarão proxy devem estar ativados com nuvem laranja.

Em segundo lugar, verifique se o domínio, domínios adicionais ou estruturas de alias definidos no seu painel de hospedagem estão corretos. Mesmo que o redirecionamento ocorra na borda da Cloudflare, algumas solicitações ainda continuarão a chegar ao servidor de origem. Portanto, se houver um host virtual incorreto, SSL ausente ou configuração de diretório raiz errada no lado da origem, a experiência do usuário pode ser afetada. Para correspondências de domínio e hospedagem, os conteúdos sobre Guia de redirecionamento de domínio e gerenciamento de hosting cPanel podem ser úteis.

Por último, verifique os redirecionamentos em nível de aplicação. WordPress, Laravel, aplicações PHP personalizadas ou outros CMS podem fazer redirecionamentos internos de HTTPS, www ou idioma. Se o Cloudflare Worker executar uma segunda regra sobre o mesmo assunto, pode haver um ciclo ou cadeia. A melhor abordagem é concentrar a responsabilidade do redirecionamento em uma única camada. Por exemplo, todos os redirecionamentos de domínio e migrações de SEO podem ser feitos no Workers, enquanto os redirecionamentos de sessão de usuário dentro da aplicação podem permanecer do lado do software.

Teste, Monitoramento e Depuração

Após a publicação do redirecionamento, o processo de monitoramento é tão importante quanto a configuração. Nas primeiras 24 horas, verifique as URLs mais críticas, as páginas de destino que geram receita, as páginas mais visitadas de tráfego orgânico e as URLs antigas que possuem backlinks. Monitore os relatórios de Indexação e Experiência da Página no Google Search Console. Quando analisados em conjunto, os logs do servidor, as análises da Cloudflare e os dados analíticos permitem identificar redirecionamentos incorretos mais rapidamente.

Os seguintes padrões aparecem frequentemente na depuração: uso acidental de 302 em vez de 301, redirecionamento da URL antiga para a página inicial em vez da nova URL, comportamento inconsistente em variações de barra, sensibilidade a maiúsculas e minúsculas, e perda de parâmetros de consulta. Especialmente em sites de e-commerce, SaaS e hospedagem, o redirecionamento incorreto de páginas de preços, produtos, categorias e suporte pode impactar diretamente a taxa de conversão.

Após uma publicação, aplique uma lista de verificação simples. Primeiro, selecione aleatoriamente exemplos da lista de URLs antigas. Em segundo lugar, teste cada um com uma ferramenta de verificação de cabeçalhos. Em terceiro lugar, verifique se a página final está retornando um código de status 200. Em quarto lugar, verifique se o conteúdo da página corresponde à intenção de busca da página antiga. Em quinto lugar, confirme que os links internos foram atualizados para as novas URLs. Esses cinco passos ajudam a evitar a maioria dos redirecionamentos que funcionam tecnicamente, mas são fracos em SEO.

Estratégia Exemplo: Transferindo Páginas Antigas de Hospedagem para uma Nova Arquitetura de Informação

Vamos pensar em um cenário concreto. Uma empresa de hospedagem está renovando sua estrutura de URL e movendo páginas como /hospedagem-linux, /pacotes-de-hospedagem-wordpress, /segurança-ssl e /consulta-de-domínio para uma estrutura mais limpa. Os novos destinos serão, respectivamente, /hospedagem-web, /hospedagem-wordpress, /certificado-ssl e /consulta-de-domínio. Nesse caso, quatro regras claras de 301 serão definidas dentro do Worker. Em seguida, os menus internos do site, links de rodapé, sitemaps e etiquetas canônicas serão atualizados para as novas URLs.

O objetivo dessa transição não é apenas redirecionar o usuário para a página correta. Também é mostrar claramente aos motores de busca as novas correspondências das páginas antigas. Se a antiga página /hospedagem-linux for redirecionada para a página inicial, o Google pode perder o contexto dessa página. Em vez disso, a página /hospedagem-web está mais alinhada com a intenção do produto. Portanto, um bom mapa de redirecionamento é parte integrante da estratégia de SEO, e não apenas um arquivo técnico.

Perguntas Frequentes

Os redirecionamentos feitos com Cloudflare Workers são seguros para SEO?

Sim, quando o código de status correto e a URL de destino correta são usados. Para mudanças permanentes de página, deve-se usar 301; para fluxos temporários ou condicionais, 302 deve ser utilizado. Além disso, deve-se evitar cadeias de redirecionamento, loops e erros de páginas de destino irrelevantes.

O servidor de origem precisa estar funcionando para o redirecionamento do Worker?

Se o redirecionamento for totalmente concluído na borda da Cloudflare, ele pode retornar uma resposta sem ir ao servidor de origem. No entanto, como a página final redirecionada funcionará na origem ou em outra infraestrutura, é necessário que a configuração de hospedagem, DNS e SSL esteja saudável.

É melhor usar Workers em vez de Regras de Página da Cloudflare?

Para alguns redirecionamentos simples, as Regras de Página ou Regras de Redirecionamento podem ser suficientes. No entanto, se forem necessárias lógicas dinâmicas baseadas em caminho, país, dispositivo, parâmetros, múltiplos domínios ou mapas, os Workers são uma solução mais flexível e escalável.

Alterar um redirecionamento 301 posteriormente causará problemas?

Como o 301 oferece um sinal permanente, ele não deve ser alterado com frequência. Navegadores e motores de busca podem armazenar em cache os resultados 301. Portanto, antes de publicar um 301, verifique se a URL de destino é permanente e atende à intenção de conteúdo correta.

É possível redirecionar www e non-www com Cloudflare Workers?

Sim. Você pode redirecionar endereços non-www para a versão www ou vice-versa verificando o valor do host. O importante é estabelecer um único padrão, preparar o certificado SSL para que cubra ambas as variações e atualizar os links internos de acordo com esse padrão.

Conclusão

Utilizar o Cloudflare Workers para criar redirecionamentos sem servidor é um método poderoso que proporciona tanto desempenho quanto flexibilidade operacional em projetos web modernos. Desde que você escolha corretamente os códigos 301 e 302, prepare cuidadosamente seu mapa de redirecionamento e verifique as camadas de DNS, SSL e hospedagem, você pode gerenciar transições de SEO com mais segurança. Enquanto projetos pequenos podem ser gerenciados com regras simples, em grandes migrações, testes, monitoramento e documentação tornam-se críticos.

Ao estruturar corretamente seu domínio, hospedagem e infraestrutura SSL na Hostragons, você pode estabelecer redirecionamentos Cloudflare Workers sobre uma base mais sólida. Se precisar, você pode planejar a infraestrutura adequada para seu projeto consultando as páginas sobre Pacotes de hospedagem web, Consulta de domínio e soluções de certificados SSL.