# Redirecionamentos de Site

Source: https://support.kapsulehost.com/pt-pt/site-redirects

Os redirecionamentos enviam os visitantes de um URL antigo para um novo, e é assim que se reestrutura um site sem quebrar todas as ligações que apontam para ele. Este guia aborda as três formas de origem, a escolha entre 301 e 302, as strings de consulta e a leitura do emblema de verificação.

## Onde Vivem os Redirecionamentos no KPanel

1. Inicie sessão no [KPanel](https://kpanel.kapsulehost.com).
2. Clique em **Websites** na barra lateral esquerda e, em seguida, clique no site.
3. No menu esquerdo do site, abra **Definições** e, depois, **Redirecionamentos**.

O endereço direto é `/websites/<site-id>/redirects`.

![Redirecionamentos para um site no KPanel](https://support.kapsulehost.com/help/screenshots/site-redirects.243dc02e.webp)

Os redirecionamentos aqui são aplicados pelo servidor web, antes de a sua aplicação ser executada. Isso torna-os mais rápidos do que um redirecionamento baseado em plugin e significa que funcionam mesmo para URLs que a sua aplicação não reconheceria de todo.

## Adicionar um Redirecionamento

1. Clique em **Adicionar redirecionamento**.
2. Introduza o **Caminho de origem**.
3. Introduza o **Destination**.
4. Escolha **301 Permanente** ou **302 Temporário**.
5. Decida se mantém **Preservar string de consulta** assinalado.
6. Clique em **Adicionar redirecionamento**.

O redirecionamento é aplicado e depois verificado diretamente no seu site, pelo que o estado que vê reflete o comportamento real em vez de uma suposição.

## As Três Formas de Origem

| Forma | Exemplo | Corresponde a |
|---|---|---|
| Exata | `/old-page` | Apenas esse caminho |
| Prefixo | `/old-path/` | Esse caminho e tudo abaixo dele |
| Curinga | `/blog/*` | Tudo sob `/blog/`, capturando o resto |

Uma origem com curinga captura o que correspondeu ao `*`, e o destino pode referenciá-lo como `$1`. Assim, uma origem `/blog/*` com um destino `/news/$1` envia `/blog/hello-world` para `/news/hello-world`, e faz o mesmo para todas as outras publicações, a partir de uma única regra.

> **Note:** O caminho de origem não pode ser alterado depois de o redirecionamento ser criado. Se o configurou mal, remova o redirecionamento e adicione um novo. O destino, o código e a definição de consulta são todos editáveis.

## Destinos

Um destino pode ser:

- **Relativo**, como `/new-page`, para enviar os visitantes para outro local no mesmo site.
- **Absoluto**, como `https://example.com/new`, para os enviar inteiramente para outro site.

Os destinos absolutos são como se constroem caminhos personalizados: `/docs` no seu domínio a apontar para documentação alojada noutro local, por exemplo.

## 301 ou 302

**301 Permanente** diz aos navegadores e aos motores de busca que a mudança é definitiva. Os motores de busca transferem os sinais de classificação para o novo URL e deixam de pedir o antigo. Os navegadores colocam o redirecionamento em cache, por vezes durante muito tempo.

**302 Temporário** indica que a mudança pode ser revertida. Nada é transferido e nada fica em cache a longo prazo.

Use 301 para uma reestruturação real: moveu uma página e ela não vai voltar. Use 302 para tudo o que espera desfazer, como apontar uma página para uma campanha temporária ou um aviso de manutenção.

> **Warning:** Um 301 incorreto é dispendioso de desfazer. Os navegadores colocam em cache os redirecionamentos permanentes de forma agressiva, pelo que um visitante que tenha seguido a regra errada uma vez pode continuar a segui-la muito depois de a ter eliminado, sem que haja forma de limpar a cache dessa pessoa. Quando não tiver a certeza, comece com um 302 e promova-o a 301 quando tiver.

## Preservar String de Consulta

**Preservar string de consulta** está ativado por predefinição. Com esta opção ativada, `?utm_source=newsletter` e todos os outros parâmetros são transportados até ao destino.

Deixe-a ativada quase sempre. Perder as strings de consulta quebra o rastreio de campanhas, quebra a paginação e os filtros, e quebra qualquer ligação que transporte estado. A lista de redirecionamentos assinala qualquer regra com esta opção desativada como `(query stripped)`, para que possa ver rapidamente quais eliminam parâmetros.

Desative-a apenas quando o destino nunca deva receber os parâmetros antigos, por exemplo quando os parâmetros antigos seriam interpretados de forma diferente e fariam renderizar a página errada.

## Leitura do Emblema de Estado

Após cada gravação, o redirecionamento é testado diretamente no seu site, não através de uma cache, e o resultado torna-se o emblema na coluna **Status**.

| Emblema | Significado |
|---|---|
| Ainda não verificado | A verificação ainda não foi executada. Atualize dentro em instantes |
| Verificado, com o código e o destino | O redirecionamento está ativo e a fazer exatamente o que configurou |
| Aplicado mas sem efeito, com um estado | A regra foi escrita mas o site devolveu outra coisa |

O terceiro emblema é aquele sobre o qual deve agir. Significa que a configuração está em vigor mas o redirecionamento não está a ter efeito, e o código de estado apresentado indica-lhe o que aconteceu em vez disso.

Também pode ver um aviso após gravar, dizendo que outra configuração no servidor reivindica o mesmo domínio. Quando isso acontece, o redirecionamento não se aplica até esse conflito ser resolvido, e a mensagem identifica a outra configuração. Contacte o suporte se vir isto e não tiver a certeza do que significa.

## Edição e Remoção

Cada linha tem um botão de edição e um botão de remoção.

A edição permite alterar o destino, o código e a definição de consulta. A origem é fixa.

A remoção pede confirmação e explica o que vai acontecer: os pedidos a esse caminho deixam de ser redirecionados e devolvem o que o site normalmente serve aí, que é frequentemente um 404.

## Planear uma Reestruturação

Antes de mover um grande número de URLs, um pouco de organização poupa muito sofrimento.

1. **Exporte a sua lista de URLs atual** a partir do seu mapa do site ou das suas análises, para saber o que realmente recebe tráfego.
2. **Mapeie o antigo para o novo**, uma linha por URL. Agrupe tudo o que partilhe um prefixo.
3. **Use curingas para os grupos.** Uma única regra `/blog/*` supera duzentas regras exatas e não se desalinha com o tempo.
4. **Adicione regras exatas para as exceções** que não seguem o padrão.
5. **Teste cada forma uma vez**, depois verifique os emblemas.
6. **Observe a sua contagem de 4xx** posteriormente em [Análises de Tráfego do Site](https://support.kapsulehost.com/pt-pt/site-analytics). Uma proporção crescente de 404 significa que algo lhe escapou.

> **Tip:** Adicione uma página 404 personalizada como rede de segurança para o que lhe escapar. Transforma um beco sem saída numa rota de volta ao site. Consulte [Páginas de Erro Personalizadas](https://support.kapsulehost.com/pt-pt/site-error-pages).

## Resolução de Problemas

**O redirecionamento não dispara.** Verifique o emblema. Se indicar aplicado mas sem efeito, anote o código de estado devolvido. Um 200 normalmente significa que outra coisa respondeu primeiro ao pedido, frequentemente a própria aplicação.

**Dispara mas acabo no URL errado.** Verifique se há uma cadeia: a sua regra pode estar a enviar tráfego para um caminho que outra regra, ou a aplicação, redireciona novamente. As cadeias são lentas e confundem os motores de busca. Faça com que a primeira regra aponte diretamente para o destino final.

**Um curinga envia tudo para uma única página.** Falta ao destino o seu `$1`. Sem isso, todas as capturas colapsam no mesmo alvo.

**Um redirecionamento que eliminei continua a acontecer no meu navegador.** Seguiu anteriormente um 301 e o seu navegador colocou-o em cache. Teste numa janela privada para confirmar que a regra realmente desapareceu.

**Os parâmetros de consulta desaparecem.** **Preservar string de consulta** está desativado nessa regra. Edite-a e volte a ativá-lo.

**Demasiados redirecionamentos, ou um ciclo.** Duas regras apontam uma para a outra, ou uma regra aponta para um caminho que corresponde ao seu próprio padrão de origem. Remova um dos lados do ciclo.

## Páginas Relacionadas

- [Páginas de Erro Personalizadas](https://support.kapsulehost.com/pt-pt/site-error-pages) para o que os visitantes veem quando nada corresponde.
- [Análises de Tráfego do Site](https://support.kapsulehost.com/pt-pt/site-analytics) para observar as contagens de 3xx e 4xx após uma reestruturação.
- [Proteger um Site com Palavra-passe](https://support.kapsulehost.com/pt-pt/site-password-protect) para bloquear um caminho em vez de o mover.