HTTP 代理服务器定制属性
可将以下定制属性添加到 HTTP 代理服务器的配置设置。
要指定特定 HTTP 代理服务器的定制属性,浏览到该定制属性页面,然后指定该定制属性的值。
- 在管理控制台中,依次展开 ”,打开服务器的配置选项卡。
(对于集群中的代理服务器,请依次展开 )。
- 展开HTTP 代理服务器设置,单击。
- 在 “附加属性 ”下,点击 ”。
- 在设置页面上,键入要配置的自定义属性
Name字段,然后在Value场地。 - 点击Apply或者OK。
- 点击Save在控制台任务栏上保存您的配置更改。
- 重新启动服务器。
- 在管理控制台中,依次展开 ”,打开服务器的配置选项卡。
(对于静态集群中的 ODR 服务器,展开 )。
- 展开 “按需路由器设置 ”,点击 “按需路由器设置 ”。
- 在 “附加属性 ”下,点击 ”。
- 在 “设置”页面上,在 “名称”字段中输入要配置的自定义属性,在 “值”字段中输入自定义属性的值。
- 单击应用或确定。
- 单击控制台任务栏上的保存以保存配置更改。
- 重新启动服务器。
这些属性不会显示在 HTTP 代理或ODR服务器的设置页面上,而是被设置为自定义属性。
常规 HTTP 代理设置
- cache.ignore.header.Authorization
- cache.ignore.header.Cookie
- cache.ignore.header.Proxy-Authorization
- cache.query.string
- http.auto.redirect.correction
- http.cache.nocache.headers
- http.clientInfoFromTrustedIntermediary
- http.connectRetryLimit
- http.connectionPoolUseForPOST
- http.disable.retry.on.503.uriprefix
- http.disableresponsebufferingurls
- http.ignore.compliance.via
- http.isDisable10ResponseCaching
- http.log.history
- http.log.history.backup.list
- http.maxCachedPayload
- http.odcUpdateTimeout
- http.pmiTimerInterval
- http.routing.sendReverseProxyNameInHost
- http.virtual.port.map
- HTTPProxyAdvisorMethodName
- HTTPProxyAdvisorStartupDelay
- HTTPProxyAdvisorURI
- HTTPProxyAdvisorUserAgent
- http.useHostHeaderPort
- LBIPAddr
- localOutboundTCPAddress
- normalize.redirect.URL
出站连接属性
cache.ignore.header.Authorization
如果将自定义属性设置为,则指定代理将忽略请求中的授权标头true。 如果响应也能够高速缓存,那么代理将高速缓存该响应。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔值 |
| 缺省值 | 否 |
cache.ignore.header.Cookie
指定如果将定制属性设置为 true,那么代理将忽略请求中的 cookie 头。 如果响应也能够高速缓存,那么代理将高速缓存该响应。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔值 |
| 缺省值 | 否 |
cache.ignore.header.Proxy-Authorization
如果您将自定义属性设置为 true ,则指定代理将在请求中忽略“代理授权”标头。 如果响应也能够高速缓存,那么代理将高速缓存该响应。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔值 |
| 缺省值 | 否 |
cache.query.string
指定缺省代理高速缓存键生成器是否使用 URL 路径和查询字符串信息来生成高速缓存键。 要启用此功能,请将自定义属性设置为true。 但是,如果您在代理服务器上启用 Edge Side Include (ESI) 高速缓存,那么不使用此定制属性。 如果您未设置此定制属性,那么代理服务器只根据 URL 路径生成高速缓存键,而不根据查询字符串信息生成高速缓存键。
更多有关 ESI 高速缓存的信息,请参阅“配置 Edge Side Include 高速缓存”。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串 |
http.auto.redirect.correction
指定从通用服务器集群返回 302 响应时,代理服务器是否应该尝试更正 location 头中的值。
如果您指定none对于此属性,当返回 302 响应时,代理服务器永远不会尝试更正位置标头中的值。
如果将此属性指定为 gsc,那么仅在从通用服务器集群返回 302 响应时,代理服务器才会尝试更正 location 头中的值。
如果您指定managed对于此属性,仅当从托管服务器返回 302 响应时,代理服务器才会尝试更正位置标头中的值。
如果您指定all对于此属性,每当返回 302 响应时,代理服务器都会尝试更正位置标头中的值。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串 |
| 可接受的值 | none,gsc ,managed , 或者all |
| 缺省值 | 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 地址。 如果此属性已设置为 true,那么代理服务器将从发送自可信插件的专用 HTTP 头中抽取客户机信息,而不是从通道中抽取该信息。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串 |
| 缺省值 | 否 |
http.connectionPoolUseForPOST
指定代理服务器是否使用 POST 请求的连接池。 缺省情况下,POST 既不是合并也不是持久请求。 因此,如果通过代理服务器发送过多的 POST 请求,可能会出现端口疲劳,导致绑定异常。 如果此属性设置为 true,那么连接池会用于 POST 请求。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔型 |
| 缺省值 | 否 |
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.ignore.compliance.via
指定如何忽略自定义属性http.compliance.via 。
默认值为true,并且代理服务器忽略自定义属性http.compliance.via 。 如果你设置http.ignore.compliance.via到false,代理服务器尊重自定义属性的值http.compliance.via 。
http.isDisable10ResponseCaching
指定代理是否应该不分块,是否应该缓冲对 HTTP 1.0 客户机的响应。
如果 http.isDisable10ResponseCaching 属性设置为 true,那么代理服务器不会生成 content length 头,并且不会将分块数据包括在客户端响应中。 代理服务器而是在结束标记响应主体时关闭连接。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔型 |
| 缺省值 | 否 |
http.log.history
可以使您增大代理服务器日志文件的历史记录文件个数。
代理服务器日志文件为 proxy.log、local.log 和 cache.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。
| 信息 | 值 |
|---|---|
| 数据类型 | 整数 |
| 缺省值 | 10485760字节 |
http.odcUpdateTimeout
指定路由信息前服务器启动期间 HTTP 代理服务器的等待时间(以秒计)。 代理服务器等待指定的秒数,然后再绑定其端口。
可使用此定制属性来配置绑定 HTTP/HTTPS 端口前的启动延迟,在这段时间内允许传播路由信息。 如果将此值设置为 300,那么代理服务器将等待 300 秒以便有足够时间将路由信息传播至代理服务器。 如果在 300 秒内将路由信息传播至代理服务器,那么服务器启动将恢复。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串 |
| 缺省值 | 150 |
http.pmiTimerInterval
指定估计时间间隔,以毫秒计,在此时间间隔后在代理服务器中记录 PMI 统计信息。
| 信息 | 值 |
|---|---|
| 数据类型 | 整数 |
| 缺省值 | 1 |
http.routing.sendReverseProxyNameInHost
指定是否重写不在主机头上的内容WebSphere Application Server内容服务器。
此属性的选项为 true 或 false,并且不区分大小写。 如果此属性的值为false,则将主机头重写为目标服务器的主机。 如果此属性的值为true,则不会重写主机头。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔值 |
| 缺省值 | 否 |
http.virtual.port.map
指定后端服务器将响应发送回正确的外部 Web 站点端口时所使用的服务器端口映射信息。
当在位于代理服务器前面的负载均衡器上配置端口映射信息时,代理服务器可能无法将正确的外部 Web 站点端口信息转发到后端服务器,这是因为外部 Web 站点端口号可能不同于 Web 服务器插件或代理服务器正在侦听的端口。 您可以使用此定制属性纠正端口信息,然后代理服务器将其传递到后端服务器。
Name: http.virtual.port.map Value: 20080:80;20443:443
| 信息 | 值 |
|---|---|
| 数据类型 | 端口映射对的字符串值,用分号分隔 |
| 缺省值 | 无 |
HTTPProxyAdvisorMethodName
指定 HTTP 方法名称,一般方法使用 HEAD、GET。 HTTP 方法名称也是在前端负载均衡器上设置的顾问程序方法。 定制属性使代理能够匹配入局请求并确定请求是否来自负载均衡器。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串值(HTTP 方法名称,例如 GET 或 READ) |
| 缺省值 | 无 |
HTTPProxyAdvisorStartupDelay
指定 HTTP 顾问程序启动延迟(以秒计)。 缺省值为 0 秒。
如果当前代理开始时间小于在 HTTPProxyAdvisorStartupDelay 定制属性中定义的值,那么直接从代理服务器返回 HTTP 503 错误,以通知负载均衡器代理或后端服务器还未做好准备以 HTTP 请求提供服务。
如果当前代理开始时间大于在 HTTPProxyAdvisorStartupDelay 定制属性中定义的值,那么代理将顾问程序请求转发至后端并将响应返回至前端负载均衡器。 根据从后端服务器返回的状态代码,前端负载均衡器确定代理或后端服务器是否做好准备以为请求提供服务。
如果代理关闭,那么代理服务器为顾问程序请求返回 503 错误代码。 此错误代码通知负载均衡器代理和后端服务器无法为进一步请求提供服务,前端负载均衡器需要停止向此代理服务器发送请求。
| 信息 | 值 |
|---|---|
| 数据类型 | 整数(以秒计的时间) |
| 缺省值 | 0 |
HTTPProxyAdvisorURI
指定标准的 URI 字符串。 这也是在前端负载均衡器中设置的顾问程序 URI。 必须配置后端服务器上的应用程序以回答此请求 URI。 定制属性使代理能够匹配入局请求并确定请求是否来自负载均衡器。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串值(标准 URI) |
| 缺省值 | 无 |
HTTPProxyAdvisorUserAgent
指定前端负载均衡器用户代理名称。 此定制属性使代理能够匹配入局请求并确定请求是否来自负载均衡器。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串值(HTTP 用户代理头值) |
| 缺省值 | 无 |
http.useHostHeaderPort
当属性设置为true,代理服务器将 $WSSP 私有标头分配给主机标头中指定的端口。 当属性设置为 false 时,$WSSP私有标头将根据 HTTP 方案设置为默认端口。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔值 |
| 缺省值 | 是 |
HTTPSustainedHighVolumeLogging
此自定义属性可在 面板上设置。
LBIPAddr
指定用分号分隔的 IP 地址列表。 此定制属性允许代理匹配入局请求并确定请求是否来自负载均衡器。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串值(由分号分隔的 IP 地址) |
| 缺省值 | 无 |
localOutboundTCPAddress
指定专用于 HTTP 流量的主机接口。 此属性确定用于与 HTTP 容器建立出站 HTTP 连接的接口。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串 |
| 缺省值 | * |
normalize.redirect.URL
当设置为 true 时,代理服务器重定向路由规则中指定的URI将被标准化,删除末尾斜杠('/')。 如果值为 false,那么将不会更改 URI。 默认值设置为 true。
http.maxTargetReconnects
指定每个请求最多可重新连接到同一目标内容服务器的次数。
| 信息 | 值 |
|---|---|
| 数据类型 | 整数 |
| 缺省值 | 5 |
http.maxTargetRetries
指定ODR尝试为每个请求选择新的目标内容服务器的最大次数。
| 信息 | 值 |
|---|---|
| 数据类型 | 整数 |
| 缺省值 | 5 |
http.routing.sendReverseProxyNameInHost (用于出站连接属性)
确定是否将ODR名称放置在主机标头中,用于非特定于 WebSphere Application Server 内容服务器。 选项是 true 或 false,不区分大小写。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔值 |
| 缺省值 | 错 |
http.compliance.disable
确定是否在ODR内容服务器连接上强制执行 HTTP V1.1 合规性。 选项为“是”或“否”,不区分大小写。
| 信息 | 值 |
|---|---|
| 数据类型 | 布尔值 |
| 缺省值 | 错 |
http.compliance.via
为了符合 HTTP 标准,请求和响应中附加的via标头的价值。 如果值为空,则不附加via标头。 如果此值为 true,那么追加缺省 via 值。 否则,追加指定的字符串 via 值。 缺省值为 NULL。
| 信息 | 值 |
|---|---|
| 数据类型 | 字符串 |
| 缺省值 | 空值 |