O que é o Gerador de Regras de Redirecionamento
O Gerador de Regras de Redirecionamento é uma ferramenta online projetada para simplificar a criação de códigos de redirecionamento para servidores web e plataformas de hospedagem. A ferramenta recebe uma lista de endereços de sites de origem e os novos endereços de destino correspondentes para gerar o código de configuração específico necessário para aplicar esses redirecionamentos no seu ambiente de web.
Para utilizar a ferramenta, você deve fornecer essa lista em um arquivo CSV, selecionar se os redirecionamentos são permanentes ou temporários e escolher o ambiente web de destino. O gerador processa as informações e exibe as regras geradas em uma área de texto, permitindo que você copie ou baixe o resultado final.
Quem precisa desta ferramenta
A criação e a gestão de regras de redirecionamento são tarefas essenciais em diversos cenários de administração de sites. Esta ferramenta é especialmente útil para:
- Migração de sites: Quando um site é transferido para um novo domínio ou plataforma, garantindo que os usuários e motores de busca encontrem os novos caminhos.
- Reestruturação de URLs: Durante processos de reorganização da estrutura de links de um site para melhorar a usabilidade ou a navegação.
- Limpeza de conteúdo antigo: Quando páginas antigas ou desatualizadas são removidas e precisam apontar para conteúdos novos e relevantes.
- Webmasters e desenvolvedores: Profissionais que precisam gerar regras de redirecionamento de forma rápida, precisa e sem a necessidade de escrever sintaxes complexas manualmente.
Formatação do arquivo CSV de entrada
Para que o gerador processe as informações corretamente, o arquivo CSV de mapeamento deve seguir regras estruturais específicas:
- Estrutura de colunas: O arquivo deve conter duas colunas com uma linha de cabeçalho identificada como
sourceetarget(oudestination). - Formatos de URL de origem: A origem pode ser uma URL HTTP ou HTTPS completa, ou um caminho relativo que comece obrigatoriamente com
/. - Formatos de URL de destino: O destino pode ser uma URL HTTP ou HTTPS completa, ou um caminho relativo à raiz.
- Limites do arquivo: O arquivo CSV deve ter um tamanho inferior a 5 MB e conter, no máximo, 2.000 mapeamentos de redirecionamento.
Se o arquivo não estiver em conformidade com essas regras, a ferramenta exibirá mensagens de erro específicas para orientar a correção, como A linha de cabeçalho precisa das colunas source e target (ou destination). ou A linha {line} precisa de uma origem e de um destino..
Regras de correspondência e casos especiais
O gerador adota critérios rígidos para garantir a integridade das regras geradas e evitar comportamentos inesperados no servidor:
- Correspondência exata: Todos os redirecionamentos gerados são correspondências exatas. As saídas para Nginx e Apache são ancoradas ao caminho exato de origem, e a Vercel recebe o mesmo caminho literal.
- Remoção de hostnames: Os hostnames de origem são automaticamente removidos durante o processamento.
- Restrições na origem: Strings de consulta (query strings), fragmentos (como
#) e padrões de caracteres curinga (wildcards) na origem não são aceitos. Caso sejam detectados, a ferramenta exibirá erros comoA linha {line} inclui uma string de consulta (query string) ou fragmento na origem. Use apenas o caminho de origem.ouA linha {line} usa caracteres curinga ou de padrão de rota. Este gerador aceita apenas caminhos de origem exatos.. - Comprimento de URL: Nenhuma URL contida no arquivo CSV pode ultrapassar o limite de 2.048 caracteres. Se esse limite for excedido, o erro
Uma URL na linha {line} tem mais de 2.048 caracteres.será exibido. - Duplicidade: Cada caminho de origem deve ser exclusivo e aparecer apenas uma vez no arquivo. Caso contrário, o sistema apontará o erro
A linha {line} repete o caminho de origem {source}. Cada origem pode aparecer apenas uma vez..
Comportamento por ambiente: Nginx, Apache e Vercel
A sintaxe gerada varia conforme o ambiente web selecionado, respeitando as particularidades técnicas de cada plataforma:
Apache
As regras geradas para o Apache são estruturadas para serem inseridas no arquivo de configuração do servidor ou no arquivo .htaccess. Elas utilizam diretivas ancoradas ao caminho exato de origem para garantir que apenas a URL mapeada sofra a ação.
Nginx
Para o Nginx, a ferramenta gera blocos de configuração específicos que devem ser adicionados ao arquivo de configuração do servidor. Assim como no Apache, a saída é ancorada ao caminho exato de origem para evitar redirecionamentos indesejados de subdiretórios ou caminhos semelhantes.
Vercel
A configuração para a Vercel é gerada em formato JSON compatível com o arquivo vercel.json. Um detalhe importante sobre a Vercel é que a plataforma, por padrão, converte redirecionamentos permanentes em status 308 e temporários em status 307. Para garantir que a sua escolha de status seja estritamente respeitada, a ferramenta utiliza explicitamente a propriedade statusCode na saída gerada, mantendo o redirecionamento exatamente como 301 ou 302.
Privacidade e processamento de dados
A segurança e a privacidade dos seus dados de mapeamento são mantidas de forma rigorosa durante o uso da ferramenta. O seu arquivo CSV e as regras geradas permanecem exclusivamente no seu navegador. Nenhum dado ou arquivo é enviado para os servidores do BroBroGo.
Perguntas Frequentes (FAQ)
Como devo formatar o arquivo CSV?
Use uma linha de cabeçalho com as colunas "source" e "target" (ou "destination"). Cada linha seguinte pode usar uma URL de origem HTTP ou HTTPS completa ou um caminho começando com /, além de um destino completo ou relativo à raiz.
Os redirecionamentos gerados são correspondências exatas?
Sim. As saídas do Nginx e Apache são ancoradas ao caminho exato de origem, e a Vercel recebe o mesmo caminho literal. O hostname de origem é removido; strings de consulta (query strings), fragmentos e padrões estilo curinga (wildcard) na origem são rejeitados porque os três ambientes os tratam de formas diferentes.
Por que a saída da Vercel usa statusCode?
A mudança permanente da Vercel produz 308 e a temporária produz 307. O statusCode é utilizado para que sua escolha permaneça exatamente como 301 ou 302. Implantações padrão da Vercel permitem 2.048 rotas no total, por isso esta ferramenta aceita até 2.000 mapeamentos.