Apache MPM通用指令

CoreDumpDirectory 指令

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

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

EnableExceptionHook 指令

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

已经有两个模块，mod_whatkilledus并且 mod_backtrace使用了这个钩子。请访问Jeff Trawick的EnableExceptionHook网站，以获取有关这些信息的更多信息。

GracefulShutdownTimeout 指令

该GracefulShutdownTimeout规定如何收到“优雅停止”信号后多少秒，服务器应继续运行，处理现有的连接。

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

听 指令

该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指令应用协议特定的优化 。

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

Listen 192.170.2.1:8443 https

也可以看看

• DNS问题
• 设置Apache HTTP Server使用哪些地址和端口
• Address already in use错误消息的进一步讨论，包括其他原因。

ListenBackLog 指令

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

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

ListenCoresBucketsRatio 指令

甲比率（在线）CPU内核的数量和听众桶的数目之间可以用来使Apache HTTP服务器创建 num_cpu_cores / ratio听桶，每一个包含它自己Listen相同的端口（一个或多个）上-ing插座（多个），然后让每个孩子处理一个单独的存储桶（在创建孩子时按循环分配存储桶）。

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

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

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

MaxConnectionsPerChild 指令

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

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

MaxMemFree 指令

该MaxMemFree指令规定，每一个分配器被允许保留，而无需调用的自由字节的最大数量free()。在线程MPM中，每个线程都有自己的分配器。设置为零时，阈值将设置为无限制。

MaxRequestWorkers 指令

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

对于非线程服务器（即，prefork）， MaxRequestWorkers转换成将要推出的服务请求的子进程的最大数量。默认值为256; 要增加它，您还必须加注 ServerLimit。

对于线程服务器和混合服务器（例如 event 或worker），MaxRequestWorkers限制可用于服务客户端的线程总数。对于混合的MPM，默认值是16（ServerLimit）乘以的值 25（ThreadsPerChild）。因此，要增加到MaxRequestWorkers需要超过16个过程的值，还必须提高ServerLimit。

MaxRequestWorkersMaxClients在2.3.13版之前被调用 。仍然支持旧名称。

MaxSpareThreads 指令

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

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

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

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

也可以看看

• MinSpareThreads
• StartServers
• MaxSpareServers

MinSpareThreads 指令

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

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

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

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

也可以看看

• MaxSpareThreads
• StartServers
• MinSpareServers

PidFile 指令

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

PidFile /var/run/apache.pid

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

该PidFile受有关日志文件的位置和相同的警告信息的安全。

ReceiveBufferSize 指令

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

如果设置为0，则服务器将使用操作系统默认值。

ScoreBoardFile 指令

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

ScoreBoardFile /var/run/apache_runtime_status

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

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

也可以看看

• 停止并重新启动Apache HTTP Server

SendBufferSize 指令

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

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

可能需要对操作系统进行进一步的配置才能在高速，高延迟的连接上获得更好的性能。

ServerLimit 指令

对于preforkMPM，此伪指令设置MaxRequestWorkersApache httpd进程生存期内的最大配置值。对于worker和event MPM，此伪指令与一起ThreadLimit设置MaxRequestWorkersApache httpd进程生存期内的最大配置值。对于eventMPM，此伪指令还定义了可以继续运行并完成对打开的连接的处理的旧服务器进程数。在重新启动期间更改此指令的任何尝试将被忽略，但 MaxRequestWorkers可以在重新启动期间进行修改。

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

对于preforkMPM，仅当您需要设置MaxRequestWorkers大于256（默认值）时才使用此伪指令。请勿将此指令的值设置为高于您可能要设置的值MaxRequestWorkers。

使用worker，仅当您的MaxRequestWorkers 和ThreadsPerChild 设置需要超过16个服务器进程时才使用此伪指令 （默认）。不要设置该指令的任何比你可能想什么所需的服务器进程的数目更高的价值MaxRequestWorkers 和ThreadsPerChild。

随着event，增加该指令如果由你定义的流程数量MaxRequestWorkers和ThreadsPerChild设置，以及正常关闭进程的数量，超过16个服务器进程（默认）。

也可以看看

• 停止并重新启动Apache HTTP Server

StartServers 指令

该StartServers指令设置启动时创建的子服务器进程的数量。如根据负载动态地控制的过程的数量，（见 MinSpareThreads， MaxSpareThreads， MinSpareServers，MaxSpareServers）通常有什么理由调整此参数。

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

StartThreads 指令

启动时创建的线程数。如根据负载动态地控制线程的数量，（见 MinSpareThreads， MaxSpareThreads， MinSpareServers，MaxSpareServers）通常有什么理由调整此参数。

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

ThreadLimit 指令

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

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

其缺省值ThreadLimit是 1920当用于mpm_winnt和 64与他人使用时。

ThreadsPerChild 指令

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

其缺省值ThreadsPerChild是 64当用于mpm_winnt和 25与他人使用时。

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

ThreadStackSize 指令

该ThreadStackSize指令设置用于处理客户端连接并调用模块以帮助处理这些连接的线程堆栈（用于自动数据）的大小。在大多数情况下，操作系统默认的堆栈大小是合理的，但是在某些情况下可能需要对其进行调整：

• 在具有相对较小的默认线程堆栈大小的平台（例如，HP-UX）上，当使用一些第三方模块使用大量自动数据存储时，Apache httpd可能会崩溃。这些相同的模块可能在其他默认线程堆栈大小较大的平台上运行良好。通过设置ThreadStackSize为高于操作系统默认值的值，可以解决这种类型的崩溃。仅当第三方模块的提供者指定需要此调整，或者诊断为Apache httpd崩溃表明线程堆栈大小过小时，才需要进行这种调整。
• 在默认线程堆栈大小明显大于Web服务器配置所需平台的平台上，如果将其ThreadStackSize设置为小于操作系统默认值的值，则每个子进程可以实现更多数量的线程。此类调整仅应在允许执行完整的Web服务器处理的测试环境中进行，因为不经常出现的请求需要更多的堆栈来处理。所需的最小堆栈大小在很大程度上取决于所使用的模块，但是Web服务器配置中的任何更改都可能使当前ThreadStackSize设置无效。
• 在Linux上，此指令只能用于增加默认堆栈大小，因为基础系统调用使用该值作为 最小堆栈大小。（通常很大）软限制ulimit -s（如果没有限制，则为 8MB）用作默认堆栈大小。