nginx源码编译未启用auth_request模块则默认不可用，必须显式添加--with-http_auth_request_module参数并重新编译替换二进制文件，否则配置中使用auth_request指令将报“unknown directive”错误。
如果 Nginx 源码编译时没启用 auth_request 模块，它默认不可用——哪怕你写了 auth_request /auth;，Nginx 启动也会报错：“unknown directive ‘auth_request’”。启用它必须在编译阶段显式加入参数。
确认当前 Nginx 是否已支持该模块
运行以下命令查看编译参数：
nginx -V 2>&1 | grep -o with-http_auth_request_module若输出为空，说明未启用；若显示 with-http_auth_request_module，则已内置（Nginx ≥1.5.4 默认可能已含，但生产环境仍建议确认）。
重新编译添加 auth_request 模块
无需卸载旧版本，可增量编译替换二进制文件。步骤如下：
- 进入原始 Nginx 源码目录（如
/software/nginx-1.24.0/） - 执行
./configure，**必须包含**：
--with-http_auth_request_module
同时保留原有所有模块参数（用nginx -V查到的--with-xxx全部带上），避免丢失 SSL、gzip、proxy 等常用功能 - 执行
make（注意：不要make install） - 备份原二进制：
mv /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak - 复制新编译出的二进制：
cp objs/nginx /usr/local/nginx/sbin/ - 验证配置并重载：
nginx -t && nginx -s reload
常见注意事项
模块启用后还需正确配置才能生效，重点包括：
-
location = /auth { internal; ... }中的internal不可省略，否则外部可直连鉴权接口，造成绕过风险 - 子请求默认不传请求体（
proxy_pass_request_body off），若鉴权服务需要原始 body，需手动开启并设置Content-Length - 建议为
/auth设置超时与健康检查，例如：
proxy_connect_timeout 3s;
proxy_read_timeout 5s;
health_check interval=5 fails=2 passes=2;
验证模块是否真正生效
写一段最小配置测试：
location /test {auth_request /auth;
return 200 "allowed";
}
location = /auth {
internal;
return 200 "ok";
}
访问 /test 应返回 200；若报 500 或 “unknown directive”，说明模块未启用成功。
