Linux下Nginx源码编译安装SetMisc模块变量设置-Nginx-PHP中文网

在 Linux 下需先安装编译依赖，下载 Nginx 源码、ngx_devel_kit（NDK）和 set-misc-nginx-module，configure 时按 --add-module=NDK、--add-module=SetMisc 顺序添加，再 make && make install；启用后可在 location 中用 set_unescape_uri、set_if 等指令，但须置于 proxy_pass 前且注意 set_if 仅支持简单比较。

linux下nginx源码编译安装setmisc模块变量设置

在 Linux 下通过源码编译安装 Nginx 并集成 set-misc-nginx-module（简称 SetMisc 模块），是为了支持如 set_escape_uri、set_unescape_uri、set_quote_sql_str、set_if 等增强型变量操作指令。该模块不包含在官方 Nginx 中，需手动打补丁并编译。

确认依赖与前置环境

确保系统已安装基础编译工具和 PCRE、OpenSSL、zlib 开发库：

CentOS/RHEL：yum install gcc gcc-c++ make pcre-devel openssl-devel zlib-devel
Ubuntu/Debian：apt-get install build-essential libpcre3-dev libssl-dev zlib1g-dev
下载 Nginx 源码（如 nginx-1.24.0）及对应版本的 set-misc-nginx-module（推荐从 GitHub 官方仓库获取）
注意：SetMisc 模块依赖 ngx_devel_kit（NDK），必须一并下载并先加载

编译时正确添加模块顺序

SetMisc 必须在 NDK 之后、其他模块之前加载，否则编译会报未定义符号错误。典型 configure 命令如下：

./configure \
  --add-module=/path/to/ngx_devel_kit \
  --add-module=/path/to/set-misc-nginx-module \
  --prefix=/usr/local/nginx \
  --with-http_ssl_module \
  --with-http_realip_module \
  --with-pcre \
  --with-zlib=../zlib-1.3 \
  --with-openssl=../openssl-3.0.13

关键点：

--add-module 的顺序不能颠倒：NDK 必须在 SetMisc 前面
若使用系统自带 PCRE/OpenSSL/zlib，可去掉 --with-pcre 和路径参数，改用 --with-pcre-system（部分旧版本不支持，建议显式指定源码路径更稳妥）
执行 make && sudo make install 完成安装

在配置中安全使用 SetMisc 变量指令

模块启用后，可在 server、location 或 if 块中使用变量设置指令。常见用法示例：

location /api/ {
    # 对请求参数做 URI 解码再赋值
    set_unescape_uri $decoded_arg $arg_data;
<pre class="brush:php;toolbar:false;"># 条件设置变量（注意：set_if 不支持嵌套或复杂逻辑）
set_if ($arg_debug = "1") $enable_log "on";

# SQL 转义防注入（仅限日志或调试，生产慎用）
set_quote_sql_str $safe_user $arg_username;

proxy_set_header X-User $safe_user;
proxy_pass http://backend;

}

注意事项：