Apache 模块 mod_proxy_scgi

Summary

该模块需要 mod_proxy的服务。它为SCGI 协议，版本 1提供支持。

因此，为了获得处理 SCGI 协议的能力，服务器中必须存在mod_proxy和mod_proxy_scgi。

Examples

请记住，为了使以下示例起作用，您必须启用mod_proxy和mod_proxy_scgi。

Simple gateway

ProxyPass "/scgi-bin/" "scgi://localhost:4000/"

除了上面列出的代理模块之外，平衡网关还需要mod_proxy_balancer和至少一个负载平衡器算法模块，例如mod_lbmethod_byrequests。 mod_lbmethod_byrequests是默认值，将用于此示例配置。

Balanced gateway

ProxyPass "/scgi-bin/" "balancer://somecluster/"
<Proxy "balancer://somecluster">
    BalancerMember "scgi://localhost:4000"
    BalancerMember "scgi://localhost:4001"
</Proxy>

Environment Variables

除了控制mod_proxy行为的配置指令外，环境变量还可以控制 SCGI 协议提供程序：

• proxy-scgi-pathinfo

  • 默认情况下，mod_proxy_scgi既不创建也不导出 PATH_INFO 环境变量。这允许后端 SCGI 服务器正确确定 SCRIPT_NAME 和 Script-URI 并符合 RFC 3875 第 3.3 节。如果相反，您需要mod_proxy_scgi为 PATH_INFO 生成“最佳猜测”，请设置此 env-var。必须在SetEnv有效之前设置该变量。可以使用SetEnvIf代替：SetEnvIf Request_URI . proxy-scgi-pathinfo

ProxySCGIInternalRedirect Directive

ProxySCGIInternalRedirect使后端可以在内部将网关重定向到其他 URL。此功能起源于mod_cgi，如果响应状态为OK(200)并且响应包含Location(或配置的备用 Headers)并且其值以斜杠(/)开头，则该函数在内部重定向响应。该值被解释为 Apache httpd 内部重定向到的新本地 URL。

mod_proxy_scgi在这方面与mod_cgi相同，除了可以关闭该功能或指定使用Location以外的 Headers。

Example

ProxySCGIInternalRedirect Off

# Django and some other frameworks will fully qualify "local URLs"
# set by the application, so an alternate header must be used.
<Location /django-app/>
    ProxySCGIInternalRedirect X-Location
</Location>

ProxySCGISendfile Directive

ProxySCGISendfile指令使 SCGI 后端可以让文件直接由网关提供服务。这对于提高性能很有用-httpd 可以使用sendfile或其他优化，如果文件来自后端套接字，则不可能。此外，文件内容不会发送两次。

ProxySCGISendfile参数确定网关行为：

• Off

  • 不会进行任何特殊处理。

• On

  • 网关查找名为X-Sendfile的后端响应 Headers，并将该值解释为要提供的文件名。该头将从最终响应头中删除。这等效于ProxySCGISendfile X-Sendfile。

• anything else

  • 与On相似，但不是使用硬编码的 Headers 名称X-Sendfile，而是将参数用作 Headers 名称。

Example

# Use the default header (X-Sendfile)
ProxySCGISendfile On

# Use a different header
ProxySCGISendfile X-Send-Static