Nginx 怎么利用 index 指令配合错误页面实现优雅的站点维护公告-Nginx-PHP中文网

真正实现“一键启用维护公告”的核心是try_files配合index指令——前者主动拦截所有请求并返回/maintenance.html或503状态码，后者仅对目录请求自动兜底查找maintenance.html；配合ip白名单、自包含html及curl测试可完成免重启维护切换。

nginx 怎么利用 index 指令配合错误页面实现优雅的站点维护公告

直接用 index 指令本身无法触发维护页，它只在访问目录（如 / 或 /blog/）时自动找默认文件。真正实现“一键启用维护公告”的核心是 try_files 配合 index 的辅助作用——前者负责主动拦截所有请求，后者确保兜底路径能正确加载 HTML 文件。

用 try_files 强制返回维护页（最常用）

把维护页设为 try_files 的第一项，存在即返回，状态码可设为 503 表示服务不可用：

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

关键点：
– /maintenance.html 是绝对路径，会拼接 root 路径，实际查找 /usr/share/nginx/html/maintenance.html
– 文件存在就返回，不存在则直接返回 503 状态码（浏览器显示空白或默认错误页）
– 不影响静态资源：可单独为 .js/.css 等加 location 块，避免维护页里的样式丢失

配合 index 实现目录级自动兜底

当用户访问的是一个目录（比如直接打开 https://example.com/），index 指令可让 Nginx 自动尝试找 maintenance.html：

index maintenance.html index.html;

这样配置后：
– 请求 / 时，Nginx 先查 /maintenance.html，存在就返回
– 若维护页不存在，再找 /index.html，恢复正常首页
– 注意：这仅对目录请求生效，对 /about、/api/login 这类非目录路径无效，仍需靠 try_files 或 error_page 控制

按条件启用（如白名单绕过）

运维人员或内网 IP 可跳过维护页，普通用户看到公告：

Nginx

在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能，一键优化高并发性能，助您高效搭建稳定、快速的网站运行环境。

下载

用 map 或 if 判断客户端 IP，设置开关变量
再结合 try_files 或 return 控制流向

示例片段：

set $maint_mode off;
if ($remote_addr != "192.168.1.100") { set $maint_mode on; }
if (-f $document_root/maintenance.html) { set $maint_mode "${maint_mode}on"; }
if ($maint_mode = "onon") { return 503; }

该方式无需重启 Nginx，只需创建/删除 maintenance.html 文件即可切换状态