APACHE 的http.conf文件中文说明

Apache2的配置文件httpd.conf的中文说明

#
#httpd.conf是Apache服务器主要配置文件。
#它包含服务器的影响服务器运行的配置指令。
#
#这些配置指令被分为下面三个部分：
#1. 控制整个Apache服务器行为的部分（即全局环境变量）
#2. 定义主要或者默认服务参数的指令，也为所有虚拟主机提供默认的设置参数
#3. 虚拟主机的设置参数
#
#配置和日志文件名：如果你指定的文件名以"/"开始（win32下以"c:/"），
#服务器将使用绝对路径，如果文件名不是以"/"开始的，那么它将把ServerRoot
#的值附加在文件名的前面，例如，对"logs/baidu.log"，如果ServerRoot的值
#为"/usr/local/apache2"，则该文件应为"/usr/local/apache2/logs/baidu.log"
#
# (1)全局环境参数
#
#这里设置的参数将影响整个Apache服务器的行为；
#例如Apache能够处理的并发请求的数量等。
#
#ServerRoot:指出服务器保存其配置、出错和日志文件等的根目录。
#
#路径的结尾不要添加斜线。
#
ServerRoot "/usr/loacl/apache2"

#
#串行访问的锁文件必须保存在本地磁盘上
#
#LockFile logs/accept.lock

#ScoreBoardFile:用来保存内部服务进程信息的文件。
#如果未指明（默认），记分板（scoreboard）将被保存在一个匿名的共享内存段中，
#并且它不能被第三方软件所使用。
#如果指定了，要确保不能使用两个Apache使用同一个记分板文件，
#这个记分板文件必须保存在本地磁盘上。
#
#ScoreBoardFile logs/apache_runtime_status

#
#PidFile:记录服务器启动进程号的文件。
#
PidFile logs/httpd.pid

#
#Timeout:接收和发送前超时秒数
#
Timeout 300

#
#KeepAlive:是否允许稳固的连接（每个连接有多个请求），
#设为"Off"则停用。
#
KeepAlive On

#
#MaxKeepAliveRequests:在稳固连接期间允许的最大请求数，
#设为0表示无限制接入。
#我们推荐你将其设为一个较大的值，以便提高性能
MaxKeepAliveRequests 100

#
#KeepAliveTimeout:在同一个连接上从同一台客户上接收请求的秒数
#
KeepAliveTimeout 15

##
##Server-Pool大小设定（针对MPM的）
##

# prefork MPM
# StartServers:启动时服务器启动的进程数
# MinSpareServers:保有的备用进程的最小数目
# MaxSpareServers:保有的备用进程的最大数目
# MaxClients:服务器允许启动的最大进程数
# MaxRequestsPerChild:一个服务进程允许的最大请求数

StartServers 5
MinSpareServers 5
MaxSpareServers 10
MaxClients 150
MaxRequestPerChild 0

# worker MPM
# StartServers:服务器启动时的服务进程数目
# MaxClients:允许同时连接的最大用户数目
# MinSpareThreads:保有的最小工作线程数目
# MaxSpareThreads:允许保有的最大工作线程数目
# ThreadsPerChild:每个服务进程中的工作线程常数
# MaxRequestsPerChild:服务进程中允许的最大请求数目

StartServers 2
MaxClients 150
MinSpareThreads 25
MaxSpareThreads 75
ThreadsPerChild 25
MaxRequestsPerChild 0

# perchild MPM
# NumServers:服务进程数量
# StartThreads:每个服务进程中的起始线程数量
# MinSpareThreads:保有的最小线程数量
# MaxSpareThreads:保有的最大线程数量
# MaxThreadsPerChild:每个服务进程允许的最大线程数
# MaxRequestsPerChild:每个服务进程允许连接的最大数量

NumServers 5
StartThreads 5
MinSpareThreads 5
MaxSpareThreads 10
MaxThreadsPerChild 20
MaxRequestsPerChild 0


#
# Listen:允许你绑定Apache服务到指定的IP地址和端口上，以取代默认值
# 参见指令
# 使用如下命令使Apache只在指定的IP地址上监听，
# 以防止它在IP地址0.0.0.0上监听
#
# Listen 127.0.0.1:80

Listen 80

