nginx 将502错误替换为一个自定义的“维护中”页面

最新推荐文章于 2025-04-23 12:00:00 发布

梦幻南瓜

最新推荐文章于 2025-04-23 12:00:00 发布

阅读量225

点赞数 3

分类专栏： Nginx 文章标签： nginx 运维

本文链接：https://blog.youkuaiyun.com/ybg8912/article/details/146016617

版权

Nginx 专栏收录该内容

28 篇文章

订阅专栏

1. 创建维护页面
首先，创建一个HTML文件作为维护页面，例如 maintenance.html，内容如下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>维护中</title>
</head>
<body>
    <h1>网站正在维护中</h1>
    <p>请稍后再访问。</p>
</body>
</html>

将此文件放在Nginx的某个目录下，例如 /usr/share/nginx/html/maintenance.html。

2. 配置Nginx
编辑Nginx配置文件（通常在 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available/default），添加或修改以下内容：

server {
    listen 80;
    server_name yourdomain.com;

    # 默认返回502错误
    error_page 502 /maintenance.html;

    location = /maintenance.html {
        root /usr/share/nginx/html;
        internal;
    }

    location / {
        # 正常配置
        proxy_pass http://backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}