Sites
Páginas de Erro Personalizadas
A custom error page replaces the plain server default with your own branded HTML, while keeping the true error status so search engines still see a real 404. This guide covers adding a page for each…
Uma página de erro personalizada substitui o padrão simples do servidor pelo seu próprio HTML com marca, mantendo o verdadeiro status de erro para que os mecanismos de busca ainda vejam um 404 real. Este guia cobre como adicionar uma página para cada código suportado, o que é removido por segurança e como funciona o distintivo de verificação.
Onde as Páginas de Erro Ficam no KPanel
- Faça login em KPanel.
- Clique em Websites na barra lateral esquerda e clique no site.
- Na aba do site, abra Advanced e depois Error pages.
O endereço direto é /websites/<site-id>/error-pages.
Por Que Se Preocupar
Uma página de erro padrão do servidor é um beco sem saída. Não tem marca, sem navegação e sem explicação, então um visitante que cair em uma geralmente sai.
Uma página personalizada transforma isso em uma rota de volta ao site: seu logotipo, sua tipografia, uma frase com sua própria voz e um link para home ou para uma caixa de busca. Em um site grande, URLs digitadas incorretamente e desatualizadas são um fluxo constante de tráfego, e uma página 404 é a recuperação mais barata que você jamais construirá.
Os Códigos Suportados
Você pode definir uma página personalizada para oito códigos, uma página por código:
| Código | Significado | Causa típica |
|---|---|---|
| 400 | Bad Request | Uma solicitação malformada |
| 401 | Unauthorized | Autenticação necessária ou falhou |
| 403 | Forbidden | Uma regra de acesso bloqueou a solicitação |
| 404 | Not Found | Nada existe nessa URL |
| 500 | Internal Server Error | Sua aplicação falhou |
| 502 | Bad Gateway | A aplicação não respondeu corretamente |
| 503 | Service Unavailable | A aplicação está desligada ou sobrecarregada |
| 504 | Gateway Timeout | A aplicação demorou muito |
Comece com 404. É de longe a mais comum, e é a única que um visitante alcança através de navegação ordinária em vez de uma falha.
A família 5xx vale a pena fazer em seguida, porque essas são as páginas que as pessoas veem no seu pior dia. Uma página com marca calma que diz que algo deu errado e fornece um endereço de e-mail é muito melhor que um erro em branco do servidor.
Adicionando uma Página
- Clique em Add error page.
- Escolha um código de erro no dropdown. Códigos já em uso não estão listados.
- Substitua o HTML de exemplo no campo HTML body pelo seu próprio.
- Clique em Add error page.
O editor começa com um documento 404 funcional que você pode editar, que é um bom ponto de partida se você apenas quer algo arrumado rapidamente.
Escrevendo o HTML
Forneça um documento HTML completo, começando com um doctype. É servido como está, então deve ser independente.
Alguns HTML são removidos antes da página ser armazenada, por segurança:
- Tags
<script> - manipuladores de eventos inline como
onclick - iframes
- folhas de estilo remotas
Se algo foi removido, um aviso o informa após salvar.
Como folhas de estilo remotas são removidas, uma página de erro não pode extrair o arquivo CSS principal do seu site. Estilize-o com CSS inline ou um bloco <style> no head do documento. Isso é intencional: uma página de erro deve ser renderizada quando o resto do site está quebrado, e uma página que depende de buscar ativos de um servidor falhando será renderizada como texto sem estilo exatamente no momento errado.
Orientação prática:
- Mantenha-a pequena e autossuficiente. Incorpore tudo. Evite imagens externas. A lista de páginas mostra o tamanho de cada página em KB.
- Diga o que aconteceu em linguagem simples. "Não conseguimos encontrar essa página" é melhor que "404 Not Found".
- Dê um caminho adiante. Um link para home, um link para suas seções principais ou uma caixa de busca.
- Inclua uma rota de contato nas páginas 5xx, já que o visitante não pode usar o site para alcançá-lo.
- Não a use para redirecionar. Se uma URL foi movida, redirecione-a adequadamente. Veja Site Redirects.
O Código de Status É Preservado
Sua página personalizada é servida com o verdadeiro status de erro, não 200. Um 404 permanece um 404 até o cliente.
Isso importa mais do que parece. Uma página com marca retornada como 200 é um soft 404: mecanismos de busca a indexam como uma página real, sua analítica a conta como uma visualização bem-sucedida, e links quebrados nunca são sinalizados por nenhuma ferramenta. Como Kapsule mantém o verdadeiro status, tudo isso continua funcionando corretamente.
Lendo o Distintivo de Status
A coluna Status relata o que realmente pôde ser verificado, e é deliberadamente honesta sobre as limitações.
| Distintivo | Significado |
|---|---|
| Verified: branded page served (true 404) | Forçamos um 404 de fora e recebemos sua página com o status correto |
| Configured (not externally tested) | A página está aplicada. Esse código não pode ser acionado de fora sob demanda |
| Not yet verified | A verificação ainda não foi executada |
| Applied, live test inconclusive | A sonda obteve algo diferente de um 404 limpo, frequentemente porque um redirecionamento a capturou |
| Got a 404 but the branded page was not served | A regra está em vigor, mas sua página não voltou. Tente salvar novamente |
Apenas 404 pode ser forçado externamente. Solicitar uma URL que não existe produz confiavelmente um 404, mas não há maneira de fazer um servidor saudável produzir um verdadeiro 500 sob demanda sem quebrá-lo. Então os outros códigos relatam Configured em vez de afirmar uma verificação que nunca aconteceu. Eles ainda servem quando o erro genuinamente ocorre.
Você também pode ver um aviso de que outra configuração no servidor reclama do mesmo domínio. Até que isso seja resolvido, a página de erro pode não se aplicar. Entre em contato com o suporte se vir isso.
Resolvendo Problemas de um Site que Está Realmente com Erro
Se você está aqui porque seu site está lançando erros em vez de porque deseja páginas mais legais, a página tem um atalho: o botão Troubleshoot with Kora no banner no topo.
Ele pede ao Kora, o assistente dentro do KPanel, para ler seus logs de erro e falhas recentes deste site e dizer a você a causa provável e como corrigir. Esse é um primeiro passo muito mais rápido do que ler logs brutos.
Para o quadro de desempenho subjacente, veja Site Performance and APM, e para a taxa de erro ao longo do tempo, veja Site Traffic Analytics.
Editando e Removendo
Cada linha tem um botão editar, que abre o mesmo editor com o código fixo e o HTML carregado, e um botão remover.
Remover pede confirmação e explica o resultado: solicitações que atingem esse código voltam para a página padrão do servidor.
Resolvendo Problemas
Minha página não está aparecendo. Confirme que você está acionando o código correto. Um caminho que redireciona nunca alcança um 404. Teste com uma URL que genuinamente não existe, em uma janela privada para que nenhum cache esteja envolvido.
A página aparece mas parece sem estilo. Sua folha de estilo foi removida como um ativo remoto. Incorpore o CSS.
Meu script de rastreamento está faltando. Scripts são removidos por design. Não há maneira de executar JavaScript 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 distintivo diz que a página com marca não foi servida. Salve a página novamente. Se persistir e nenhum aviso de conflito de domínio apareceu, abra um ticket.
Páginas Relacionadas
- Site Redirects para evitar que o 404 aconteça em primeiro lugar.
- Site Traffic Analytics para ver quantas respostas 4xx e 5xx você está realmente servindo.
- Password-Protecting a Site, que produz respostas 401 por design.