#
# 动态共享支持（DSO）
#
# 为了能够使用那些以DSO模式编译的模块中的函数，你必须有相应的"LoadModule"行，
# 因此，在这里包含了这些指令，以便能在使用它之前激活。
# 那些静态编译的模块不需要在这里列出 (即以"httpd -l"列出的模块)
#
# 示例：
# LoadModule foo_module modules/mod_foo.so
#

#
# ExtendedStatus：当调用"server-status"时，控制Apache是产生"全"状态
# 信息（ExtendedStatus On），还是产生基本信息（ExtendedStatus Off）。
# 默认为off
#
# ExtendedStatus On

###  (2)"主"服务配置
#
# 这一区建立被 "主" 服务器用的指令值,以回应那些不被定义处理的任何请求。
# 这些数值也提供默认值给后面定义的容器。
# 如果中有定义，那么这里定义的指令值将被中的定义所覆盖。
#

#
# 如果你想使httpd以另外的用户或组来运行，你必须在开始时以root方式启动
# 然后再将它切换为你想要使用的用户或组。
#
# User/Group:运行httpd的用户和组
# 在SCO (ODT3)上使用"User nouser"和"Group nogroup"
# 在HPUX上，你可能不能以nobody身份使用共享内存，建议创建一个www用户。
# 注意一些核心（kernel）在组ID大于60000时拒绝setgid(Group)或semctl(IPC_SET)，
#节在这些系统上不要使用"Group #-1"。
#
User nobody
Group #-1

#
# ServerAdmin:你的邮件地址，当发生问题时Apache将向你发出邮件。
# 作为一个出错文档，这个地址显示在server-generated页上，
# 例如：[e-mail]
#
ServerAdmin [e-mail]

#
# ServerName指定Apache用于识别自身的名字和端口号。
# 通常这个值是自动指定的，但是我们推荐你显式的指定它以防止启动时出错
#
# 如果你为你的主机指定了一个无效的DNS名，server-generated重定向将不能工作。
# 参见UseCanonicalName指令
#
# 如果你的主机没有注册DNS名，在这里键入它的IP地址
# 无论如何，你必须使用它的IP地址来提供服务，
# 这里使用一种容易理解的方式重定向服务
ServerName www.domain.com:80

#
# UseCanonicalName:决定Apache如何构造URLS和 SERVER_NAME 和 SERVER_PORT 的指令。
# 当设置为 "Off"时,Apache会使用用户端提供的主机名和端口号。
# 当设置为"On",Apache会使用ServerName指令的值。
#
UseCanonicalName Off

#
# DocumentRoot:你的文档的根目录。默认情况下，所有的请求从这个目录进行应答。
# 但是可以使用符号链接和别名来指向到其他的位置。
#
DocumentRoot "/home/redhat/public_html"

#
# Apache可以存取的每个目录都可以配置存取权限（包括它的子目录）。
#
# 首先，我们配置一个高限制的特征。

# 这将禁止访问文件系统所在的目录，并添加你希望允许访问的目录块。
# 如下所示

Order Deny,Allow
Deny from all


#
# 注意从这里开始你一定要明确地允许哪些特别的特征能够被使用。
# - 所以，如果Apache没有象你所期待的那样工作的话,
# 请检查你是否在下面明确的指定它可用。
#

#
# 这将改变到你设置的DocumentRoot
#


#
# Options：这个指令的值可以是"None"，"All"，或者下列选项的任意组合：
# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
#
# 注意，"MultiViews"必须被显式的指定，"Options All"不能为你提供这个特性。
#
# 这个指令既复杂又重要，请参见
#"http://httpd.apache.org/docs-2.0/mod/core.html#optioins"以取得更多的信息。
#
Options FollowSymLinks

#
# AllowOverride控制那些被放置在.htaccess文件中的指令。
# 它可以是"All"，"None"，或者下列指令的组合：
# Options FileInfo AuthConfig Limit
#
AllowOverride None

#
# UserDir:指定在得到一个~user请求时将会添加到用户home目录后的目录名。
#

UserDir public_html

# 为防止在UserDir指令上的漏洞，对root用户设置
# 象"./"这样的UserDir是非常有用的。
# 如果你使用Apache 1.3或以上版本，我们强烈建议你
# 在你的服务器配置文件中包含下面的行

UserDir disabled root

