Como configurar o Apache para usar páginas de erro personalizadas

IONOS editorial team20/01/20254 mins

A criação de páginas de erro personalizadas do Apache permite que você torne seu design e sua marca visíveis em todo o site, entre outras coisas. Mostraremos a você como fazer isso.

Por que você deve ter uma página de erro personalizada?

Ninguém quer que ocorram erros HTTP em seu servidor da Web. No entanto, isso pode acontecer de tempos em tempos, dependendo 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 configuração de páginas de erro personalizadas permite que você:

Continuar com sua marca nessas páginas
Integrar o design dessas páginas à aparência do seu site
Direcione os visitantes perdidos para os destinos pretendidos
Fornecer páginas de erro em outros idiomas além do inglês

Requisitos

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 plataformas 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 personalizada

Primeiro, você precisará criar a página de erro personalizada. 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 combinações de teclas [Ctrl] + [O] and [Ctrl] + [X]. Agora você pode visualizar o arquivo acessando http://example.com/my-404.html para garantir que ele seja exibido corretamente.

Como criar uma página de erro personalizada do Apache

Agora você precisa configurar 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 ErrorDocument. A sintaxe dessa diretiva é:

ErrorDocument 404 [path to file]

Se você quiser usar essa página de erro globalmente, a diretiva deverá estar no arquivo de configuraçã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 disponível em vários idiomas), ele deverá estar em um VirtualHost bloco de comandos. Nesta seção, trataremos principalmente da configuração global.

De acordo com a prática comum, esse arquivo de configuração do Apache geralmente é:

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

Nota

O local e o nome do arquivo de configuração do Apache de um site podem variar de acordo com a forma como você ou o administrador do servidor configurou a hospedagem.

Edite esse arquivo com o editor de sua preferência, 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 ErrorDocument 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 configuração correspondente até encontrar o bloco de comandos VirtualHost . Certifique-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 alteraçõ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á redirecionado para sua nova página 404 personalizada.

Outros códigos de erro HTTP

O erro personalizado mais comum é o erro 404, mas você também pode criar mensagens de erro personalizadas 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 importantes pode ser encontrada em outro de nossos artigos. Uma lista completa dos códigos de erro pode ser encontrada na Wikipedia.

Este artigo foi útil?