worker.properties配置

该指令可以多次使用。

此外，任何负载均衡器每工作一个工人都会进行一次全局维护。在全局维护期间，负载计数器会衰减，并且会检查错误的工作人员的recover_time。

此功能已在jk 1.2.13中添加。

类型ajp13是JK在Web服务器和Tomcat之间进行通信的首选工作程序类型。这种类型的工作者使用套接字作为通信通道。有关ajp13协议栈的详细说明，请浏览至 AJPv13协议规范。类型lb用于负载平衡工作人员，状态则用于状态工作人员。

类型ajp14是实验性的，不建议使用，类型ajp12 已过时。

此功能是实验性的，已在jk 1.2.41中添加。

请注意，socket_timeout以秒为单位， socket_connect_timeout以毫秒为单位，因此从绝对角度来看，默认socket_connect_timeout值等于"socket_timeout。

此功能已在jk 1.2.27中添加。

防火墙剪切无效连接的问题是，有时，Web服务器或Tomcat都没有有关剪切的信息，并且无法处理。

该标志的值可以是以下标志的任意组合（多个值的组合没有任何分隔符）：

C（连接）：如果设置，则连接到后端后将探测一次连接。可以通过设置超时connect_timeout。如果未设置，ping_timeout将使用的值。

P（prepost）：如果设置，则在将每个请求发送到后端之前将先探测连接。可以通过设置超时prepost_timeout。如果未设置，ping_timeout将使用的值。

I（间隔）：如果设置，则将在常规内部维护周期内探测连接，但前提是空闲时间长于 connection_ping_interval。可以通过设置超时ping_timeout。

A如果设置，将使用所有上述探针。

此功能已在jk 1.2.27中添加。Connect和岗前探测技术已经获得通过connect_timeout ，并prepost_timeout自版本JK 1.2.6。

出于兼容性原因，无论何时connect_timeout或prepost_timeout设置为CPing / CPong（即使ping_mode为空）也将使用 。

此功能已在jk 1.2.27中添加。

可以通过ping_mode或通过将connection_ping_interval值设置为大于零的值来激活间隔探测。如果激活间隔通过探测ping_mode，则默认值connection_ping_interval是 (ping_timeout/1000) * 10。请注意，ping_timeout 以毫秒为单位，connection_ping_interval以秒为单位，因此按绝对值计，默认connection_ping_interval值为10 times ping_timeout。

此功能已在jk 1.2.27中添加。

连接池大小属性仅用于多线程Web服务器，例如Apache HTTP Server，Microsoft IIS和iPlanet Web Server。connection_pool_size属性需要反映一个Web服务器进程应能够并行发送到后端的请求数。通常，这与每个Web服务器进程的线程数相同。JK将自动为Apache HTTP Server发现此数字，并将池大小设置为该值。对于IIS，默认值为250（在1.2.20版本之前：10），对于iPlanet，默认值为1。

强烈建议将IIS和iPlanet的此值调整为一个Web服务器进程应能够并行发送到后端的请求数。您应该测量高峰活动期间需要多少个连接而不会出现性能问题，然后根据您的增长率添加一些百分比。最后，您应该检查您的Web服务器进程是否能够使用至少与配置为池大小一样多的线程。

其默认值为（connection_pool_size + 1）/ 2。

此功能已在jk 1.2.16中添加。

如果每个孩子都必须将请求转发给Tomcat，则可以打开ajp13连接，从而在Tomcat端创建一个新的ajp13线程。

问题在于，创建ajp13连接后，子进程直到被杀死都不会丢弃它。并且由于Web服务器将使其子进程/线程保持运行状态以处理高负载，即使子进程/线程仅处理静态内容，您也可以在Tomcat端完成许多未使用的ajp13线程。

您应该将此时间间隔与Tomcat的server.xml中的AJP连接器的keepAliveTimeout属性（如果已明确设置）或connectionTimeout属性保持同步。但是请注意，mod_jk的值以秒为单位，server.xml中的值必须使用毫秒。

其默认值为retries * retry_interval。

此功能已在jk 1.2.27中添加。

整数lbfactor（负载平衡因子）是 我们期望该工作人员工作的数量或 工作人员的工作配额。将负载均衡因子与其他组成负载均衡器的工作人员进行比较。例如，如果一个工作人员的lb_factor比其他工作人员高5倍，那么它将收到的请求多五倍。

相同的负载平衡器可以多次使用此指令。

该指令代替了以前的balanced_workers指令，并且只能与1.2.7及更高版本的mod_jk一起使用。

