Apache MPM 通用指令

CoreDumpDirectory Directive

这将控制 Apache httpd 在转储核心之前尝试切换到的目录。如果您的 os 配置为在崩溃过程的工作目录中创建核心文件，则必须使用CoreDumpDirectory才能从默认的ServerRoot目录更改工作目录，服务器运行时所用的用户不能写入该默认目录。

如果要使用核心转储进行调试，则可以使用此伪指令将其放置在其他位置。如果您的 os 未配置为将核心文件写入崩溃进程的工作目录，则此伪指令无效。

EnableExceptionHook Directive

出于安全原因，仅当服务器配置了--enable-exception-hook选项时，此伪指令才可用。它启用了一个钩子，该钩子允许外部模块在孩子撞车后插入并执行某些操作。

已经有两个模块mod_whatkilledus和mod_backtrace使用此钩子。请查看 Jeff Trawick 的EnableExceptionHook site，以获取有关这些信息的更多信息。

GracefulShutdownTimeout Directive

GracefulShutdownTimeout指定在收到“正常停止”signal 后多少秒，服务器应 continue 运行，以处理现有连接。

将此值设置为零意味着服务器将无限期 await，直到所有剩余的请求都已完全满足为止。

Listen Directive

Listen指令指示 Apache httpd 仅侦听特定的 IP 地址或端口；默认情况下，它响应所有 IP 接口上的请求。现在Listen是必需的指令。如果它不在配置文件中，则服务器将无法启动。这是对 Apache httpd 以前版本的更改。

Listen指令告诉服务器在指定的端口或地址和端口组合上接受传入的请求。如果仅指定端口号，则服务器在所有接口上侦听给定的端口。如果提供了 IP 地址和端口，则服务器将侦听给定的端口和接口。

可以使用多个Listen指令来指定要监听的地址和端口的数量。服务器将响应来自任何列出的地址和端口的请求。

例如，要使服务器接受端口 80 和 8000 上的连接，请使用：

Listen 80
Listen 8000

要使服务器接受两个指定接口和端口号上的连接，请使用

Listen 192.170.2.1:80
Listen 192.170.2.5:8000

IPv6 地址必须用方括号括起来，如以下示例所示：

Listen [2001:db8::a00:20ff:fea7:ccea]:80

对于大多数配置，不需要可选的协议参数。如果未指定，则https是端口 443 的默认值，http是所有其他端口的默认值。该协议用于确定哪个模块应处理请求，并通过AcceptFilter指令应用特定于协议的优化。

仅在非标准端口上运行时，才需要设置协议。例如，在端口 8443 上运行一个https网站：

Listen 192.170.2.1:8443 https

See also

• DNS Issues

• 设置 Apache HTTP Server 使用的地址和端口

• 进一步讨论已经使用的地址错误消息，包括其他原因。

ListenBackLog Directive

挂起的连接队列的最大长度。通常不需要调整。但是，在某些系统上，当受到 TCP SYN 泛洪攻击时，希望增加此数量。请参阅listen(2)系统调用的 backlog 参数。

os 通常会将其限制为较小的数量。随 os 的不同而不同。另请注意，许多 os 并未完全使用指定为待办事项的列表，而是使用基于(但通常大于)设置值的数字。

ListenCoresBucketsRatio Directive

(在线)CPU 内核数与侦听器存储桶数量之间的比率可用于使 Apache HTTP Server 创建num_cpu_cores / ratio个侦听存储桶，每个存储桶在同一端口上包含自己的Listening 套接字，然后让每个孩子处理一个单独的存储桶(在创建孩子的时候对存储桶进行循环分配)。

当接受新连接成为瓶颈时，ListenCoresBucketsRatio可以提高可伸缩性。在具有大量 CPU 核心的系统上，启用此功能已经过测试，显示出显着的性能改进和更短的响应时间。

要使之处于活动状态，CPU 核的数量必须至少比配置的比率多两倍。推荐的比率为8，因此，使用此值时，运行时至少应有16个内核可用。需要为每个目标系统计算正确的比率以获得最大性能，测试多个值并观察关键性能 Metrics 的变化。

该指令影响MinSpareThreads和MaxSpareThreads下限值的计算。子进程的数量必须是存储桶数量的倍数，才能最佳地接受连接。

MaxConnectionsPerChild Directive

MaxConnectionsPerChild伪指令设置单个子服务器进程将处理的连接数限制。连接MaxConnectionsPerChild后，子进程将死亡。如果MaxConnectionsPerChild是0，则该过程将永不过期。

将MaxConnectionsPerChild设置为非零值将限制进程因(偶然)内存泄漏而消耗的内存量。

MaxMemFree Directive

MaxMemFree伪指令设置允许每个分配器在不调用free()的情况下保留的最大可用 KB 数。在线程 MPM 中，每个线程都有自己的分配器。设置为零时，阈值将设置为无限制。