#
# 下面是一个使用UserDir指令使一个站点的目录具有只读属性的示例：
#
#
# AllowOverride FileInfo AuthConfig Limit Indexes
# Options MultiViews Indexes SymLinksIfOwnerMatch IncludeNoExec
#
# Order allow,deny
# Allow from all
#
#
# Order deny,allow
# Deny from all
#
#

#
# DirectoryIndex:定义请求是一个目录时，Apache向用户提供服务的文件名
#
# index.html.var文件（一个类型映象文件）用于提供一个文档处理列表，
# 出于同样的目的，也可以使用MultiViews选项，但是它会非常慢。
#
DirectoryIndex index.php index.html index.html.var

#
# AccessFileName:在每个目录中查询为目录提供附加配置指令的文件的文件名。
# 参见AllowOverride指令。
#
AccessFileName .htaccess

#
# 下面的行防止.htaccess和.htpasswd文件被Web客户查看。
#

Order allow,deny
Deny from all


#
# Typeconfig:定义在哪里查询mime.types文件。
#
TypeConfig conf/mime.types

#
# DefaultType:定义当不能确定MIME类型时服务器提供的默认MIME类型。
# 如果你的服务主要包含text或HTML文档，"text/plain"是一个好的选择；
# 如果大多是二进制文档，诸如软件或图像，你应使用
# "application/octer-stream"来防止浏览器象显示文本那样显示二进制文件。
#
DefaultType text/plain

#
# mod_mime_magic允许服务器从自己定义自己类型的文件中使用不同的线索（hints），
# 这个MIMEMagicFile指令定义hints定义所在的文件。
#

MIMEMagicFile conf/magic


#
# HostnameLookups：指定记录用户端的名字还是IP地址，例如，本指令为on时
# 记录主机名，如www.apache.org；为off时记录IP地址，204.62.129.132。
# 默认值为off，这要比设为on好得多，因为如果设为on则每个用户端请求都将会
# 至少造成对 nameserver 进行一次查询。
#
HostnameLookups Off

#
# EnableMMAP:控制是否进行内存转储（如果操作系统支持的话）。
# 默认为on，如果你的服务器安装在网络文件系统上（NFS），请关闭它。
# 在一些系统上，关闭它会提升系统性能（与文件系统类型无关）；
# 具体情况请参阅http://httpd.apache.org/docs-2.0/mod/core.html#enablemmap
#
# EnableMMAP off

#
# EnableSendfile:控制是否使用sendfile kernel支持发送文件
# （如果操作系统支持的话）。默认为on，如果你的服务器安装在网络文件系统
# （NFS）上，请你关闭它。
# 参见http://httpd.apache.org/docs-2.0/mod/core.html#enablesendfile
#
# EnableSendfile off

#
# ErrorLog:错误日志文件定位。
# 如果你没有在内定义ErrorLog指令，这个虚拟主机的错误信息
# 将记录在这里。如果你在那儿定义了ErrorLog，这些错误信息将记录在你所
# 定义的文件里，而不是这儿定义的文件。
#
ErrorLog logs/error_log

#
# LogLevel:控制记录在错误日志文件中的日志信息数量。
# 可能的值包括：debug，info，notice，warn，error，crit，alert，emerg。
#
LogLevel warn

#
# 下面的指令为CustomLog指令定义格式别名。
#
LogFormat "%h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i"" combined
LogFormat "%h %l %u %t "%r" %>s %b" common
LogFormat "%{Referer}i -> %U" referer
LogFormat "%{User-agent}i" agent

# 你需要安装了mod_logio.c模块才能使用%I和%O。
# LogFormat "%h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-Agent}i" %I %O" combinedio

#
# 指定接入日志文件的定位和格式（一般日志格式）。
# 如果你没有在内定义这个指令，传输信息将记录在这里，
# 如果你定义了这个指令，则记录在你指定的位置，而不是这儿定义的位置。
#
CustomLog logs/access_log common

#
# 如果你想要记录agent和referer信息，可以使用下面的指令
#
# CustomLog logs/referer_log referer
# CustomLog logs/agent_log agent

#
# 如果你想要使用一个文件记录access，agent和referer信息，
# 你可以如下定义这个指令：
#
# CustomLog logs/access_log combined

#
# ServerTokens
# 这个指令定义包含在HTTP回应头中的信息类型。默认为"Full"，
# 这表示在回应头中将包含模块中的操作系统类型和编译信息。
# 可以设为列各值中的一个：
# Full | OS | Minor | Minimal | Major | Prod
# Full传达的信息最多，而Prod最少。
#
ServerTokens Full