该sticky_session设置可以使用Apache HTTP服务器的环境变量被覆盖JK_STICKY_IGNORE和工人地图扩展 sticky_ignore。这已在1.2.33版本中添加。

此功能已在jk 1.2.9中添加。

一些方法指出，它们聚合在滑动时间窗口中。它们相加访问，然后在每次运行全局维护方法时，将负载计数器除以2。通常每分钟发生一次，具体取决于worker.maintain的设置。可以使用状态工作器检查负载计数器的值。

如果将method设置为R [equest]，则平衡器将使用请求数来找到最佳工作程序。访问量将根据lbfactor在滑动时间窗口中进行分配。这是默认值，对于大多数应用程序应该可以正常工作。

如果将方法设置为S [ession]，则平衡器将使用会话数来找到最佳工作程序。访问量将根据lbfactor在滑动时间窗口中进行分配。如果会话是您的限制资源，则应使用此方法，例如，当您的内存有限且会话需要大量内存时。因为平衡器不保留任何状态，所以它实际上不知道会话数。相反，它将没有会话cookie或URL编码的每个请求计为新会话。当会话无效时，此方法既不会知道，也不会根据会话超时或工作程序故障转移来纠正其加载数。如果您知道请求网址，那么该网址将在没有会话ID的情况下被调用，但不应视为新会话，因此应将其添加到无状态映射规则扩展或为它们设置Apache HTTP Server环境变量JK_STATELESS。

如果将method设置为N [ext]，则平衡器将再次使用会话数来查找最佳工作程序。有关Session方法的所有说明也适用。与Session方法的区别在于在滑动时间窗口中如何处理会话计数。在接下来方法不除以2，而不是将其减去当前最小数目。这应该有效地导致循环会话平衡，因此命名为Next。在高负载下，这两种会话平衡方法将导致相似的分配，但是如果您需要分配少量的会话，则下一步会更好。

如果设置为T [raffic]，则平衡器将使用JK和Tomcat之间的网络流量来找到最佳工作程序。访问量将根据lbfactor在滑动时间窗口中进行分配。如果到后端的网络是您的限制资源，则应使用此方法。

如果设置为B [usyness]，则平衡器将根据工作人员当前服务的请求数量，选择当前负载最低的工作人员。该数字除以worker lbfactor，然后选择最低值（最忙）的worker。如果您的请求需要很长时间才能处理，例如下载应用程序，则此方法特别有趣。不建议将该方法用于一般用途，因为在某些硬件体系结构上的高负载下，繁忙计数器可能会出错。

此功能已在1.2.9版中添加。会话方法已在版本增加了1.2.20，在下一版本的方法1.2.33。

此功能已在jk 1.2.13中添加。

如果请求未得到处理，则负载平衡器工作人员将在最大重试时间（包括原始尝试）中重复上述过程。在每次重试之前，负载均衡器工作者将暂停retry_interval指令定义的时间。

请注意，这意味着，如果所有工作程序都失败，则在将504响应返回给客户端之前，将总共有worker.retries * min（lb.lb_retries，member worker count）* lb.retries请求。因此，对于具有四个成员和默认配置的lb工人，如果所有工人都失败了，则在将504响应返回给客户端之前，将总共有8个请求。

在1.2.16版之前，默认值为3。

如果请求未得到处理，则负载平衡器工作人员将在最大重试时间（包括原始尝试）中重复上述过程。在每次重试之前，负载均衡器工作者将暂停retry_interval指令定义的时间。

请注意，这意味着，如果所有工作程序都失败，则在将504响应返回给客户端之前，将总共有worker.retries * min（lb.lb_retries，member worker count）* lb.retries请求。因此，对于具有四个成员和默认配置的lb工人，如果所有工人都失败了，则在将504响应返回给客户端之前，将总共有8个请求。

此功能已在jk 1.2.44中添加。在添加此功能之前，负载均衡器工作程序的行为就像lb_retries等于成员工作程序的数量一样。

此功能已在jk 1.2.20中添加。

该指令可以多次使用。

此功能已在jk 1.2.20中添加。

此功能已在jk 1.2.21中添加。

根据成员的激活状态（活动，禁用，已停止）及其运行时状态（正常，不适用，忙碌，恢复，探测，强制恢复，错误）确定这些状态。默认情况下，如果成员的激活为“活动”且其运行时状态不是“错误”，则假定成员为“良好”。