MaxRequestWorkers Directive

MaxRequestWorkers指令设置了将同时服务的请求数的限制。通常，超过MaxRequestWorkers限制的任何连接尝试都将排队，最多可排队基于ListenBacklog指令的数目。一旦在另一个请求结束时释放了子进程，则将为连接提供服务。

对于非线程服务器(，即，prefork)，MaxRequestWorkers转换为将启动以处理请求的子进程的最大数量。默认值为256;要增加它，您还必须加ServerLimit。

对于线程服务器和混合服务器(例如* event或worker)，MaxRequestWorkers限制了可用于为 Client 端提供服务的线程总数。对于混合 MPM，默认值为16(ServerLimit)乘以25(ThreadsPerChild)的值。因此，要将MaxRequestWorkers增加到需要超过 16 个进程的值，还必须提高ServerLimit。

在版本 2.3.13 之前，MaxRequestWorkers被称为MaxClients。仍然支持旧名称。

MaxSpareThreads Directive

最大空闲线程数。不同的 MPM 处理此指令的方式有所不同。

对于worker和event，默认值为MaxSpareThreads 250。这些 MPM 在服务器范围内处理空闲线程。如果服务器中的空闲线程过多，则子进程将被杀死，直到空闲线程的数量小于该数量为止。如果启用ListenCoresBucketsRatio，则可能会创建其他进程/线程。

对于mpm_netware，默认值为MaxSpareThreads 100。由于此 MPM 运行单个进程，因此备用线程数也在服务器范围内。

mpmt_os2与mpm_netware类似。对于mpmt_os2，默认值为10。

See also

• MinSpareThreads

• StartServers

• MaxSpareServers

MinSpareThreads Directive

处理请求峰值的最小空闲线程数。不同的 MPM 处理此指令的方式有所不同。

worker和event使用默认值MinSpareThreads 75并在服务器范围内处理空闲线程。如果服务器中没有足够的空闲线程，则将创建子进程，直到空闲线程的数量大于 number。如果启用ListenCoresBucketsRatio，则可能会创建其他进程/线程。

mpm_netware使用默认值MinSpareThreads 10，并且由于它是单进程 MPM，因此将在服务器范围内对其进行跟踪。

mpmt_os2与mpm_netware类似。对于mpmt_os2，默认值为5。

See also

• MaxSpareThreads

• StartServers

• MinSpareServers

PidFile Directive

PidFile伪指令设置服务器记录守护程序的进程 ID 的文件。如果文件名不是绝对文件名，则假定它是相对于ServerRoot的。

Example

PidFile /var/run/apache.pid

能够向服务器发送 signal，使其关闭然后重新打开其ErrorLog和TransferLog，并重新读取其配置文件通常很有用。这是通过向PidFile中列出的进程 ID 发送 SIGHUP(kill -1)signal 来完成的。

PidFile受到与日志文件放置和security相同的警告。

ReceiveBufferSize Directive

服务器将 TCP 接收缓冲区大小设置为指定的字节数。

如果设置为0，则服务器将使用 os 默认值。

ScoreBoardFile Directive

Apache HTTP Server 使用记分板在其父进程和子进程之间进行通信。一些体系结构需要文件来促进这种通信。如果未指定文件，则 Apache httpd 首先尝试完全在内存中创建记分板(使用匿名共享内存)，否则，将尝试在磁盘上创建文件(使用基于文件的共享内存)。指定此伪指令将导致 Apache httpd 始终在磁盘上创建文件。

Example

ScoreBoardFile /var/run/apache_runtime_status

基于文件的共享内存对于需要直接访问记分板的第三方应用程序很有用。

如果使用ScoreBoardFile，则将其放在 RAM 磁盘上可能会提高速度。但是请注意，您要注意有关日志文件放置和security的相同警告。

See also

• 停止并重新启动 Apache HTTP Server

SendBufferSize Directive

将服务器的 TCP 发送缓冲区大小设置为指定的字节数。在高速，高延迟的连接(，即，大约 100 毫秒，例如跨大陆快速管道)上，将此值设置为超过 os 的标准默认值通常很有用。

如果设置为0，则服务器将使用 os 提供的默认值。

可能需要对 os 进行进一步的配置，以在高速，高延迟的连接上获得更好的性能。

ServerLimit Directive

对于prefork MPM，此伪指令为 Apache httpd 进程的生存期设置MaxRequestWorkers的最大配置值。对于worker和event MPM，此指令与ThreadLimit结合使用可为 Apache httpd 进程的生存期设置MaxRequestWorkers的最大配置值。对于event MPM，此伪指令还定义了多少个旧服务器进程可以 continue 运行并完成对打开的连接的处理。重新启动期间更改此指令的任何尝试都将被忽略，但是MaxRequestWorkers可以在重新启动期间进行修改。

