nginx 一键切换停机维护页面 —— 筑梦之路

背景说明

进行停机维护或者系统升级等操作，会影响到用户使用，如果停机维护期间用户未看到停机维护的通知，仍去访问系统，会提示默认不太友好的访问错误界面 ，这时如果在维护的时候直接展示停机公告的具体信息，会减少用户的误解。

如何实现

在 Nginx 中，可以设置一个特定的页面来作为"停机维护"或"系统升级"的页面。假设你的停机维护页面为maintenance.html或者maintenance.jpg，并且它位于你的网站主目录的/usr/share/nginx/html中。

首先，你需要在 Nginx 的配置文件中，通常是/etc/nginx/nginx.conf，找到需要配置维护页面的 server 块。

cat /etc/nginx/nginx.confserver {listen       80;listen       [::]:80;server_name  _;# root         /usr/share/nginx/html;# Load configuration files for the default server block.include /etc/nginx/default.d/*.conf;if (-f $document_root/maintenance.enable) {return 503;}location / {root /usr/share/nginx/html;index index.html index.htm;try_files $uri $uri/ =404;}# 定义503错误页面error_page 503 @maintenance;location @maintenance {root /usr/share/nginx/html;rewrite ^(.*)$ /maintenance.jpg break;}error_page 404 /404.html;location = /404.html {}error_page 500 502  504 /50x.html;location = /50x.html {}}

配置的意思是，如果存在/usr/share/nginx/html/maintenance.enable文件，则所有请求都返回503服务不可用，并显示maintenance.jpg页面。

当你需要进行系统维护时，只需要在网站主目录下创建一个maintenance.enable文件即可 当维护结束，删除这个文件，即可恢复正常访问。

cat maintenance_start.sh 
#!/bin/bash
# 启动维护模式# 创建维护标志文件
touch /usr/share/nginx/html/maintenance.enable
echo "Maintenance mode started."cat  maintenance_stop.sh 
#!/bin/bash
# 停止维护模式 
# 删除维护标志文件
rm -rf  /usr/share/nginx/html/maintenance.enable
echo "Maintenance mode stoped."

 这里提供一种相对友好的处理方式，仅供参考。