Nginx 中怎么使用 try_files 实现整站离线维护模式的无缝切换-Nginx-PHP中文网

Nginx 用 try_files 实现整站离线维护模式，通过 touch/rm /var/run/nginx-maint.flag 开关文件触发 503 状态码返回维护页，无需重载配置、不中断连接、实时生效。

nginx 中怎么使用 try_files 实现整站离线维护模式的无缝切换

在 Nginx 中，用 try_files 实现整站离线维护模式，核心是让所有请求（除特定资源外）都返回一个预设的维护页，同时保持 HTTP 状态码为 503 Service Unavailable，并支持快速回切——无需重载配置、不中断连接、不改变 upstream 状态。

维护页准备与状态码控制

先准备好静态维护页（如 /usr/share/nginx/html/maint.html），内容可含提示语和倒计时。关键不是只返回页面，而是必须返回标准 503 状态码，否则搜索引擎或监控系统无法识别为临时不可用。

在 server 块中添加：

error_page 503 /maint.html;
location = /maint.html {
    internal;
    root /usr/share/nginx/html;
}

这确保只有内部跳转能访问该页，防止用户直接请求 /maint.html 暴露维护状态。

用 try_files 统一拦截所有请求

在 location / 块中，利用 try_files 的“文件不存在即 fallback”逻辑，结合一个**始终不存在的标记文件**来触发维护模式：

创建一个开关文件，比如 /var/run/nginx-maint.flag
正常时该文件不存在 → try_files $uri $uri/ @backend 继续转发
维护时手动创建该文件 → try_files /var/run/nginx-maint.flag =503 直接返回 503

完整写法示例：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

location / {
    # 维护开关：存在则全站 503
    try_files /var/run/nginx-maint.flag =503 $uri $uri/ @backend;
}
<p>location @backend {
proxy_pass <a href="https://www.php.cn/link/c51722d35b697aaf591f6066d68b57bd">https://www.php.cn/link/c51722d35b697aaf591f6066d68b57bd</a>;
proxy_set_header Host $host;
}</p>

注意顺序：/var/run/nginx-maint.flag 放最前，且用 =503 显式指定状态码；后面才是正常路径回退逻辑。

无缝切换的关键操作细节

真正“无缝”的关键是：不 reload、不 restart、不改配置文件。

开启维护：touch /var/run/nginx-maint.flag
关闭维护：rm /var/run/nginx-maint.flag
Nginx 在每次请求时实时检查该文件是否存在，毫秒级生效
已建立的长连接（如 WebSocket、HTTP/2 流）不受影响，新请求立即走维护逻辑

建议配合 proxy_cache_bypass 和 expires -1 避免维护页被 CDN 或浏览器缓存太久。

增强可用性的小技巧

运维人员需要访问后台？加一条白名单规则：

location / {
    # 允许内网或指定 IP 跳过维护
    if ($remote_addr ~ "^(192\.168\.|10\.)") {
        break;
    }
    try_files /var/run/nginx-maint.flag =503 $uri $uri/ @backend;
}

或者更安全地用 map 配合 allow/deny 控制，避免 if 在 location 中的限制问题。也可为维护页加简单 JS 自动刷新检测开关文件是否移除，实现“半自动恢复”提示。