您可以通过为属性“ good”分配值列表来更改此映射。每个值都为成员提供一个可能的匹配，并且一个匹配就足够了。每个值可以是一个字符，也可以是两个字符和点“。”的组合。单个字符是单词“活动”，“已禁用”，“已停止”，“确定”，“ na”，“忙”，“正在恢复”，“错误”中的第一个字符。附加状态“探测”和“强制恢复”始终被评定为等同于“恢复”。如果一个值仅包含一个字符，则所有具有此激活或运行时状态的成员都将被假定为良好。激活和运行时状态的组合，并以点“”连接。仅适用于会员，

负载平衡器的成员将首先与状态“差”匹配，如果不匹配，则将尝试状态“好”，如果仍然不匹配，则它们的状态将被“降级”。

该指令可以多次使用。

此功能已在jk 1.2.20中添加。

默认情况下，如果成员的激活被“停止”或其运行时状态为“错误”，则假定成员为“不良”。

该指令可以多次使用。

此功能已在jk 1.2.20中添加。

此功能已在jk 1.2.20中添加。

此功能已在jk 1.2.20中添加。

默认值设置为xmlns：jk =“ http://tomcat.apache.org”

此功能已在jk 1.2.20中添加。

此功能已在jk 1.2.20中添加。

jk 1.2.6中 已添加了此功能，以避免挂起的Tomcat出现问题，并且需要ajp13 ping / pong支持，该支持已在Tomcat 3.3.2 +，4.1.28 +和5.0.13+上实现。默认禁用。

jk 1.2.6中 已添加了此功能，以避免挂起的Tomcat出现问题，并且需要ajp13 ping / pong支持，该支持已在Tomcat 3.3.2 +，4.1.28 +和5.0.13+上实现。默认禁用。

如果超时过去而没有从Tomcat接收到任何数据，则Web服务器将不再等待其余的响应并将错误发送给客户端（浏览器）。通常这并不意味着该请求也会在Tomcat后端中止。如果工作线程是负载均衡器的成员，则负载均衡器可能会将工作线程置于错误状态，然后在另一个成员上重试该请求。另请参见max_reply_timeouts，重试和recovery_options。

默认情况下（值为零），Web服务器将永远等待，这可能对您来说是个问题。如果设置了reply_timeout，则如果您的servlet长时间运行，请仔细调整它。

该reply_timeout可以使用Apache HTTP服务器的环境变量被覆盖 JK_REPLY_TIMEOUT和工人地图扩展reply_timeout。

jk 1.2.6中 已添加了此功能，以避免挂起的Tomcat出现问题，并且可在所有支持ajp13的servlet引擎上使用。在版本1.2.27中添加了变量JK_REPLY_TIMEOUT和辅助映射。

另请参阅属性recovery_options以获取对重试的更细粒度控制，并为睡眠时间配置提供retry_interval。

在1.2.16版之前，默认值为3。

此功能已在jk 1.2.27中添加。

此属性是位掩码。允许以下位：
1：如果在收到请求后Tomcat失败，
则不恢复2：如果将标头发送到客户端后，如果Tomcat失败，则不恢复
4：如果回写时检测到错误，则关闭与Tomcat的连接客户端（浏览器）的答案
8：始终恢复对HTTP方法HEAD的请求（即使设置了位1或2）
16：始终恢复对HTTP方法GET的请求（即使设置了位1或2）

此功能已在jk 1.2.6中添加。在版本1.2.16中添加了选项4 ，在版本1.2.24中添加了选项8和16 。

错误页面，原始响应的标题和状态代码将不会发送回客户端。而是该请求将导致503响应。如果工作人员是负载均衡器的成员，则该成员将进入错误状态。请求故障转移和工作程序恢复将通过常规负载平衡器过程进行处理。

此功能已在jk 1.2.20中添加。

从jk 1.2.22开始，可以定义由空格或逗号分隔的多个状态代码。例如：worker.xxx.fail_on_status=500,503

从jk 1.2.25开始，如果返回的响应中带有fail_on_status中的状态码之一，则还可以告诉负载平衡器不要将成员置于错误状态。通过在这些状态代码的前面加上减号来启用此功能。例如：worker.xxx.fail_on_status=-404,-500,503

请注意，这与“ 繁忙”负载平衡 方法无关。

此功能是实验性的，已在jk 1.2.41中添加。

通常，没有必要更改最大数据包大小。发送证书或证书链时，已报告默认值问题。

此功能已在jk 1.2.19中添加。

此功能已在jk 1.2.38中添加。

在Tomcat AJP连接器配置中 使用属性secret =“秘密关键字”。（历史记录：该属性名称在2020年2月之前发布的Tomcat 9.0、8.x，7.0版本中为requiredSecret， 在Tomcat 6.0及更低版本中为request.secret。）

如果在负载均衡器上设置机密，则其所有成员都将继承此机密。