#
# 随意的添加包含服务器版本和虚拟主机名字一行信息到server-generated输出页中
# （内部错误文档，FTP目录列表，mod_status和mod_info输出等等，除了CGI错误
# 或自定义的错误文档以外）。
# 设为"EMail"将包含一个指向ServerAdmin的mailto:连接。
# 可以为如下值：On | Off | EMail
#
ServerSignature On

#
# Aliases:在这时添加你需要的别名，格式如下：
# Alias 别名 真实名
#
# 注意，如果你在别名的未尾包含了"/"，那么在URL中也需要包含"/"。
# 因此，"/icons"不是这个示例中的别名。
# 如果别名中以"/"结尾，那么真实名也必须以"/"结尾，
# 如果别名中省略了结尾的"/"，那么真实名也必须省略。
#
# 我们使用别名"/icons/"来表示FancyIndexed目录列表，如果你不使用、
# FancyIndexing，你可以注释掉它。
#
# Alias /icons/ "/usr/local/apache2/icons/"

#
# Options Indexes MultiViews
# AllowOverride None
# Order allow,deny
## Allow from all
#

#
# 这将改变ServerRoot/manual。这个别名提供了手册页所在的位置，
# 即使你改变了你的DocumentRoot。如果你对有无手册页并不在意的话，
# 你可以注释掉它。
#
Alias /manual "/usr/loacl/apache2/manual"


Options Indexes FollowSymLinks MultiViews IncludesNoExec
AddOutputFilter Includes html
Order allow,deny
Allow from all


#
# ScriptAlias:指定包含服务脚本的目录。
# ScriptAliases 本质上与Aliases一样，除了这里的文档在请求时做为程序处理处理以外。
# 尾部的"/"规则与Alias一样
#
ScriptAlias /cgi-bin/ "/usr/loacl/apache2/cgi-bin/"

# 这里是添加php 4支持的指令
AddType application/x-httpd-php .php
LoadModule php4_module modules/libphp4.so


#
# 添加mod_cgid.c设置，mod_cgid提供使用cgid进行通讯的UNIX套接字的
# 脚本接口路径。
#
# Scriptsock logs/cgisock


#
# 将"/usr/local/apache2/cgi-bin"改为你的ScriptAliased指定的CGI目录，
# 如果你配置了的话。
#

AllowOverride None
Options None
Order allow,deny
Allow from all


#
# Redirect允许你告诉客户端使用存在于服务器名字空间中的文档，
# 而不是现在的，这帮助客户定位那些改变了位置的文档。
# 例如：
# Redirect permanent /foo http://www.example.com/bar

#
# 控制server-generated目录列表显示的指令
#

#
# IndexOptions:控制server-generated目录列表显示特征。
#
IndexOptions FancyIndexing VersionSort

