Como usar
- Cole seus redirecionamentos, um por linha: o caminho antigo, o caminho ou URL novo e, se quiser, o status (301 se você omitir).
- Escolha o destino:
lobsite.toml, Netlify ou Cloudflare Pages (_redirects), Vercel (vercel.json), Nginx ou Apache (.htaccess). - Corrija o que as verificações encontrarem, teste alguns caminhos na caixa abaixo e copie ou baixe as regras.
Está saindo do Netlify ou do Cloudflare Pages? Cole seu arquivo _redirects como está.
Padrões
:namecorresponde a um segmento do caminho e pode ser usado no destino:/blog/:slug /posts/:slug.- Um
*no final corresponde ao resto do caminho, que no destino é:splat:/docs/* /guide/:splat. - A query string é repassada ao novo endereço.
- As regras são verificadas de cima para baixo e a primeira que corresponder vence, então coloque as regras específicas antes das gerais.
As mesmas regras funcionam no lobsite.toml. Para Nginx e Apache, os padrões viram expressões regulares com grupos numerados.
Que status usar
- 301 (permanente): a página mudou de vez. Os buscadores passam o posicionamento dela para o novo endereço. Use isso na maioria das mudanças de site.
- 302 (temporário): o endereço original vai voltar, como durante uma promoção ou uma manutenção.
- 308 e 307: as versões permanente e temporária que mantêm o método da requisição, para formulários e APIs que fazem POST no endereço antigo.
Loops e cadeias
Um loop (/a → /b → /a) significa que a página nunca carrega. Uma cadeia (/a → /b → /c) funciona, mas cada salto acrescenta uma ida e volta, e os buscadores podem parar de seguir depois de alguns. O gerador detecta os dois, além de regras duplicadas, das quais só a primeira é usada.
Perguntas frequentes
Quantos redirecionamentos posso ter?
O lobsite.toml aceita até 1.000 regras. Para seções inteiras, use um padrão como /old-blog/* /blog/:splat em vez de uma regra por página.
O endereço antigo pode ser uma URL completa?
Cole-a e o gerador mantém só o caminho: os redirecionamentos valem para o site com o qual são publicados. Para mudar um domínio inteiro, aponte-o para o novo site e redirecione lá.
Os redirecionamentos funcionam sem acesso ao servidor?
No Lobsite, Netlify, Vercel e Cloudflare Pages eles fazem parte do deploy, então não é preciso acesso ao servidor. Numa hospedagem de arquivos simples, a alternativa é uma página com <meta http-equiv="refresh" content="0; url=/new">, que os buscadores tratam como um redirecionamento.
Algo é enviado a um servidor?
Não. As regras são verificadas e escritas no seu navegador.