A criação de páginas de erro per­so­na­li­za­das do Apache permite que você torne seu design e sua marca visíveis em todo o site, entre outras coisas. Mos­tra­re­mos a você como fazer isso.

Por que você deve ter uma página de erro per­so­na­li­zada?

Ninguém quer que ocorram erros HTTP em seu servidor da Web. No entanto, isso pode acontecer de tempos em tempos, de­pen­dendo da carga do servidor, da conexão com a Internet ou da entrada do usuário. O servidor da Web Apache fornece um conjunto padrão de páginas de erro genéricas para Erro 404, Erro HTTP 500 e outros erros comuns.

No entanto, a con­fi­gu­ra­ção de páginas de erro per­so­na­li­za­das permite que você:

  • Continuar com sua marca nessas páginas
  • Integrar o design dessas páginas à aparência do seu site
  • Direcione os vi­si­tan­tes perdidos para os destinos pre­ten­di­dos
  • Fornecer páginas de erro em outros idiomas além do inglês

Re­qui­si­tos

  • Cloud Server em Linux (CentOS Stream 9 ou Ubuntu 24.04)
  • Apache está instalado e em execução
Dica

O Apache e o Ubuntu estão entre as pla­ta­for­mas de código aberto mais populares para hospedar um servidor da Web. Mostramos a você como instalar o Apache no Ubuntu.

Como criar a página de erro per­so­na­li­zada

Primeiro, você precisará criar a página de erro per­so­na­li­zada. Para fins de teste, criaremos uma página de erro de exemplo para lidar com erros 404.

Use SSH para se conectar ao seu servidor e acessar a raiz do documento do seu site (, muitas vezes /var/www/html/). Crie uma nova página chamada my-404.html com o comando:

sudo nano my-404.html
bash

Coloque o seguinte nesse arquivo:

<html>
<head>
<title>My Custom 404 Error Page</title>
</head>
<body>
<p>Whoops, page not found! Sorry about that.</p>
</body>
</html>

Salve o arquivo e saia do Nano com as com­bi­na­ções de teclas [Ctrl] + [O] and [Ctrl] + [X]. Agora você pode vi­su­a­li­zar o arquivo acessando http://example.com/my-404.html para garantir que ele seja exibido cor­re­ta­mente.

Como criar uma página de erro per­so­na­li­zada do Apache

Agora você precisa con­fi­gu­rar o servidor da Web Apache para que ele também use a página de erro que acabou de criar. Para fazer isso, adicione uma diretiva Er­ror­Do­cu­ment. A sintaxe dessa diretiva é:

ErrorDocument 404 [path to file]

Se você quiser usar essa página de erro glo­bal­mente, a diretiva deverá estar no arquivo de con­fi­gu­ra­ção principal do Apache. Se a página for usada somente para um host virtual, em vez disso, em um host virtual, por exemplo se o seu site estiver dis­po­ní­vel em vários idiomas), ele deverá estar em um VirtualHost bloco de comandos. Nesta seção, tra­ta­re­mos prin­ci­pal­mente da con­fi­gu­ra­ção global.

De acordo com a prática comum, esse arquivo de con­fi­gu­ra­ção do Apache ge­ral­mente é:

  • CentOS Stream 9 /etc/httpd/conf/httpd.conf
  • Ubuntu 24.04 /etc/apache2/apache2.conf
Nota

O local e o nome do arquivo de con­fi­gu­ra­ção do Apache de um site podem variar de acordo com a forma como você ou o ad­mi­nis­tra­dor do servidor con­fi­gu­rou a hos­pe­da­gem.

Edite esse arquivo com o editor de sua pre­fe­rên­cia, por exemplo, com o comando:

  • CentOS Stream 9 sudo nano /etc/httpd/conf/httpd.conf
  • Ubuntu 24.04 sudo nano /etc/apache2/apache2.conf

Insira o Er­ror­Do­cu­ment em um local adequado. Por exemplo:

ErrorDocument 404 /my-404.html

Se você quiser fazer isso somente para um host virtual, deverá percorrer o arquivo de con­fi­gu­ra­ção cor­res­pon­dente até encontrar o bloco de comandos VirtualHost . Cer­ti­fi­que-se de que a diretiva seja colocada fora dos blocos de comando do diretório. Por exemplo:

<VirtualHost *:80>
ServerName example.com
ErrorDocument 404 /my-404.html
    <Directory "/var/www/example.com/html">
    AllowOverride All
    </Directory>
</VirtualHost>

Salve e saia do arquivo e, em seguida, reinicie o Apache para que as al­te­ra­ções tenham efeito:

  • CentOS Stream 9 sudo systemctl restart httpd
  • Ubuntu 24.04 sudo systemctl restart apache2

Por fim, teste seu documento de erro inserindo um URL inválido para seu site. Em vez disso, você será re­di­re­ci­o­nado para sua nova página 404 per­so­na­li­zada.

Outros códigos de erro HTTP

O erro per­so­na­li­zado mais comum é o erro 404, mas você também pode criar mensagens de erro per­so­na­li­za­das para outras mensagens de erro HTTP. O Apache permite que você configure suas próprias páginas de erro para todos os códigos de erro 4xx e 5xx. Uma visão geral dos códigos de status HTTP mais im­por­tan­tes pode ser en­con­trada em outro de nossos artigos. Uma lista completa dos códigos de erro pode ser en­con­trada na Wikipedia.

Ir para o menu principal