HTTP 代理服务器定制属性

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

避免麻烦 :虽然可以在服务器级别设置 HTTP 代理服务器的自定义属性,但只有在代理服务器属于代理集群的一部分,或者按需路由器(ODR)服务器属于ODR静态集群的一部分时,才能在集群级别进行设置。 要设置ODR动态集群的 HTTP 代理服务器自定义属性,请参阅按需路由器动态集群代理设置

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

  1. 在管理控制台中,依次展开 “服务器 ”> “服务器类型 ”> “ WebSphere 代理服务器 ”> “proxy_server_name ”,打开服务器的配置选项卡。

    (对于集群中的代理服务器,请依次展开 “服务器 ”> “集群 ”> “代理服务器集群 ”> “代理服务器集群名称” )。

  2. 展开HTTP 代理服务器设置,单击代理设置
  3. “附加属性 ”下,点击 “自定义属性 ”> “新建 ”。
  4. 在设置页面上,键入要配置的自定义属性Name字段,然后在Value场地。
  5. 点击Apply或者OK
  6. 点击Save在控制台任务栏上保存您的配置更改。
  7. 重新启动服务器。
对于按需路由(ODR)服务器:
  1. 在管理控制台中,依次展开 “服务器 ”> “服务器类型 ”> “按需路由器 ”> “ODR_server_name ”,打开服务器的配置选项卡。

    (对于静态集群中的 ODR 服务器,展开服务器 > 集群 > 按需路由器集群 > ODR_cluster_name )。

  2. 展开 “按需路由器设置 ”,点击 “按需路由器设置 ”。
  3. “附加属性 ”下,点击 “自定义属性 ”> “新建 ”。
  4. “设置”页面上,在 “名称”字段中输入要配置的自定义属性,在 “值”字段中输入自定义属性的值。
  5. 单击应用确定
  6. 单击控制台任务栏上的保存以保存配置更改。
  7. 重新启动服务器。

这些属性不会显示在 HTTP 代理或ODR服务器的设置页面上,而是被设置为自定义属性。

常规 HTTP 代理设置

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 响应时,代理服务器都会尝试更正位置标头中的值。

避免麻烦:连接重写规则将覆盖为此定制属性指定的值。
信息
数据类型 字符串
可接受的值 nonegscmanaged , 或者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.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。

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

http.odcUpdateTimeout

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

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

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

http.pmiTimerInterval

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

避免麻烦 :指定一个小于默认值100毫秒的值可能会影响代理服务器的性能,因为代理服务器需要更频繁地检查当前时间。
信息
数据类型 整数
缺省值 1

http.routing.sendReverseProxyNameInHost

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

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

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

http.virtual.port.map

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

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

例如,如果代理服务器或 Web 服务器插件正在监听端口 20080 和 20443,但外部网站端口为 80 和 443,则为代理服务器设置以下自定义属性可使代理服务器向后端服务器提供正确的端口信息。 然后,后端服务器可以将响应发送到正确的外部 Web 站点端口。
Name:    http.virtual.port.map   
Value:   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 用户代理头值)
缺省值

http.useHostHeaderPort

当属性设置为true,代理服务器将 $WSSP 私有标头分配给主机标头中指定的端口。 当属性设置为 false 时,$WSSP私有标头将根据 HTTP 方案设置为默认端口。

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

HTTPSustainedHighVolumeLogging

此自定义属性可在 WebSphere 代理服务器 > 代理服务器名称 > HTTP 代理服务器设置 > 代理设置 > 自定义属性面板上设置。

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 内容服务器。 选项是 truefalse,不区分大小写。

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

http.compliance.disable

确定是否在ODR内容服务器连接上强制执行 HTTP V1.1 合规性。 选项为“是”或“否”,不区分大小写。

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