

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# apache2 属性
<a name="attributes-recipes-apache"></a>

**重要**  
该 AWS OpsWorks Stacks 服务于 2024 年 5 月 26 日终止，新客户和现有客户均已禁用。我们强烈建议客户尽快将其工作负载迁移到其他解决方案。如果您对迁移有疑问，请通过 re [AWS : Post 或通过 Pre](https://repost.aws/) mium Su [AWS pp](https://aws.amazon.com/support) ort 与 AWS 支持 团队联系。

**注意**  
这些属性仅在 Linux 堆栈上可用。

[apache2 属性](https://github.com/aws/opsworks-cookbooks/blob/release-chef-11.10/apache2/attributes/apache.rb)指定 [Apache HTTP 服务器](http://httpd.apache.org/)配置。有关更多信息，请参阅 [Apache 核心功能](http://httpd.apache.org/docs/current/mod/core.html)。有关如何覆盖内置属性以指定自定义值的更多信息，请参阅 [覆盖属性](workingcookbook-attributes.md)。


****  

|  |  |  | 
| --- |--- |--- |
| [binary ](#attributes-recipes-apache-bin) | [contact ](#attributes-recipes-apache-contact) | [deflate\$1types](#attributes-recipes-apache-deflate) | 
| [dir ](#attributes-recipes-apache-dir) | [document\$1root ](#attributes-recipes-apache-doc-root) | [组 ](#attributes-recipes-apache-group) | 
| [hide\$1info\$1headers ](#attributes-recipes-apache-hide) | [icondir ](#attributes-recipes-apache-icondir) | [init\$1script ](#attributes-recipes-apache-init-script) | 
| [keepalive ](#attributes-recipes-apache-keep) | [keepaliverequests ](#attributes-recipes-apache-keep-requests) | [keepalivetimeout ](#attributes-recipes-apache-keep-timeout) | 
| [lib\$1dir ](#attributes-recipes-apache-lib-dir) | [libexecdir ](#attributes-recipes-apache-libexecdir) | [listen\$1ports ](#attributes-recipes-apache-ports) | 
| [log\$1dir ](#attributes-recipes-apache-log-dir) | [logrotate 属性](#attributes-recipes-apache-log) | [pid\$1file ](#attributes-recipes-apache-pidfile) | 
| [prefork 属性](#attributes-recipes-apache-prefork) | [serversignature ](#attributes-recipes-apache-sig) | [servertokens ](#attributes-recipes-apache-tokens) | 
| [timeout ](#attributes-recipes-apache-timeout) | [traceenable ](#attributes-recipes-apache-trace) | [用户 ](#attributes-recipes-apache-user) | 
| [版本](#attributes-recipes-apache-version) | [worker 属性](#attributes-recipes-apache-worker) |  | 

**binary **  <a name="attributes-recipes-apache-bin"></a>
Apache 二进制文件的位置 (字符串)。默认值为 `'/usr/sbin/httpd'`。  

```
node[:apache][:binary]
```

**contact **  <a name="attributes-recipes-apache-contact"></a>
电子邮件联系人 (字符串)。默认值为虚拟地址 `'ops@example.com'`。  

```
node[:apache][:contact]
```

**deflate\$1types**  <a name="attributes-recipes-apache-deflate"></a>
指示 `mod_deflate` 对指定 Mime 类型启用压缩，前提是这些类型受浏览器支持 (字符串列表)。默认值如下所示：  

```
['application/javascript',
 'application/json',
 'application/x-javascript',
 'application/xhtml+xml',
 'application/xml',
 'application/xml+rss',
 'text/css',
 'text/html',
 'text/javascript',
 'text/plain',
 'text/xml']
```
压缩可能会带来安全风险。要完全禁用压缩，请按如下方式设置此属性：  

```
node[:apache][:deflate_types] = []
```

```
node[:apache][:deflate_types]
```

**dir **  <a name="attributes-recipes-apache-dir"></a>
服务器的根目录 (字符串)。默认值如下所示：  
+ Amazon Linux 和 Red Hat Enterprise Linux (RHEL)：`'/etc/httpd'`
+ Ubuntu: `'/etc/apache2'`

```
node[:apache][:dir]
```

**document\$1root **  <a name="attributes-recipes-apache-doc-root"></a>
文档根目录 (字符串)。默认值如下所示：  
+ Amazon Linux 和 RHEL: `'/var/www/html'`
+ Ubuntu: `'/var/www'`

```
node[:apache][:document_root]
```

**组 **  <a name="attributes-recipes-apache-group"></a>
组名称 (字符串)。默认值如下所示：  
+ Amazon Linux 和 RHEL: `'apache'`
+ Ubuntu: `'www-data'`

```
node[:apache][:group]
```

**hide\$1info\$1headers **  <a name="attributes-recipes-apache-hide"></a>
是否忽略 HTTP 标头中的版本和模块信息 (`'true'`/`'false'`) (字符串)。默认值为 `'true'`。  

```
node[:apache][:hide_info_headers]
```

**icondir **  <a name="attributes-recipes-apache-icondir"></a>
图标目录 (字符串)。默认值如下所示：  
+ Amazon Linux 和 RHEL: `'/var/www/icons/'`
+ Ubuntu: `'/usr/share/apache2/icons'`

```
node[:apache][:icondir]
```

**init\$1script **  <a name="attributes-recipes-apache-init-script"></a>
初始化脚本 (字符串)。默认值如下所示：  
+ Amazon Linux 和 RHEL: `'/etc/init.d/httpd'`
+ Ubuntu: `'/etc/init.d/apache2'`

```
node[:apache][:init_script]
```

**keepalive **  <a name="attributes-recipes-apache-keep"></a>
是否启用保持活动连接 (字符串)。可能的值为 `'On'` 和 `'Off'` (字符串)。默认值为 `'Off'`。  

```
node[:apache][:keepalive]
```

**keepaliverequests **  <a name="attributes-recipes-apache-keep-requests"></a>
Apache 将同时处理的最大保持活动请求数 (数字)。默认值为 `100`。  

```
node[:apache][:keepaliverequests]
```

**keepalivetimeout **  <a name="attributes-recipes-apache-keep-timeout"></a>
Apache 在关闭连接前等待请求的时间 (数字)。默认值为 `3`。  

```
node[:apache][:keepalivetimeout]
```

**lib\$1dir **  <a name="attributes-recipes-apache-lib-dir"></a>
包含对象代码库的目录 (字符串)。默认值如下所示：  
+ Amazon Linux (x86)：`'/usr/lib/httpd'`
+ Amazon Linux (x64) 和 RHEL：`'/usr/lib64/httpd'`
+ Ubuntu: `'/usr/lib/apache2'`

```
node[:apache][:lib_dir]
```

**libexecdir **  <a name="attributes-recipes-apache-libexecdir"></a>
包含程序可执行文件的目录 (字符串)。默认值如下所示：  
+ Amazon Linux (x86)：`'/usr/lib/httpd/modules'`
+ Amazon Linux (x64) 和 RHEL：`'/usr/lib64/httpd/modules'`
+ Ubuntu: `'/usr/lib/apache2/modules'`

```
node[:apache][:libexecdir]
```

**listen\$1ports **  <a name="attributes-recipes-apache-ports"></a>
服务器侦听的端口的列表 (字符串列表)。默认值为 `[ '80','443' ]`。  

```
node[:apache][:listen_ports]
```

**log\$1dir **  <a name="attributes-recipes-apache-log-dir"></a>
日志目录 (字符串)。默认值如下所示：  
+ Amazon Linux 和 RHEL: `'/var/log/httpd'`
+ Ubuntu: `'/var/log/apache2'`

```
node[:apache][:log_dir]
```

**logrotate 属性**  <a name="attributes-recipes-apache-log"></a>
这些属性指定如何轮换日志文件。    
**delaycompress **  <a name="attributes-recipes-apache-log-delay"></a>
是否延迟压缩关闭的日志文件，直到下一个轮换周期开始 (`'true'`/`'false'`) (字符串)。默认值为 `'true'`。  

```
node[:apache][:logrotate][:delaycompress]
```  
**组 **  <a name="attributes-recipes-apache-log-group"></a>
日志文件所在的组 (字符串)。默认值为 `'adm'`。  

```
node[:apache][:logrotate][:group]
```  
**mode **  <a name="attributes-recipes-apache-log-mode"></a>
日志文件的模式 (字符串)。默认值为 `'640'`。  

```
node[:apache][:logrotate][:mode]
```  
**owner **  <a name="attributes-recipes-apache-log-owner"></a>
日志文件的所有者 (字符串)。默认值为 `'root'`。  

```
node[:apache][:logrotate][:owner]
```  
**rotate **  <a name="attributes-recipes-apache-log-rotate"></a>
删除关闭的日志文件之前的轮换周期数 (字符串)。默认值为 `'30'`。  

```
node[:apache][:logrotate][:rotate]
```  
**计划 **  <a name="attributes-recipes-apache-log-schedule"></a>
轮换计划 (字符串)。可能值如下所示：  
+ `'daily'`
+ `'weekly'`
+ `'monthly'`
默认值为 `'daily'`。  

```
node[:apache][:logrotate][:schedule]
```

**pid\$1file **  <a name="attributes-recipes-apache-pidfile"></a>
包含守护程序进程 ID 的文件 (字符串)。默认值如下所示：  
+ Amazon Linux 和 RHEL: `'/var/run/httpd/httpd.pid'`
+ Ubuntu: `'/var/run/apache2.pid'`

```
node[:apache][:pid_file]
```

**prefork 属性**  <a name="attributes-recipes-apache-prefork"></a>
这些属性指定预派生配置。    
**maxclients **  <a name="attributes-recipes-apache-prefork-maxclients"></a>
将提供的最大并行请求数 (数字)。默认值为 `400`。  
此属性仅适用于运行 Amazon Linux 或 RHEL 的实例。如果您的实例运行的是 Ubuntu 14.04 LTS，请使用 [maxrequestworkers](#attributes-recipes-apache-prefork-maxrequestworkers)。

```
node[:apache][:prefork][:maxclients]
```  
**maxrequestsperchild **  <a name="attributes-recipes-apache-prefork-maxrequests"></a>
子服务器进程处理的最大请求数 (数字)。默认值为 `10000`。  

```
node[:apache][:prefork][:maxrequestsperchild]
```  
**maxrequestworkers**  <a name="attributes-recipes-apache-prefork-maxrequestworkers"></a>
将提供的最大并行请求数 (数字)。默认值为 `400`。  
此属性仅适用于运行 Ubuntu 14.04 LTS 的实例。如果您的实例运行的是 Amazon Linux 或 RHEL，请使用 [maxclients ](#attributes-recipes-apache-prefork-maxclients)。

```
node[:apache][:prefork][:maxrequestworkers]
```  
**maxspareservers **  <a name="attributes-recipes-apache-prefork-maxspare"></a>
最大空闲子服务器进程数 (数字)。默认值为 `32`。  

```
node[:apache][:prefork][:maxspareservers]
```  
**minspareservers **  <a name="attributes-recipes-apache-prefork-minspare"></a>
最小空闲子服务器进程数 (数字)。默认值为 `16`。  

```
node[:apache][:prefork][:minspareservers]
```  
**serverlimit **  <a name="attributes-recipes-apache-prefork-limit"></a>
可配置的最大进程数 (数字)。默认值为 `400`。  

```
node[:apache][:prefork][:serverlimit]
```  
**startservers **  <a name="attributes-recipes-apache-prefork-start"></a>
在启动时创建的子服务器进程数 (数字)。默认值为 `16`。  

```
node[:apache][:prefork][:startservers]
```

**serversignature **  <a name="attributes-recipes-apache-sig"></a>
指定是否为服务器生成的文档配置尾部页脚以及如何配置 (字符串)。可能的值为 `'On'`、`'Off'` 和 `'Email'`。默认值为 `'Off'`。  

```
node[:apache][:serversignature]
```

**servertokens **  <a name="attributes-recipes-apache-tokens"></a>
指定响应标头应包含哪种类型的服务器版本信息 (字符串)：  
+ `'Full'`：完整信息。例如，服务器：Apache/2.4.2 (Unix) PHP/4.2.2 /1.2 MyMod 
+ `'Prod'`：产品名称。例如，Server: Apache
+ `'Major'`：主要版本。例如，Server: Apache/2
+ `'Minor'`：主要版本和次要版本。例如，Server: Apache/2.4
+ `'Min'`：最低版本。例如，Server: Apache/2.4.2
+ `'OS'`：带操作系统的版本。例如，Server: Apache/2.4.2 (Unix) 
默认值为 `'Prod'`。  

```
node[:apache][:servertokens]
```

**timeout **  <a name="attributes-recipes-apache-timeout"></a>
Apache 等待的时间 I/O （数字）。默认值为 `120`。  

```
node[:apache][:timeout]
```

**traceenable **  <a name="attributes-recipes-apache-trace"></a>
是否启用 `TRACE` 请求 (字符串)。可能的值为 `'On'` 和 `'Off'`。默认值为 `'Off'`。  

```
node[:apache][:traceenable]
```

**用户 **  <a name="attributes-recipes-apache-user"></a>
用户名称 (字符串)。默认值如下所示：  
+ Amazon Linux 和 RHEL: `'apache'`
+ Ubuntu: `'www-data'`

```
node[:apache][:user]
```

**版本**  <a name="attributes-recipes-apache-version"></a>
Apache 版本 (字符串)。默认值如下所示：  
+ Amazon Linux: `2.2`
+ Ubuntu 14.04 LTS: `2.4`
+ RHEL: `2.4`

```
node[:apache][:version]
```

**worker 属性**  <a name="attributes-recipes-apache-worker"></a>
这些属性指定工作进程配置。    
**startservers **  <a name="attributes-recipes-apache-worker-start"></a>
在启动时创建的子服务器进程数 (数字)。默认值为 `4`。  

```
node[:apache][:worker][:startservers]
```  
**maxclients **  <a name="attributes-recipes-apache-worker-maxclients"></a>
将提供的最大并行请求数 (数字)。默认值为 `1024`。  

```
node[:apache][:worker][:maxclients]
```  
**maxsparethreads **  <a name="attributes-recipes-apache-worker-maxspare"></a>
最大空闲线程数 (数字)。默认值为 `192`。  

```
node[:apache][:worker][:maxsparethreads]
```  
**minsparethreads **  <a name="attributes-recipes-apache-worker-minspare"></a>
最小空闲线程数 (数字)。默认值为 `64`。  

```
node[:apache][:worker][:minsparethreads]
```  
**threadsperchild **  <a name="attributes-recipes-apache-worker-threads"></a>
每个子进程的线程数 (数字)。默认值为 `64`。  

```
node[:apache][:worker][:threadsperchild]
```  
**maxrequestsperchild **  <a name="attributes-recipes-apache-worker-maxreq"></a>
子服务器进程处理的最大请求数 (数字)。默认值为 `10000`。  

```
node[:apache][:worker][:maxrequestsperchild]
```