HTTP 代理服务器定制属性

可将以下定制属性添加到 HTTP 代理服务器的配置设置。

要指定特定 HTTP 代理服务器的定制属性,浏览到该定制属性页面,然后指定该定制属性的值。

  1. 在管理控制台中,展开服务器 > 服务器类型 > WebSphere 代理服务器 > proxy_server_name 以打开服务器的“配置”选项卡。
  2. 展开HTTP 代理服务器设置,单击代理设置
  3. 其他属性下,单击定制属性 > 新建
  4. 在设置页面上,在名称字段中输入要配置的定制属性,并在字段中输入定制属性的值。
  5. 单击应用确定
  6. 单击控制台任务栏上的保存以保存配置更改。
  7. 重新启动服务器。

cache.ignore.header.Authorization

指定如果将定制属性设置为 true,那么代理将忽略请求中的 Authorization 头。如果响应也能够高速缓存,那么代理将高速缓存该响应。

信息
数据类型 布尔值
缺省值 false

cache.ignore.header.Cookie

指定如果将定制属性设置为 true,那么代理将忽略请求中的 cookie 头。如果响应也能够高速缓存,那么代理将高速缓存该响应。

信息
数据类型 布尔值
缺省值 false

cache.ignore.header.Proxy-Authorization

指定如果将定制属性设置为 true,那么代理将忽略请求中的 Proxy-Authorization 头。如果响应也能够高速缓存,那么代理将高速缓存该响应。

信息
数据类型 布尔值
缺省值 false

cache.query.string

指定缺省代理高速缓存键生成器是否使用 URL 路径和查询字符串信息来生成高速缓存键。要启用此功能,请设置定制属性为 true。 但是,如果您在代理服务器上启用 Edge Side Include (ESI) 高速缓存,那么不使用此定制属性。如果您未设置此定制属性,那么代理服务器只根据 URL 路径生成高速缓存键,而不根据查询字符串信息生成高速缓存键。

更多有关 ESI 高速缓存的信息,请参阅“配置 Edge Side Include 高速缓存”。

信息
数据类型 字符串

http.auto.redirect.correction

指定从通用服务器集群返回 302 响应时,代理服务器是否应该尝试更正 location 头中的值。

如果将此属性指定为,那么在返回 302 响应时,代理服务器不会尝试更正 location 头中的值。

如果将此属性指定为 gsc,那么仅在从通用服务器集群返回 302 响应时,代理服务器才会尝试更正 location 头中的值。

如果将此属性指定为受管,那么仅在从受管服务器返回 302 响应时,代理服务器才会尝试更正 location 头中的值。

如果将此属性指定为所有,那么无论何时返回 302 响应,代理服务器都会尝试更正 location 头中的值。

避免故障 避免故障: 结点重写规则会覆盖对此定制属性指定的值。gotcha
信息
数据类型 字符串
可接受的值 gsc受管所有
缺省值 gsc

http.cache.nocache.headers

指定代理服务器接收响应时您不想缓存的 set-cookie 头。缺省情况下,代理服务器将 set-cookie 头存储在代理高速缓存中。如果未正确设置 Cache-Control 头信息,那么代理服务器可能会存储一些与会话相关的用户专用 cookie。可以使用此定制属性指定您不想存储在代理高速缓存中的 set-cookie 头。

信息
数据类型 HTTP 头名称的字符串(以逗号分隔)

例如,您可能提供下列值:Set-Cookie,Set-Cookie2。因此,代理服务器不会将 Set-Cookie 头和 Set-Cookie2 HTTP 头存储在代理高速缓存中。

http.clientInfoFromTrustedIntermediary

指定代理是否应该从请求中的 WebSphere Application Server 专用头中抽取 IP 地址。将插件部署在代理前面时,代理服务器将从通道中抽取客户机 IP 地址,而不是从转发自插件的专用头中抽取该 IP 地址。如果此属性已设置为 true,那么代理服务器将从发送自可信插件的专用 HTTP 头中抽取客户机信息,而不是从通道中抽取该信息。

信息
数据类型 字符串
缺省值 false

http.connectionPoolUseForPOST

指定代理服务器是否使用 POST 请求的连接池。缺省情况下,POST 既不是合并也不是持久请求。因此,如果通过代理服务器发送过多的 POST 请求,可能会出现端口疲劳,导致绑定异常。如果此属性设置为 true,那么连接池会用于 POST 请求。

信息
数据类型 布尔值
缺省值 false

http.connectRetryLimit

指定 WebSphere Proxy Server 尝试与后端服务器建立连接多少次之后,才会被标记为当机。

