温馨提示×

Nginx错误页面怎么自定义

小樊
207
2025-06-07 13:31:41
栏目: 编程语言

要自定义 Nginx 错误页面,请按照以下步骤操作:

  1. 创建自定义错误页面文件:首先,您需要创建自定义的 HTML 文件,用于显示错误信息。例如,您可以创建一个名为 custom_404.html 的文件,用于自定义 404 错误页面。将此文件放在您的 Nginx 服务器的根目录或其他您选择的目录中。
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>自定义 404 错误页面</title>
</head>
<body>
   <h1>抱歉,您访问的页面不存在。</h1>
   <p>请检查 URL 是否正确,或返回 <a href="/">首页</a></p>
</body>
</html>
  1. 修改 Nginx 配置文件:接下来,您需要修改 Nginx 配置文件,以便在发生错误时使用您创建的自定义错误页面。打开 Nginx 配置文件(通常位于 /etc/nginx/nginx.conf/etc/nginx/sites-available/your_domain.conf),然后在 server 块中添加以下代码:
error_page 404 /custom_404.html;
location = /custom_404.html {
    root /path/to/your/custom/error/pages;
}

请将 /path/to/your/custom/error/pages 替换为您存储自定义错误页面文件的实际路径。

  1. 重复步骤 2,为其他错误代码创建自定义错误页面。例如,如果您想自定义 500 错误页面,只需创建一个名为 custom_500.html 的文件,并在 Nginx 配置文件中添加相应的 error_pagelocation 块。

  2. 保存更改并重新加载 Nginx:完成上述更改后,保存配置文件并重新加载 Nginx 以使更改生效。在命令行中运行以下命令:

sudo nginx -t      # 检查配置文件语法是否正确
sudo nginx -s reload  # 重新加载配置文件

现在,当用户遇到错误时,Nginx 将显示您自定义的错误页面。

0