Sites
Redirecionamentos de Site
Redirects send visitors from an old URL to a new one, which is how you restructure a site without breaking every link pointing at it. This guide covers the three source shapes, choosing between 301…
Redirecionamentos
Os redirecionamentos enviam visitantes de uma URL antiga para uma nova, permitindo reestruturar um site sem quebrar todos os links que apontam para ele. Este guia cobre as três formas de origem, a escolha entre 301 e 302, cadeias de consulta e a leitura do emblema de verificação.
Onde os Redirecionamentos Ficam no KPanel
- Entre em KPanel.
- Clique em Websites na barra lateral esquerda e depois clique no site.
- Na barra de abas do site, abra Advanced e depois Redirects.
O endereço direto é /websites/<site-id>/redirects.

Os redirecionamentos aqui são aplicados pelo servidor web, antes de sua aplicação ser executada. Isso os torna mais rápidos do que um redirecionamento baseado em plugin e significa que funcionam mesmo para URLs que sua aplicação não reconheceria.
Adicionando um Redirecionamento
- Clique em Add redirect.
- Digite o Source path.
- Digite o Destination.
- Escolha 301 Permanent ou 302 Temporary.
- Decida se deseja manter Preserve query string marcado.
- Clique em Add redirect.
O redirecionamento é aplicado e depois verificado diretamente em seu site, então o status que você vê reflete o comportamento real em vez de uma suposição.
As Três Formas de Origem
| Forma | Exemplo | Corresponde a |
|---|---|---|
| Exact | /old-page | Apenas esse caminho |
| Prefix | /old-path/ | Esse caminho e tudo abaixo dele |
| Wildcard | /blog/* | Tudo abaixo de /blog/, capturando o resto |
Uma origem wildcard captura o que corresponde a *, e o destino pode fazer referência a ele como $1. Portanto, uma origem de /blog/* com um destino de /news/$1 envia /blog/hello-world para /news/hello-world, e faz o mesmo para cada outro post, de uma única regra.
O caminho de origem não pode ser alterado após a criação de um redirecionamento. Se errou, remova o redirecionamento e adicione um novo. O destino, o código e a configuração de consulta são todos editáveis.
Destinos
Um destino pode ser:
- Relative, como
/new-page, para enviar visitantes para outro lugar no mesmo site. - Absolute, como
https://example.com/new, para enviá-los para outro site inteiramente.
Os destinos absolutos são como você constrói caminhos de vaidade: /docs em seu domínio apontando para documentação hospedada em outro lugar, por exemplo.
301 ou 302
301 Permanent diz aos navegadores e mecanismos de busca que a mudança é definitiva. Os mecanismos de busca transferem sinais de classificação para a nova URL e deixam de solicitar a antiga. Os navegadores armazenam em cache o redirecionamento, às vezes por muito tempo.
302 Temporary diz que a mudança pode ser revertida. Nada é transferido e nada é armazenado em cache a longo prazo.
Use 301 para uma reestruturação real: você moveu uma página e ela não voltará. Use 302 para qualquer coisa que você espere desfazer, como apontar uma página para uma campanha temporária ou um aviso de manutenção.
Um 301 incorreto é caro de desfazer. Os navegadores armazenam em cache os redirecionamentos permanentes agressivamente, portanto um visitante que acionou a regra incorreta uma vez pode continuar seguindo muito tempo depois de você tê-la deletado, sem forma de limpar o cache dele. Quando não tiver certeza, comece com um 302 e promova para 301 quando tiver.
Preserve Query String
Preserve query string está ativado por padrão. Com ele ativado, ?utm_source=newsletter e todos os outros parâmetros são levados para o destino.
Deixe-o ativado em quase todos os casos. Perder cadeias de consulta quebra o rastreamento de campanhas, quebra paginação e filtros, e quebra qualquer link que carregue estado. A lista de redirecionamento marca qualquer regra com ele desativado como (query stripped), para que você possa ver rapidamente quais descartam parâmetros.
Desative-o apenas quando o destino nunca deve receber os parâmetros antigos, por exemplo, quando os parâmetros antigos seriam interpretados de forma diferente e causariam a renderização da página errada.
Lendo o Emblema de Status
Após cada salvamento, o redirecionamento é testado diretamente em seu site, não através de um cache, e o resultado se torna o emblema na coluna Status.
| Emblema | Significado |
|---|---|
| Not yet verified | A verificação ainda não foi executada. Atualize em um momento |
| Verified, with the code and destination | O redirecionamento está ativo e fazendo exatamente o que você configurou |
| Applied but not challenging, with a status | A regra foi escrita mas o site retornou outra coisa |
O terceiro emblema é o para agir. Significa que a configuração está em vigor mas o redirecionamento não está funcionando, e o código de status mostrado diz o que aconteceu.
Você também pode ver um aviso após salvar que outra configuração no servidor reclama do mesmo domínio. Quando isso acontece, o redirecionamento não será aplicado até que esse conflito seja resolvido, e a mensagem nomeia a outra configuração. Entre em contato com o suporte se vir e não tiver certeza do que significa.
Editando e Removendo
Cada linha tem um botão de edição e um botão de remoção.
A edição permite que você altere o destino, o código e a configuração de consulta. A origem é fixa.
A remoção solicita confirmação e explica o que acontecerá: solicitações para esse caminho param de redirecionar e retornam o que o site normalmente fornece lá, geralmente um 404.
Planejando uma Reestruturação
Antes de mover um grande número de URLs, um pouco de organização economiza muita dor.
- Exporte sua lista de URL atual do seu sitemap ou do seu analytics, para saber o que realmente recebe tráfego.
- Mapeie antigo para novo, uma linha por URL. Agrupe qualquer coisa que compartilhe um prefixo.
- Use wildcards para os grupos. Uma regra
/blog/*vence duzentas regras exatas e não divergirá. - Adicione regras exatas para as exceções que não seguem o padrão.
- Teste cada forma uma vez e depois verifique os emblemas.
- Monitore sua contagem de 4xx depois em Site Traffic Analytics. Uma participação crescente de 404 significa que você perdeu algo.
Adicione uma página 404 marcada como rede de segurança para tudo que você perder. Transforma um beco sem saída em uma rota de volta ao site. Veja Custom Error Pages.
Solução de Problemas
O redirecionamento não é acionado. Verifique o emblema. Se disser applied but not challenging, anote o código de status retornado. Um 200 geralmente significa que outra coisa respondeu à solicitação primeiro, geralmente a própria aplicação.
É acionado mas desembarco na URL errada. Verifique se há uma cadeia: sua regra pode estar enviando tráfego para um caminho que outra regra, ou a aplicação, redireciona novamente. Cadeias são lentas e confundem mecanismos de busca. Aponte a primeira regra diretamente ao destino final.
Um wildcard envia tudo para uma página. O destino está faltando seu $1. Sem ele, toda captura colapsa para o mesmo alvo.
Um redirecionamento que deletei ainda acontece no meu navegador. Você seguiu um 301 anteriormente e seu navegador o armazenou em cache. Teste em uma janela privada para confirmar que a regra foi realmente deletada.
Parâmetros de consulta desaparecem. Preserve query string está desativado nessa regra. Edite-a e ative novamente.
Muitos redirecionamentos ou um loop. Duas regras estão apontando uma para a outra, ou uma regra aponta para um caminho que corresponde ao seu próprio padrão de origem. Remova um lado do loop.
Páginas Relacionadas
- Custom Error Pages para o que os visitantes veem quando nada corresponde.
- Site Traffic Analytics para monitorar contagens de 3xx e 4xx após uma reestruturação.
- Password-Protecting a Site para bloquear um caminho em vez de movê-lo.