如果不将此定制属性添加到 WebSphere Proxy Server 设置,只要 WebSphere Proxy Server 未能连接到后端服务器,此服务器就被标记为当机,并且在经过 retryAfterValue 定制属性指定的连接次数之后,请求不会再路由到此服务器,即使再尝试连接可能会成功。例如,可能会因为太快复用临时端口导致第一次尝试连接失败,而先前连接仍处于 TIME_WAIT 状态。

信息
数据类型 整型
缺省值 0

http.disable.retry.on.503.uriprefix

指定当代理服务器向后端服务器发送初始请求却接收到 503 响应时,您不想代理服务器为其自动重试其他服务器的 URI 前缀。

通常,当代理服务器从后端服务器接收到 503 响应时,它将后端服务器标记为正在当机,并尝试将请求发送到其他服务器。对于特定的 URI 前缀,如果您不想代理服务器将后端服务器标记为当机并想让其自动重试其他服务器,那么可以将这些前缀指定为此定制属性的值。对于为此属性指定的任何 URI 前缀,如果代理服务器对后端服务器的请求接收到 503 响应,那么代理服务器会直接将 503 响应返回到该客户机而不会重试请求。代理服务器也不会将后端服务器标记为正在当机。

信息
数据类型 组成 URI 前缀的字符串(由逗号分隔)
缺省值 无缺省值

http.disableresponsebufferingurls

指定在什么情况下,代理服务器才可缓冲脉动信号应用程序的响应。

属性的值是以逗号分隔的 URL 模式,例如 /application_a/.*html;/application_b/.*html。 例如,如果代理服务器接收 /application_a/heartbeat.html 请求,该请求与定制属性中的一个 URI 模式匹配,那么代理服务器不缓冲请求的响应主体。在本例中,如果代理服务器返回一个字节,那么它将这个字节转发给客户机端,但不进行缓冲。

不使用此定制属性,只有当达到部分响应主体限制时,代理服务器才接收响应以及缓冲响应主体。

要点: 缓冲过程可能会改进代理服务器性能,但是它还可能造成某些脉动信号应用程序的客户机端连接超时。

http.isDisable10ResponseCaching

指定代理是否应该不分块,是否应该缓冲对 HTTP 1.0 客户机的响应。

如果 http.isDisable10ResponseCaching 属性设置为 true,那么代理服务器不会生成 content length 头,并且不会将分块数据包括在客户端响应中。代理服务器而是在结束标记响应主体时关闭连接。

信息
数据类型 布尔值
缺省值 false

http.log.history

可以使您增大代理服务器日志文件的历史记录文件个数。

代理服务器日志文件为 proxy.loglocal.logcache.log 文件。没有此定制属性,您仅有一个这些代理服务器日志文件的历史记录文件。

信息
数据类型 布尔值
缺省值 1

http.log.history.backup.list

使您能够在代理服务器日志目录中查找历史记录文件,并在找到这些文件后将它们追加到创建的任何新日志文件中。

如果将 http.log.history.backup.list 定制属性设置为 1,那么代理服务器将在代理服务器日志目录中搜索 cache.log、local.log 和 proxy.log 文件的历史版本。如果找到历史版本,那么会将其追加到创建的任何新日志文件中。

要使此定制属性生效,必须对 HTTP 代理服务器启用日志记录。

信息
数据类型 布尔值
缺省值 0

http.maxCachedPayload

指定代理服务器将为其生成 content-length 头的分块响应的最大大小。

当代理服务器接收到对 HTTP 1.0 客户机的分块响应时,代理服务器假设 HTTP 1.0 客户机无法处理分块消息,尝试取消对消息的分块,并计算响应主体的内容时间。如果分块响应的大小等于或小于为此属性指定的大小限制,那么代理服务器会生成该响应的 content-length 头。如果分块响应的大小超过了为此属性指定的大小限制,那么代理会返回错误消息 500。

信息
数据类型 整型
缺省值 100000 字节

http.odcUpdateTimeout

指定路由信息前服务器启动期间 HTTP 代理服务器的等待时间(以秒计)。代理服务器等待指定的秒数,然后再绑定其端口。

可使用此定制属性来配置绑定 HTTP/HTTPS 端口前的启动延迟,在这段时间内允许传播路由信息。如果将此值设置为 300,那么代理服务器将等待 300 秒以便有足够时间将路由信息传播至代理服务器。如果在 300 秒内将路由信息传播至代理服务器,那么服务器启动将恢复。

信息
数据类型 字符串
缺省值 150

http.pmiTimerInterval

指定估计时间间隔,以毫秒计,在此时间间隔后在代理服务器中记录 PMI 统计信息。

避免故障 避免故障: 指定低于缺省 100 毫秒的值,可能影响代理服务器性能,这是因为代理需要更加频繁地检查当前时间。gotcha
信息
数据类型 整型
缺省值 100

