在 nginx 中连接后台 scgi 接口，需要在 location 块中使用 scgi_pass 指令指定后端地址，并通过 include scgi_params; 加载标准参数映射。这样做会将 http 请求转换为符合 scgi 协议的数据流发送给后端，同时自动处理 content_length 和 request_method 等关键头部信息。
Nginx 配置 SCGI 代理的核心指令有哪些
核心配置包括 scgi_pass、scgi_param 以及标准的 scgi_params 文件。使用 scgi_pass 指向后端服务，通过 include 引入默认参数集可以确保后端能正确解析请求路径和方法，无需手动逐个设置基础字段。
server {
listen 80;
server_name example.com;
location /api {
# 指定后端 SCGI 服务器地址
scgi_pass 127.0.0.1:9000;
# 包含默认的 SCGI 参数映射
include scgi_params;
# 可选：自定义特定参数
scgi_param SCRIPT_NAME /api;
}
}
上述配置中，scgi_pass 后的地址可以是 IP 加端口，也可以是 Unix Socket 路径。当请求匹配到 /api 时，Nginx 会建立与后端的 SCGI 连接。标准参数文件通常定义了 SCGI_HOST、SCGI_PORT、SCGI_QUERY_STRING 等变量，这些是 SCGI 协议要求的必要环境值。
如何自定义 SCGI 请求的环境变量
可以通过 scgi_param 指令覆盖或添加额外的环境变量。例如，若后端应用需要特定的认证头或路径前缀，可直接在 location 中定义。这允许在不修改后端代码的情况下，动态调整传递给 SCGI 进程的环境上下文。
server {
listen 80;
server_name example.com;
location /custom {
scgi_pass 127.0.0.1:9000;
include scgi_params;
# 覆盖默认主机名
scgi_param SCGI_HOST backend.local;
# 添加自定义认证头
scgi_param X_AUTH_TOKEN $http_authorization;
# 设置固定的内容类型
scgi_param CONTENT_TYPE application/json;
}
}
在此配置中，$http_authorization 提取了客户端发送的 Authorization 头并映射为 X_AUTH_TOKEN 传给后端。这种映射机制使得 Nginx 能够灵活地转换 HTTP 语义到 SCGI 环境变量。如果后端依赖特定的 PATH_INFO，也可以通过类似方式显式指定，确保路由逻辑正确执行。
SCGI 模块如何处理空 Body 的请求
当发送 GET 或 HEAD 请求且无 Body 时，Nginx 会自动将 CONTENT_LENGTH 设置为 0 或忽略该头部，具体取决于后端实现。SCGI 协议要求明确的内容长度，因此 Nginx 的标准参数映射会确保在无数据时发送正确的零值，避免后端因等待数据而超时。
