当前位置：首页 > 服务器技术 > 正文

Nginx虚拟主机错误页面配置详解（手把手教你为网站设置个性化404/500等错误提示）

在搭建网站时，我们常常会遇到用户访问不存在的页面（如输入错误网址）或服务器内部出错的情况。这时候，浏览器默认会显示一个非常简陋甚至“吓人”的错误页面。为了提升用户体验和网站专业度，我们可以使用 Nginx 虚拟主机功能来自定义这些错误页面。

本文将从零开始，详细讲解如何在 Nginx 中为虚拟主机配置自定义的错误页面（如 404、500 等），即使你是完全的新手也能轻松上手！

什么是 Nginx 虚拟主机？

Nginx 虚拟主机（Virtual Host）是指在一台服务器上通过 Nginx 配置多个独立的网站。每个网站可以拥有自己的域名、根目录、日志文件以及——独立的错误页面。这使得我们可以为不同站点分别定制错误提示，而不会互相干扰。

常见的 HTTP 错误状态码

在配置错误页面前，先了解几个常用的错误状态码：

404：页面未找到（用户访问了不存在的 URL）
500：服务器内部错误
403：禁止访问（权限不足）
400：请求无效

步骤一：准备自定义错误页面

首先，在你的网站根目录下创建一个专门存放错误页面的文件夹，比如叫 errors。然后在里面创建 HTML 文件，例如：

404.html
500.html

以 404.html 为例，内容可以如下（你可以根据品牌风格自由设计）：

<!DOCTYPE html><html lang="zh-CN"><head>  <meta charset="UTF-8">  <title>页面未找到 - 404</title>  <style>    body { font-family: Arial; text-align: center; padding: 50px; }    h2 { color: #e74c3c; }    a { color: #3498db; text-decoration: none; }  </style></head><body>  <h2>哎呀！页面找不到了 😢</h2>  <p>您访问的页面可能已被删除或移动。</p>  <p><a href="/">返回首页</a></p></body></html>

步骤二：修改 Nginx 虚拟主机配置

找到你的 Nginx 虚拟主机配置文件。通常位于 /etc/nginx/sites-available/ 或 /etc/nginx/conf.d/ 目录下。假设你的站点配置文件名为 example.com.conf。

在 server 块中添加 error_page 指令：

server {    listen 80;    server_name example.com www.example.com;    root /var/www/example.com;    index index.html;    # 自定义错误页面    error_page 404 /errors/404.html;    error_page 500 502 503 504 /errors/500.html;    # 确保错误页面能被访问    location /errors/ {        internal;  # 可选：防止用户直接访问 /errors/ 路径    }}

说明：