http.routing.sendReverseProxyNameInHost

指定是否为不在 WebSphere Application Server 内容服务器上的内容重写 host 头。

此属性的选项为 truefalse,并且不区分大小写。如果此属性的值是 false,那么重新编写主机头作为目标服务器的主机。如果此属性的值为 true,那么不会重写主机头。

信息
数据类型 布尔值
缺省值 false

http.virtual.port.map

指定后端服务器将响应发送回正确的外部 Web 站点端口时所使用的服务器端口映射信息。

当在位于代理服务器前面的负载均衡器上配置端口映射信息时,代理服务器可能无法将正确的外部 Web 站点端口信息转发到后端服务器,这是因为外部 Web 站点端口号可能不同于 Web 服务器插件或代理服务器正在侦听的端口。您可以使用此定制属性纠正端口信息,然后代理服务器将其传递到后端服务器。

例如,如果代理服务器或 Web 服务器插件正在侦听端口 20080 和 20443,但是外部 Web 站点端口是 80 和 443,那么设置代理服务器的下列定制属性,以向后端服务器提供正确的端口信息。然后,后端服务器可以将响应发送到正确的外部 Web 站点端口。
名称:    http.virtual.port.map
值:   20080:80;20443:443
信息
数据类型 端口映射对的字符串值,用分号分隔
缺省值

HTTPProxyAdvisorMethodName

指定 HTTP 方法名称,一般方法使用 HEAD、GET。HTTP 方法名称也是在前端负载均衡器上设置的顾问程序方法。定制属性使代理能够匹配入局请求并确定请求是否来自负载均衡器。

信息
数据类型 字符串值(HTTP 方法名称,例如 GET 或 READ)
缺省值

HTTPProxyAdvisorStartupDelay

指定 HTTP 顾问程序启动延迟(以秒计)。缺省值为 0 秒。

当代理收到请求时,它尝试针对定制属性(LBIPAddr、HTTPProxyAdvisorURI、HTTPProxyAdvisorURI 和 HTTPProxyAdvisorStartupDelay)匹配请求(如果已定义这些属性)。
注: 您无需定义所有这些定制属性。
如果所有定制属性匹配,那么将请求看做来自前端负载均衡器的顾问程序请求。

如果当前代理开始时间小于在 HTTPProxyAdvisorStartupDelay 定制属性中定义的值,那么直接从代理服务器返回 HTTP 503 错误,以通知负载均衡器代理或后端服务器还未做好准备以 HTTP 请求提供服务。

如果当前代理开始时间大于在 HTTPProxyAdvisorStartupDelay 定制属性中定义的值,那么代理将顾问程序请求转发至后端并将响应返回至前端负载均衡器。根据从后端服务器返回的状态代码,前端负载均衡器确定代理或后端服务器是否做好准备以为请求提供服务。

如果代理关闭,那么代理服务器为顾问程序请求返回 503 错误代码。此错误代码通知负载均衡器代理和后端服务器无法为进一步请求提供服务,前端负载均衡器需要停止向此代理服务器发送请求。

信息
数据类型 整数(以秒计的时间)
缺省值 0

HTTPProxyAdvisorURI

指定标准的 URI 字符串。这也是在前端负载均衡器中设置的顾问程序 URI。必须配置后端服务器上的应用程序以回答此请求 URI。 定制属性使代理能够匹配入局请求并确定请求是否来自负载均衡器。

信息
数据类型 字符串值(标准 URI)
缺省值

HTTPProxyAdvisorUserAgent

指定前端负载均衡器用户代理名称。 此定制属性使代理能够匹配入局请求并确定请求是否来自负载均衡器。

信息
数据类型 字符串值(HTTP 用户代理头值)
缺省值

HTTPSustainedHighVolumeLogging

可以在 WebSphere 代理服务器 > Proxy Server name > HTTP 代理服务器设置 > 代理设置 > 定制属性面板上设置此定制属性。

LBIPAddr

指定用分号分隔的 IP 地址列表。此定制属性允许代理匹配入局请求并确定请求是否来自负载均衡器。

信息
数据类型 字符串值(由分号分隔的 IP 地址)
缺省值

localOutboundTCPAddress

指定专用于 HTTP 流量的主机接口。此属性确定用于与 HTTP 容器建立出站 HTTP 连接的接口。

信息
数据类型 字符串
缺省值 *

normalize.redirect.URL

如果设置为 true,那么将使代理服务器重定向路由规则中指定的 URI 规范化,并且将移除尾部斜杠(“/”)。如果值为 false,那么将不会更改 URI。缺省值设置为 true。


指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjpx_siphttpcustprops
文件名:rjpx_siphttpcustprops.html