#
# AddIcon* 指令告诉服务器不同扩展名的图象文件如何显示，
# 只适用于FancyIndexed指令
#
AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
AddIconByType (TXT,/icons/text.gif) text/*
AddIconByType (IMG,/icons/image2.gif) image/*
AddIconByType (SND,/icons/sound2.gif) audio/*
AddIconByType (VID,/icons/movie.gif) video/*

AddIcon /icons/binary.gif .bin .exe
AddIcon /icons/binhex.gif .hqx
AddIcon /icons/tar.gif .tar
AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
AddIcon /icons/a.gif .ps .ai .eps
AddIcon /icons/layout.gif .html .shtml .htm .pdf
AddIcon /icons/text.gif .txt
AddIcon /icons/c.gif .c
AddIcon /icons/p.gif .pl .py
AddIcon /icons/f.gif .for
AddIcon /icons/dvi.gif .dvi
AddIcon /icons/uuencoded.gif .uu
AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
AddIcon /icons/tex.gif .tex
AddIcon /icons/bomb.gif core

AddIcon /icons/back.gif ..
AddIcon /icons/hand.right.gif README
AddIcon /icons/folder.gif ^^DIRECTORY^^
AddIcon /icons/blank.gif ^^BLANKICON^^

#
# DefaultIcon 为那些没有显式定义图标的文件提供处理
#
DefaultIcon /icons/unknown.gif

#
# AddDescription允许你在server-generated索引后放置一个简短的说明。
# 只对FancyIndexed指令有效。
# 格式：AddDescription "说明" 文件名
#
# AddDescription "GZIP compressed document" .gz
# AddDescription "tar archive" .tar
# AddDescription "GZIP compressed tar archive" .tgz

#
# ReadmeName指定服务器默认查找的README文件的名字，并添加到目录列表中
#
# HeaderName指定目录列表前缀文件的文件名
ReadmeName README.html
HeaderName HEADER.html

#
# IndexIgnore指定目录索引忽略并且不包含在列表中的文件名集合，
# 支持shell类型的通配符。
#
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t

#
# AddEncoding允许你在信息传送中使用(Mosaic/X 2.1+)解压缩信息，
# 注意：不是所有的浏览器都支持这个选项。
# 尽管名字相似，但是下列的指令与上面的FancyIndexing定制指令不同。
#
AddEncoding x-compress Z
AddEncoding x-gzip gz tgz

#
# DefaultLanguage和AddLanguage允许你指定文档的语言。
# 这使你可以让用户用容易理解的语言浏览文档。
#
# 指定默认的语言，这意味着所有没有指定语言的包都将使用该语言。
# 多数情况下，你也许并不想设置它，除非你确信这样做是正确的。
# 通常，不使用确定的语言比使用错误的语言要好。
#
# DefaultLanguage nl
#
# 注意1：作为语言关键字的词缀毫无疑问是不能一样的--采用波兰
# 文的文档（网络标准语言代码是pl）将希望使用"AddLanguage pl .po"
# 来避免与perl脚本的一般词缀产生二义性。
#
# 注意2: 下面的例子举例说明在一些范例中语言的二字符缩写与它的国家
# 的二字符缩写不相同,例如 "Danmark/dk" 和 "Danmark/da" 的比较.
#
# 注意3: 在 "ltz" 的情况下我们使用三字符词缀，违犯了 RFC的规定，
# 运行中将修复它并使用RFC1766标准取得参考数据。
#
# Danish (da) - Dutch (nl) - English (en) - Estonian (et)
# French (fr) - German (de) - Greek-Modern (el)
# Italian (it) - Norwegian (no) - Norwegian Nynorsk (nn) - Korean (ko)
# Portugese (pt) - Luxembourgeois* (ltz)
# Spanish (es) - Swedish (sv) - Catalan (ca) - Czech(cz)
# Polish (pl) - Brazilian Portuguese (pt-br) - Japanese (ja)
# Russian (ru) - Croatian (hr)
#
AddLanguage da .dk
AddLanguage nl .nl
AddLanguage en .en
AddLanguage et .et
AddLanguage fr .fr
AddLanguage de .de
AddLanguage he .he
AddLanguage el .el
AddLanguage it .it
AddLanguage ja .ja
AddLanguage pl .po
AddLanguage ko .ko
AddLanguage pt .pt
AddLanguage nn .nn
AddLanguage no .no
AddLanguage pt-br .pt-br
AddLanguage ltz .ltz
AddLanguage ca .ca
AddLanguage es .es
AddLanguage sv .sv
AddLanguage cz .cz
AddLanguage ru .ru
AddLanguage tw .tw
AddLanguage zh-tw .tw
AddLanguage hr .hr

# LanguagePriority允许你在会话过程中优先使用一些语言。
#
# 以优先次序递减的方式列出它们。我们或多或少地采用按字母排列顺序的方式
# 排列它们。也许你想要改变这个顺序。
LanguagePriority en da nl et fr de el it ja ko no pl pt pt-br ltz ca es sv tw

#
# ForceLanguagePriority 允许你为MULTIPLE CHOICES(Prefer)[在通讯的情况下]
# 或NOT ACCEPTABLE(Fallback)[没有可接受的语言匹配的情况]提供一个结果页。
#
ForceLanguagePriority Prefer Fallback

#
# 为发送出的所有页指定默认的字符集，这总是一个好主意，并且为你的
# web站点的国际化打开了大门，这不正是你曾经想要的吗。同样地，指定
# 默认字符集有一些小的损害，如一个使用iso-8859-1(latin1)标准命令
# 的页面，除非以别的方式指定例如你仅仅以显式方式声明它。
# 也有一些与那些总是鼓励你使用默认字符集的javascropt和URL语法有关
# 的浏览器安全原因。