使用此指令时必须特别注意。如果将ServerLimit设置为比必要值高得多的值，则会分配额外的未使用共享内存。如果ServerLimit和MaxRequestWorkers都被设置为高于系统可以处理的值，则 Apache httpd 可能无法启动，或者系统可能变得不稳定。

对于prefork MPM，仅当您需要将MaxRequestWorkers设置为大于 256(默认值)时，才使用此伪指令。请勿将此指令的值设置得比您要设置MaxRequestWorkers的值高。

对于worker，仅当您的MaxRequestWorkers和ThreadsPerChild设置需要超过 16 个服务器进程时才使用此伪指令(默认)。请勿将此指令的值设置为高于MaxRequestWorkers和ThreadsPerChild可能需要的服务器进程数。

使用event时，如果您的MaxRequestWorkers和ThreadsPerChild设置定义的进程号加上正常关闭的进程数超过 16 个服务器进程(默认)，请增加此指令。

See also

• 停止并重新启动 Apache HTTP Server

StartServers Directive

StartServers指令设置启动时创建的子服务器进程的数量。由于进程数量是根据负载动态控制的(请参见MinSpareThreads，MaxSpareThreads，MinSpareServers，MaxSpareServers)，因此通常没有理由调整此参数。

缺省值因 MPM 而异。 worker和event默认为StartServers 3; prefork默认为5; mpmt_os2默认为2。

StartThreads Directive

启动时创建的线程数。由于线程数是根据负载动态控制的(请参见MinSpareThreads，MaxSpareThreads，MinSpareServers，MaxSpareServers)，因此通常没有理由调整此参数。

对于mpm_netware，默认值为StartThreads 50，并且由于只有一个进程，因此这是在启动时为服务请求而创建的线程总数。

ThreadLimit Directive

此伪指令在 Apache httpd 进程的生存期内设置ThreadsPerChild的最大配置值。重新启动期间更改此指令的任何尝试都将被忽略，但是可以在重新启动期间修改ThreadsPerChild，直到该指令的值。

使用此指令时必须特别注意。如果ThreadLimit的值比ThreadsPerChild大得多，则会分配额外的未使用共享内存。如果ThreadLimit和ThreadsPerChild都被设置为高于系统可以处理的值，则 Apache httpd 可能无法启动，或者系统可能变得不稳定。对于当前运行的 Apache httpd，请勿将此指令的值设置为高于最大预测设置ThreadsPerChild。

当与mpm_winnt一起使用时，ThreadLimit的默认值为1920，与其他参数一起使用时的默认值为64。

ThreadsPerChild Directive

该指令设置每个子进程创建的线程数。子级在启动时创建这些线程，而从不创建更多线程。如果使用的是mpm_winnt之类的 MPM，其中只有一个子进程，则此数字应足够大以处理服务器的整个负载。如果使用worker之类的 MPM，其中有多个子进程，则* total *线程数应足够高以处理服务器上的常见负载。

当与mpm_winnt一起使用时，ThreadsPerChild的默认值为64，与其他参数一起使用时的默认值为25。

ThreadsPerChild的值不能超过ThreadLimit的值。如果配置了更高的值，它将在启动时自动减小并记录警告。这两个伪指令之间的关系在ThreadLimit中进行了说明。

ThreadStackSize Directive

ThreadStackSize指令设置用于处理 Client 端连接并调用模块以帮助处理这些连接的线程堆栈(用于自动数据)的大小。在大多数情况下，os 的堆栈大小默认值是合理的，但是在某些情况下可能需要对其进行调整：

• 在具有相对较小的默认线程堆栈大小的平台(例如，HP-UX)上，当使用某些第三方模块使用大量自动数据存储时，Apache httpd 可能会崩溃。这些相同的模块在默认线程堆栈较大的其他平台上可能运行良好。通过将ThreadStackSize设置为高于 os 默认值的值，可以解决此类崩溃问题。仅当第三方模块的提供者指定需要进行调整，或者诊断为 Apache httpd 崩溃表明线程堆栈大小过小时，才需要进行这种调整。

• 在默认线程堆栈大小明显大于 Web 服务器配置所需的平台上，如果将ThreadStackSize设置为小于 os 默认值的值，则每个子进程可以实现更多数量的线程。此类调整仅应在允许执行完整的 Web 服务器处理的测试环境中进行，因为不经常出现的请求可能需要更多的堆栈来处理。所需的最小堆栈大小在很大程度上取决于所使用的模块，但是 Web 服务器配置中的任何更改都可能使当前的ThreadStackSize设置无效。

• 在 Linux 上，此指令只能用于增加默认堆栈大小，因为基础系统调用使用该值作为最小堆栈大小。 ulimit -s的(通常很大)软限制(如果没有限制，则为 8MB)用作默认堆栈大小。