# Como configurar o Apache para usar páginas de erro personalizadas 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](https://www.ionos.com/digitalguide/hosting/technical-matters/what-is-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](https://www.ionos.com/digitalguide/server/configuration/how-to-install-an-apache-web-server/) fornece um conjunto padrão de páginas de erro genéricas para [Erro 404](https://www.ionos.com/digitalguide/websites/website-creation/what-does-the-404-not-found-error-mean/), [Erro HTTP 500](https://www.ionos.com/digitalguide/hosting/technical-matters/http-error-500-internal-server-error/) 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](https://www.ionos.com/digitalguide/server/know-how/what-is-centos-versions-system-requirements/) Stream 9 ou [Ubuntu](https://www.ionos.com/digitalguide/server/know-how/ubuntu-the-linux-system-for-everyone/) 24.04) - [Apache](https://www.ionos.com/digitalguide/server/know-how/what-is-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](https://www.ionos.com/digitalguide/server/configuration/install-apache-on-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](https://www.ionos.com/pt-br/digitalguide/servidor/ferramentas/o-que-e-ssh-protocolo-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: ```bash sudo nano my-404.html ``` Coloque o seguinte nesse arquivo: ```none My Custom 404 Error Page

Whoops, page not found! Sorry about that.

``` 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 é: ```none 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: ```none 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: ```none ServerName example.com ErrorDocument 404 /my-404.html AllowOverride All ``` 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](https://www.ionos.com/digitalguide/hosting/technical-matters/the-most-important-http-status-codes-at-a-glance/) pode ser encontrada em outro de nossos artigos. Uma lista completa dos códigos de erro pode ser encontrada na [Wikipedia](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#4xx_Client_Error). This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/configurar-o-apache-para-usar-paginas-de-erro-personalizadas/](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/configurar-o-apache-para-usar-paginas-de-erro-personalizadas/) for AI/LLM consumption.