# Páginas de Erro Personalizadas

Source: https://support.kapsulehost.com/pt-pt/site-error-pages

Um erro personalizado substitui a predefinição simples do servidor por HTML com a sua própria marca, mantendo o estado real do erro para que os motores de busca continuem a ver um 404 verdadeiro. Este guia aborda a adição de uma página para cada código suportado, o que é removido por segurança e como funciona o selo de verificação.

## Onde Vivem as Páginas de Erro no KPanel

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

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

![Páginas de erro personalizadas para um site no KPanel](https://support.kapsulehost.com/help/screenshots/site-error-pages.89c17e2d.webp)

## Porque Vale a Pena

Uma página de erro predefinida do servidor é um beco sem saída. Não tem marca, não tem navegação e não tem qualquer explicação, pelo que um visitante que caia numa delas normalmente sai do site.

Uma página personalizada transforma isso numa via de regresso ao site: o seu logótipo, a sua tipografia, uma frase na sua própria voz e uma ligação para a página inicial ou para uma caixa de pesquisa. Num site grande, URLs mal escritos ou desatualizados são um fluxo constante de tráfego, e uma página 404 é a recuperação mais barata que alguma vez irá construir.

## Os Códigos Suportados

Pode configurar uma página personalizada para oito códigos, uma página por código:

| Código | Significado | Causa típica |
|---|---|---|
| 400 | Pedido incorreto | Um pedido mal formado |
| 401 | Não autorizado | Autenticação necessária ou falhada |
| 403 | Proibido | Uma regra de acesso bloqueou o pedido |
| 404 | Não encontrado | Não existe nada nesse URL |
| 500 | Erro interno do servidor | A sua aplicação falhou |
| 502 | Gateway incorreto | A aplicação não respondeu corretamente |
| 503 | Serviço indisponível | A aplicação está em baixo ou sobrecarregada |
| 504 | Tempo limite do gateway | A aplicação demorou demasiado tempo |

Comece pelo 404. É de longe o mais comum, e é o único que um visitante alcança através de navegação normal, em vez de uma falha.

Vale a pena fazer a família 5xx a seguir, porque são as páginas que as pessoas veem no seu pior dia. Uma página calma e com a sua marca, que diz que algo correu mal e indica um endereço de email, é muito melhor do que um erro de servidor em branco.

## Adicionar uma Página

1. Clique em **Adicionar página de erro**.
2. Escolha um código de erro na lista pendente. Os códigos já em uso não são apresentados.
3. Substitua o HTML de exemplo no campo **Corpo HTML** pelo seu próprio.
4. Clique em **Adicionar página de erro**.

O editor começa com um documento 404 funcional que pode editar, o que é um ponto de partida razoável se apenas quiser algo apresentável rapidamente.

## Escrever o HTML

Forneça um documento HTML completo, começando com um doctype. É servido tal como está, pelo que tem de ser autónomo.

Algum HTML é removido antes de a página ser sequer armazenada, por segurança:

- etiquetas `<script>`
- manipuladores de eventos em linha, como `onclick`
- iframes
- folhas de estilo remotas

Se algo for removido, um aviso informa-o depois de guardar.

> **Warning:** Como as folhas de estilo remotas são removidas, uma página de erro não consegue carregar o ficheiro CSS principal do seu site. Formate-a com CSS em linha ou com um bloco `<style>` no cabeçalho do documento. Isto é deliberado: uma página de erro tem de ser apresentada mesmo quando o resto do site está avariado, e uma página que dependa de obter recursos de um servidor em falha será apresentada como texto sem estilo precisamente no pior momento.

Orientação prática:

- **Mantenha-a pequena e autónoma.** Inclua tudo em linha. Evite imagens externas. A lista de páginas mostra o tamanho de cada página em KB.
- **Diga o que aconteceu em palavras simples.** "Não conseguimos encontrar essa página" é melhor do que "404 Não encontrado".
- **Dê uma forma de avançar.** Uma ligação para a página inicial, uma ligação para as suas secções principais ou uma caixa de pesquisa.
- **Inclua uma forma de contacto** nas páginas 5xx, uma vez que o visitante não consegue usar o site para o contactar.
- **Não a use para redirecionar.** Se um URL mudou de sítio, redirecione-o corretamente em vez disso. Consulte [Redirecionamentos de Site](https://support.kapsulehost.com/pt-pt/site-redirects).

## O Código de Estado É Preservado

A sua página personalizada é servida com o estado de erro real, não 200. Um 404 mantém-se um 404 até chegar ao cliente.

Isto importa mais do que parece. Uma página com a sua marca devolvida como 200 é um "soft 404": os motores de busca indexam-na como uma página real, as suas análises contam-na como uma visualização bem-sucedida, e as ligações quebradas nunca são assinaladas por nenhuma ferramenta. Como a KapsuleHost mantém o estado real, tudo isso continua a funcionar corretamente.

## Ler o Selo de Estado

A coluna **Estado** reporta o que pôde realmente ser verificado, e é deliberadamente honesta quanto aos limites.

| Selo | Significado |
|---|---|
| Verificado: página marcada servida (404 verdadeiro) | Forçámos um 404 a partir do exterior e obtivemos a sua página com o estado correto |
| Configurado (não testado externamente) | A página está aplicada. Esse código não pode ser desencadeado a partir do exterior a pedido |
| Ainda não verificado | A verificação ainda não foi executada |
| Aplicado, teste em direto inconclusivo | A sonda obteve algo diferente de um 404 limpo, muitas vezes porque um redirecionamento o intercetou |
| Obteve um 404 mas a página marcada não foi servida | A regra está em vigor mas a sua página não foi devolvida. Tente guardar novamente |

Apenas o 404 pode ser forçado externamente. Pedir um URL que não existe produz de forma fiável um 404, mas não há forma de fazer um servidor saudável produzir um 500 genuíno a pedido sem o avariar. Por isso, os outros códigos reportam **Configurado** em vez de reclamar uma verificação que nunca aconteceu. Ainda assim, servem corretamente quando o erro ocorre genuinamente.

Também pode ver um aviso de que outra configuração no servidor reclama o mesmo domínio. Até isso ser resolvido, a página de erro pode não se aplicar. Contacte o suporte se vir este aviso.

## Resolução de Problemas num Site Que Está Realmente com Erros

Se está aqui porque o seu site está a devolver erros, em vez de querer apenas páginas mais bonitas, a página tem um atalho: o botão **Troubleshoot with Kora** na faixa no topo.

Isso pede à Kora, a assistente dentro do KPanel, para ler os seus registos de erro e falhas recentes deste site e indicar a causa provável e como a corrigir. Esse é um primeiro passo muito mais rápido do que ler registos em bruto.

Para o panorama de desempenho subjacente, consulte [Desempenho do Site e APM](https://support.kapsulehost.com/pt-pt/site-performance), e para a taxa de erros ao longo do tempo, consulte [Análise de Tráfego do Site](https://support.kapsulehost.com/pt-pt/site-analytics).

## Editar e Remover

Cada linha tem um botão de edição, que abre o mesmo editor com o código fixo e o HTML carregado, e um botão de remoção.

Remover pede confirmação e explica o resultado: os pedidos que atinjam esse código voltam a usar a página predefinida do servidor.

## Resolução de Problemas

**A minha página não aparece.** Confirme que está a desencadear o código correto. Um caminho que redireciona nunca chega a um 404. Teste com um URL que genuinamente não exista, numa janela privada para que nenhuma cache esteja envolvida.

**A página aparece mas sem estilo.** A sua folha de estilo foi removida por ser um recurso remoto. Coloque o CSS em linha.

**O meu script de monitorização está em falta.** Os scripts são removidos propositadamente. Não há forma de executar JavaScript a partir de uma página de erro personalizada aqui.

**Todos os códigos já têm uma página.** Todos os oito estão em uso. Edite uma página existente em vez de adicionar outra.

**O selo diz que a página marcada não foi servida.** Guarde novamente a página. Se persistir, e não tiver aparecido nenhum aviso de conflito de domínio, abra um pedido de suporte.

## Páginas Relacionadas

- [Redirecionamentos de Site](https://support.kapsulehost.com/pt-pt/site-redirects) para evitar que o 404 aconteça, em primeiro lugar.
- [Análise de Tráfego do Site](https://support.kapsulehost.com/pt-pt/site-analytics) para ver quantas respostas 4xx e 5xx está realmente a servir.
- [Proteger um Site com Palavra-passe](https://support.kapsulehost.com/pt-pt/site-password-protect), que produz respostas 401 por conceção.