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
- Inicie sessão no KPanel.
- Clique em Websites na barra lateral esquerda e depois clique no site.
- No menu esquerdo do site, abra Definições e depois Páginas de erro.
O endereço direto é /websites/<site-id>/error-pages.
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
- Clique em Adicionar página de erro.
- Escolha um código de erro na lista pendente. Os códigos já em uso não são apresentados.
- Substitua o HTML de exemplo no campo Corpo HTML pelo seu próprio.
- 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.
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.
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, e para a taxa de erros ao longo do tempo, consulte Análise de Tráfego do Site.
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 para evitar que o 404 aconteça, em primeiro lugar.
- Análise de Tráfego do Site para ver quantas respostas 4xx e 5xx está realmente a servir.
- Proteger um Site com Palavra-passe, que produz respostas 401 por conceção.