此功能已在jk 1.2.12中添加。

同一工作人员可以多次使用此指令。

长时间运行的请求仍会在reply_timeout毫秒等待数据后超时，但是如果超过max_reply_timeouts个请求超时，则相应的成员工作器将仅处于错误状态。更准确地说，只要负载均衡器进行内部维护（默认每60秒进行一次），这些错误请求的计数器就会被除以2。

在jk 1.2.24中已添加此功能，以使reply_timeout对偶发的长期运行请求不敏感。

每次处理请求时都不会检查此间隔。而是在全局维护期间对其进行检查。两次全局维护之间的时间间隔由worker.maintain控制。

除非您了解其中的含义，否则请勿将recover_time设置为很短的时间。错误工作者的每次恢复尝试都是由真实请求完成的！

某些类型的错误检测无法提供精确的信息，无论节点是否完全损坏。在那些情况下，LB不会立即将节点置于错误状态。仅在发生此类错误后的error_escalation_time秒内没有成功的响应时，该节点才会进入错误状态。

此功能已在jk 1.2.28中添加。

此功能已在jk 1.2.27中添加。

此功能已在jk 1.2.27中添加。

一些Web框架取代了Tomcat会话管理，并使用了另一种生成会话ID的方式。结果，Tomcat添加到会话ID末尾的路由ID丢失了，我们不再能够进行粘性负载平衡。解决方法是，可以使用以下步骤：

• 使用“ session_cookie”属性选择一个非标准的cookie名称。
• 通过将属性“ set_session_cookie”设置为true来激活cookie发送。
• 将属性“ session_cookie_path”设置为正确的应用程序URI，例如“ / myapp /”。

仅当请求中尚未包含相同名称的cookie或该cookie不包含负载均衡器可以满足的路由ID时，才会发送该cookie。尤其是在节点故障转移之后，我们将发送新的cookie，以将粘性切换到新节点。

此功能已在jk 1.2.38中添加。

此功能已在jk 1.2.38中添加。

使用d或D禁用，使用s或S停止。如果不存在此伪指令，则使用不推荐使用的伪指令“ disabled”或“ stopped”。

可以在运行时使用状态工作程序更改此标志。

此功能已在jk 1.2.19中添加。

为每个磅和每个Tomcat实例定义一个单独的工作程序，并使用任意工作程序名称，并将工作程序的路由属性设置为等于目标Tomcat实例的jvmRoute。

如果将此属性留空，则将使用工作程序的名称。

可以在运行时使用状态工作程序更改此属性。

如果路由名称包含一个句点，则除非明确设置了domain，否则第一个句点之前的部分将用作域名。

此功能已在jk 1.2.16中添加。
自动域规则已在jk 1.2.20中添加。
该属性已从jvm_route重命名为jk 1.2.20中的route。

只有在给定距离以下的所有工人均发生错误，被禁用或停止的情况下，更大距离的工人才有资格进行平衡。

此功能已在jk 1.2.16中添加。

该指令用于具有6个以上Tomcat的大型系统，以便能够将Tomcat分为两个组，从而降低它们之间的会话复制传输。

此功能已在jk 1.2.8中添加。

如果通过“ route”属性显式设置路由，则必须将“重定向”设置为首选故障转移工作程序的此路由，而不是其名称。

此功能已在jk 1.2.9中添加。

Cachesize属性仅用于多线程Web服务器，例如Apache HTTP Server 2.x（除prefork之外的所有MPM），IIS和iPlanet。cachesize属性应反映每个子进程的线程数。JK将在具有线程MPM的Apache HTTP Server上发现每个子进程的线程数，并将其默认值设置为与当前ThreadsPerChild Apache配置相匹配。对于IIS，默认值为10。对于非Apache或IIS的Web服务器，必须手动设置此值。

如果每个孩子都必须将请求转发到Tomcat，则可以打开ajp13连接，从而在Tomcat端创建一个新的ajp13线程。

问题在于，创建ajp13连接后，子进程直到被杀死都不会丢弃它。并且由于Web服务器将使其子进程/线程保持运行状态以处理高负载，即使子进程/线程仅处理静态内容，您也可以在Tomcat端完成许多未使用的ajp13线程。

此功能已在jk 1.2.9中添加。

此功能已在jk 1.2.11中添加。

为每个磅和每个Tomcat实例定义一个单独的工作程序，并使用任意工作程序名称，并将工作程序的jvm_route属性设置为等于目标Tomcat实例的jvmRoute。

如果将此属性留空，则将使用工作程序的名称。

可以在运行时使用状态工作程序更改此属性。

此功能已在jk 1.2.16中添加。