能否基于API返回值动态开启/关闭Nginx特定location配置？

首先明确你的配置问题 #

• Nginx的if指令不能嵌套location块，你写的这种写法属于语法错误，直接启动Nginx会失败。
• Nginx是静态配置服务，启动时会加载所有配置并完成编译，运行过程中无法直接通过API返回值动态修改配置块结构。

可行解决方案 #

方案1：用auth_request模块实现动态验证

auth_request是Nginx官方内置模块（多数发行版默认编译），可以在处理请求前调用外部API，根据API返回的状态码决定是否放行请求。

假设你的API返回200 OK代表true，其他状态码代表false，配置示例如下：

server {
    root /var/www/public;
    index index.php index.html index.htm index.nginx-debian.html;
    server_name demo.example.com;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # 内部调用API的location，仅用于auth_request验证
    location = /_check_api {
        internal;
        proxy_pass https://myurl.com/optional;
        proxy_pass_request_body off;
        proxy_set_header Content-Length "";
        # 拦截API的错误状态码，统一返回403给auth_request
        proxy_intercept_errors on;
        error_page 404 500 502 503 504 =403;
    }

    location /optional {
        # 先调用API验证
        auth_request /_check_api;
        # 验证通过则转发到后端服务
        proxy_pass http://localhost:8989;
        # 验证失败返回403页面
        error_page 403 = /403.html;
    }
}

如果API返回的是JSON格式的true/false，可以配合ngx_http_js_module或Lua模块解析返回内容，再返回对应状态码给auth_request。

方案2：用Lua模块实现灵活的逻辑判断

如果需要直接解析API返回的JSON内容（比如API直接返回true或{"enabled": true}），可以使用lua-nginx-module（推荐用OpenResty打包版本，自带该模块）：

server {
    root /var/www/public;
    index index.php index.html index.htm index.nginx-debian.html;
    server_name demo.example.com;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location /optional {
        access_by_lua_block {
            local http = require "resty.http"
            local httpc = http.new()
            -- 调用API
            local res, err = httpc:request_uri("https://myurl.com/optional", {
                method = "GET",
                ssl_verify = false -- 根据实际需求开启/关闭SSL验证
            })

            -- API调用失败直接返回403
            if not res then
                ngx.exit(403)
            end

            -- 解析API返回的JSON内容
            local cjson = require "cjson"
            local api_result = cjson.decode(res.body)
            -- 假设API直接返回布尔值true，否则拦截
            if api_result ~= true then
                ngx.exit(403)
            end
        }

        proxy_pass http://localhost:8989;
        error_page 403 = /403.html;
    }
}

方案3：定时刷新配置（适合非实时场景）

如果可以接受几分钟的生效延迟，可编写脚本定时调用API，根据返回值生成合法的Nginx配置片段，验证后再reload Nginx，避免直接替换配置的稳定性问题。

示例Shell脚本（update_nginx_config.sh）：

#!/bin/bash
API_URL="https://myurl.com/optional"
CONFIG_FILE="/etc/nginx/sites-available/demo.example.com"
TEMP_CONFIG="/tmp/demo.example.conf.tmp"

# 获取API返回结果
API_RESULT=$(curl -s $API_URL)

# 复制原配置到临时文件
cp $CONFIG_FILE $TEMP_CONFIG

# 根据API结果添加/删除location块
if [ "$API_RESULT" = "true" ]; then
    # 检查是否已存在目标location，不存在则添加
    if ! grep -q "location /optional" $TEMP_CONFIG; then
        sed -i '/location \/ {/a \        location /optional {\n                proxy_pass http://localhost:8989;\n        }' $TEMP_CONFIG
    fi
else
    # 删除目标location块
    sed -i '/location \/optional {/,/}/d' $TEMP_CONFIG
fi

# 验证配置合法性，合法则替换并reload
nginx -t -c $TEMP_CONFIG
if [ $? -eq 0 ]; then
    cp $TEMP_CONFIG $CONFIG_FILE
    systemctl reload nginx
fi

rm $TEMP_CONFIG

添加到crontab定时执行（比如每5分钟一次）：

*/5 * * * * /path/to/update_nginx_config.sh

内容的提问来源于stack exchange，提问作者Alcinos