实战演示Nginx实现基于时间的站点维护页面自动切换-Nginx-PHP中文网

可通过 cron + 文件标记 + Nginx map 实现自动维护页切换：每分钟检查时间，若在设定时段（如02:00–04:00）则创建 /var/run/nginx-maint-on，Nginx 用 map 判断该文件是否存在来决定是否返回维护页。

实战演示nginx实现基于时间的站点维护页面自动切换

想让网站在特定时间段自动显示维护页，其他时间正常访问？Nginx 本身不支持“定时任务”，但可以通过配合系统 cron + 文件触发 + map 指令实现零依赖、低开销的基于时间的自动切换。下面用真实可运行的配置演示整个流程。

核心思路：用外部文件状态代替时间判断

Nginx 的 map 指令能根据变量值映射出新变量，而 $time_iso8601 或 $date_gmt 是动态的——但直接解析时间字符串做逻辑判断既复杂又低效。更稳妥的做法是：

用系统 cron 每分钟检查当前是否处于维护时段（如每天 02:00–04:00）
若在时段内，写入一个标记文件（如 /var/run/nginx-maint-on）；否则删除它
Nginx 用 map 检查该文件是否存在，决定是否启用维护页

第一步：配置定时任务生成维护标记

编辑 root 用户的 crontab（sudo crontab -e），添加一行：

* * * * * /bin/sh -c 'if [[ $(date +\%H\%M) > \"0200\" ]] && [[ $(date +\%H\%M)

说明：

每分钟执行一次，确保切换及时（误差 ≤1 分钟）
使用 date +\%H\%M 输出类似 0235 的字符串，便于字典序比较
注意转义 % 符号（crontab 中需写成 \%H\%M）
标记文件路径建议用 /var/run/（tmpfs，重启清空，安全）

第二步：Nginx 配置中用 map 映射维护状态

在 http{} 块中加入：

map $document_root $maint_mode {
    default off;
    ~*\/var\/run\/nginx-maint-on on;
}

⚠️ 注意：$document_root 是稳定存在的内置变量，我们“借用”它来触发 map 计算；实际判断依据是 /var/run/nginx-maint-on 文件是否存在（Nginx 会自动识别文件存在性）。

Nginx Reverse Proxy

配置 Nginx 反向代理，实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发，将域名绑定到指定 IP:端口。

下载

然后在 server 块中启用维护逻辑：

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;"># 维护页配置
set $maint_page "/usr/share/nginx/html/maint.html";
if ($maint_mode = on) {
    return 503;
}

error_page 503 @maintenance;
location @maintenance {
    root /usr/share/nginx/html;
    try_files $maint_page =503;
    internal;
}

# 正常站点配置（略）
location / {
    proxy_pass http://backend;
}

}

关键点：