在Nginx配置中，set指令确实不能直接在http块顶层使用，这是由Nginx的指令作用域规则决定的。

以下是详细解释和正确用法：

错误原因：

当你在http块顶层直接使用set指令时（如http { set $var value; }），Nginx会报错：

"set" directive is not allowed here in /etc/nginx/nginx.conf:3

这是因为set指令属于‌请求处理阶段‌的指令，而http块是全局配置块，不能直接包含请求处理阶段的指令。

正确使用位置

set指令应该放在以下位置之一：

• ‌server块内‌ - 作用于当前虚拟主机

• location块内‌ - 作用于特定路径

• if块内‌ - 条件判断中‌

• map指令中‌（推荐替代方案） - 全局变量映射

推荐解决方案：

方案1：使用map指令（推荐）

nginx
http {
    # 全局变量映射（在http块中允许）
    map $http_user_agent $is_mobile {
        default       0;
        "~*Android"  1;
        "~*iPhone"   1;
    }
 
    server {
        listen 80;
        server_name example.com;
 
        location / {
            # 在location块中使用map定义的变量
            if ($is_mobile) {
                root /var/www/mobile;
            }
            # ...
        }
    }
}

方案2：在server/location块中使用set

nginx
http {
    server {
        listen 80;
        server_name example.com;
 
        # 在server块中设置变量
        set $backend_server "backend1";
 
        location /api {
            # 在location块中可以覆盖server块的变量
            set $backend_server "backend2";
            proxy_pass http://$backend_server;
        }
    }
}

方案3：使用geo模块（IP相关变量）

nginx
http {
    geo $client_ip {
        default 192.168.1.1;
        10.0.0.0/8 10.0.0.1;
    }
 
    server {
        # ...
    }
}

常见问题排查：

‌1.变量未初始化错误‌：

nginx: [emerg] using uninitialized "$var" variable

解决方案：确保变量在使用前已被赋值，或使用default值：

nginx
map $http_cookie $var {
    default   "default_value";
    "~id=([^;]+)" $1;
}

1. ‌

2.作用域问题‌：

• http块中定义的变量可在所有server块中使用

• server块中定义的变量只在当前虚拟主机有效

• location块中定义的变量只对当前路径有效

完整示例：

nginx
http {
    # 全局map定义（允许）
    map $http_host $site_root {
        default       /var/www/default;
        "~^www\.(.*)" /var/www/$1;
    }
 
    server {
        listen 80;
        server_name example.com;
 
        # 在server块中设置变量
        set $theme "default";
 
        location /admin {
            # 覆盖server块的变量
            set $theme "admin";
            root $site_root/$theme;
        }
 
        location / {
            root $site_root/$theme;
        }
    }
}

建议检查你的配置文件，将set指令移动到适当的块中。如果需要全局变量，优先考虑使用map或geo模块。

配置修改后，记得运行nginx -t测试语法，然后nginx -s reload重新加载配置。

阅读原文：原文链接​