Apache中Httpd.conf详解(一)

#
# Apache服务器主配置文件. 包括服务器指令的目录设置.
# 详见 <URL: http://www.apache.org/docs/ > 
#
# 请在理解用途的基础上阅读各指令。
#
# 再读取此文档后，服务器将继续搜索运行
# E:/Program Files/Apache Group/Apache/conf/srm.conf 
# E:/Program Files/Apache Group/Apache/conf/access.conf
# 除非用ResourceConfig或AccessConfig覆盖这儿的标识
#
# 配置标识由三个基本部分组成:
# 1. 作为一个整体来控制Apache服务器进程的标识 (the 'global environment').
# 2. 用于定义主（默认）服务器参数的标识。
#     响应虚拟主机不能处理的请求。
#     同时也提供所有虚拟主机的设置值。
# 3. 虚拟主机的设置。在一个Apache服务器进程中配置不同的IP地址和主机名。
#
# 配置和日志文件名：指定服务器控制文件命名时，
# 以 "/" (或 "drive:/" for Win32)开始，服务器将使用这些绝对路径。
# 如果文件名不是以"/"开始的，预先考虑服务器根目录--
# 因此 "logs/foo.log"，如果服务器根目录是"/usr/local/apache"，
# 服务器将解释为 "/usr/local/apache/logs/foo.log".
#
# 注: 指定的文件名需要用"/"代替"\"。
# (例, "c:/apache" 代替 "c:\apache").
# 如果省略了驱动器名，默认使用Apache.exe所在的驱动器盘符
# 建议指定盘符，以免混乱。
#


### 部分 1: 全局环境
#
# 本部分的表示将影响所有Apache的操作
# 例如，所能处理的并发请求数或配置文件地址
#


#
# ServerType 可取值 inetd 或 standalone. Inetd 只适用于Unix平台
#
ServerType standalone


#
# ServerRoot: 目录树的根结点。服务器配置、出错信息、日志文件都保存在根目录下。
#
# 不要再目录末尾加"/"
#
ServerRoot "C:/Program Files/Apache Group/Apache"


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


#
# ScoreBoardFile: 用于保存内部服务器进程信息的文件。
# 并非必须。 但是如果指定了（此文件当运行Apache时生成）
# 那么必须确保没有两个Apache进程共享同一个scoreboard文件。
#
ScoreBoardFile logs/apache_runtime_status


#
# 在标准配置下，服务器将顺序读取 httpd.conf(此文件可通过命令行中-f参数指定），
# srm.conf 和 access.conf。 
# 目前后两个文件是空的。为了简单起见，建议将所有的标识放在一个文件中。 
# 以下两条注释的标识，是默认设置。
# 要让服务器忽略这些文件可以用 "/dev/null" (for Unix) 
# 或"nul" (for Win32) 作为参数。
#
#ResourceConfig conf/srm.conf
#AccessConfig conf/access.conf


#
# Timeout: 接受和发送timeout的时间
#
Timeout 300


#
# KeepAlive: 是否允许保持连接（每个连接有多个请求）
# "Off" -无效
#
KeepAlive On


#
# MaxKeepAliveRequests: 每个连接的最大请求数。
# 设置为0表示无限制
# 建议设置较高的值，以获得最好的性能。
#
MaxKeepAliveRequests 100


#
# KeepAliveTimeout: 同一连接同一客户端两个请求之间的等待时间。
#
KeepAliveTimeout 15


#
# 在Win32下,Apache每次产生一个子进程来处理请求。
# 如果这个进程死了，会自动产生另一个子进程。
# 所有的进入请求在子进程中多线程处理。
# 以下两个标识控制进程的运行
#


#
# MaxRequestsPerChild: 每个子进程死亡之前最大请求数
# 如果超过这个请求数，子程序会自动退出，避免延期使用导致内存溢出或其他问题。
# 大部分系统，并不需要此设置，
# 但是部分，象Solaris，确实值得注意。
# 对Win32, 可设置为0 (无限制)
# 除非有另外的考虑。
#
# 注: 此值不包括在每个连接初始化请求后，"keptalive"请求
#       例如, 如果一个子进程处理一个初始化请求和10个后续"keptalive"请求，
#       在这个限制下，只会记为一个请求。
#
MaxRequestsPerChild 0


#
# ThreadsPerChild: 服务器所允许的并发线程数。
# 此值的设置取决于服务器的响应能力（约多的请求在同一时间激活，则每个请求的处理时间越慢）
# 和服务器所允许消耗的系统资源。
#
ThreadsPerChild 50


#
# Listen: 允许将Apache绑顶到指定的IP地址和端口，作为默认值的辅助选项。
# 参见 <VirtualHost>
#
#Listen 3000
#Listen 12.34.56.78:80


#
# BindAddress: 通过此选项可支持虚拟主机。
# 此标识用于告诉服务器监听哪个IP地址。
# 包括："*", IP地址, 或域名.
# 参见 <VirtualHost> 和 Listen directives.
#
BindAddress 166.111.178.144


#
# Apache模块编译成标准的Windows结构。
#
# 以下模块绑定到标准的Apache二进制windows分布。
# 要修改标准操作，取消以下行的注释并且修改指定模块列表。 
#
# 警告：这是高级选项。可能导致服务器崩溃。
# 没有专家的指导，不要轻易修改。
#
#ClearModuleList
#AddModule mod_so.c mod_mime.c mod_access.c mod_auth.c mod_negotiation.c
#AddModule mod_include.c mod_autoindex.c mod_dir.c mod_cgi.c mod_userdir.c
#AddModule mod_alias.c mod_env.c mod_log_config.c mod_asis.c mod_imap.c
#AddModule mod_actions.c mod_setenvif.c mod_isapi.c


#
# 动态共享对象（Dynamic Shared Object，DSO） 
#
# 要使用基于DSO的功能模块，需要替换此处相应的
# `LoadModule' 行。这样在使用之前这些包含的标识都将生效。
# 有关DSO及至的详细资料请看Apache1.3版中的README.DSOSO。
# 运行"apche -l"将列表显示Apache内奸的模块（类似标准的连接已经生效）
#
# 注：模块载入的顺序很重要。没有专家的建议，不要修改以下的顺序。
#
#LoadModule anon_auth_module modules/ApacheModuleAuthAnon.dll
#LoadModule dbm_auth_module modules/ApacheModuleAuthDBM.dll
#LoadModule digest_auth_module modules/ApacheModuleAuthDigest.dll
#LoadModule cern_meta_module modules/ApacheModuleCERNMeta.dll
#LoadModule digest_module modules/ApacheModuleDigest.dll
#LoadModule expires_module modules/ApacheModuleExpires.dll
#LoadModule headers_module modules/ApacheModuleHeaders.dll
#LoadModule proxy_module modules/ApacheModuleProxy.dll
#LoadModule rewrite_module modules/ApacheModuleRewrite.dll
#LoadModule speling_module modules/ApacheModuleSpeling.dll
#LoadModule info_module modules/ApacheModuleInfo.dll
#LoadModule status_module modules/ApacheModuleStatus.dll
#LoadModule usertrack_module modules/ApacheModuleUserTrack.dll


#
# ExtendedStatus 在服务器状态句柄被呼叫时控制是产生“完整”的状态信息(ExtendedStatus On)
# 还是仅返回基本信息(ExtendedStatus Off)
# 默认是：Off
#
#ExtendedStatus On


### 部分 2: 主服务器配置
#
# 此部分的标识用于主服务器所有的设置值，
# 响应任何<VirtualHost>定义不处理的请求
# 这些值同时给你稍后在此文件中定义的<VirtualHost>提供默认值。
#
# 所有的标识可能会在<VirtualHost>中出现。
# 对应的默认值会被虚拟主机重新定义覆盖。
#


#
# Port: Standalone服务器监听的端口。 
# 在Apache能够监听指定端口前，需要在防火墙中进行设置。
# 其它运行httpd的服务器也可能影响此端口。 Disable
# 如果遇到问题，请关闭所有的防火墙、安全保护和其他的服务。
# Windos NT的"NETSTAT -a"指令会有助于问题的分析。
#
Port 80


#
# ServerAdmin: 你的地址。如果服务器有任何问题将发信到这个地址。
# 这个地址会在服务器产生的某些页面中出现，例如，错误报告。
#
ServerAdmin  chenyl98@mails.tsinghua.edu.cn


#
# ServerName 允许设置主机名。如果与程序获得的不同，主机名将返回客户端。
# （例如，用"www"代替主机真实的名字）
#
# 注: 主机名不能随便指定。必须是你的机器有效的DNS名称。否则无法正常工作。
# 如果不能理解，倾向你的网络管理员询问。
# 如果你的主机没有注册DNS名，可在此输入IP地址。
# 此时必须用IP地址来访问。(如,  http://123.45.67.89/ )
# 这样扔可以完成重新定向的工作。
#
# 127.0.0.1 是TCP/IP的本地环路地址, 通常命名为localhost. 
# 机器默认此地置为本身。 如果只是使用Apache来进行本地测试和开发， 
# 可使用127.0.0.1 作为服务器名.
#
#ServerName new.host.name



#
# DocumentRoot: 放置服务文档的目录。
# 默认状态下，所有的请求都以这个目录为基础。
# 但是直接符号连接和别名可用于指向其他位置。
#
DocumentRoot "D:/www_root"


#
# Apache访问的每个目录可设置相关的服务和特性是允许或（和）不允许。
# (同样影响其子目录） 
#
# 首先，设置"default"地址只有最基本的权限。
#
<Directory />
    Options FollowSymLinks
    AllowOverride None
</Directory>


#
# 注意从现在开始必须制定开启特殊的权限。
# 这样就不会产生意想不到的结果。
# 请仔细确认。
#


#
# 这个地址应与DocumentRoot保持一致
#
<Directory "D:/www_root">


#
# 此值可是： "None", "All", 或下列的组合： "Indexes",
# "Includes", "FollowSymLinks", "ExecCGI", 或 "MultiViews".
#
# 注意"MultiViews"必须明确指定--- "Options All"不包括此特性。
#
    Options Indexes FollowSymLinks MultiViews


#
# 此项控制目录中哪些.htaccess文件可覆盖。
# 允许值： "All"或者以下项的组合："Options", "FileInfo", 
# "AuthConfig", "Limit"
#
    AllowOverride None


#
# 控制哪些用户可从此服务器获得资料。
#
    Order allow,deny
    Allow from all
</Directory>


#
# UserDir: 当请求~user时，追加到用户主目录的路径地址。
#
# 在Win32下，并不要求指定为用户登陆的主目录。
# 因此可使用以下的格式。 
# 详细参照文档UserDir
#
<IfModule mod_userdir.c>
    UserDir "f:/homepages/"
</IfModule>


#
# 控制访问UserDir目录. The following is an example
# 以下是一个站点的例子，权限限制为只读。
#
#<Directory "E:/Program Files/Apache Group/Apache/users">
#    AllowOverride FileInfo AuthConfig Limit
#    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
#    <Limit GET POST OPTIONS PROPFIND>
#        Order allow,deny
#        Allow from all
#    </Limit>
#    <LimitExcept GET POST OPTIONS PROPFIND>
#        Order deny,allow
#        Deny from all
#    </LimitExcept>
#</Directory>


#
# DirectoryIndex: 预设的HTML目录索引文件名。
# 用空格来分隔多个文件名。
#
<IfModule mod_dir.c>
    DirectoryIndex index.html
</IfModule>


#
# AccessFileName: 每个目录中用于控制访问信息的文件名。
#
AccessFileName .htaccess


#
# 以下行防止客户端可访问 .htaccess 文件。
# 因为 .htaccess文件通常包含授权信息，
# 处于安全的考虑不允许访问。 
# 如果想让访客看到.htaccess文件的内容，
# 可将这些行注释。
# 如果修改了上面的AccessFileName,
# 请在此进行相应的修改。
#
# 同时，一般会用类似.htpasswd的文件保存密码。
# 这些文件同样可以得到保护。
#
<Files ~ "^\.ht">
    Order allow,deny
    Deny from all
</Files>


#
# CacheNegotiatedDocs: 默认下，Apache对每个文档发送"Pragma: no-cache"
# 这将要求代理服务器不缓存此文档。
# 取消下列行的可取消这个属性，这样代理服务器将缓存这些文档。
#
#CacheNegotiatedDocs


#
# UseCanonicalName: (1.3新增) 当此设置为on时，
# 无论何时Apache需要构建一个自引用的URL(指向响应来源服务器），
# 它将用ServerName和Port来构建一个规范的格式。
# 当此设置为off时，Apache将使用客户端提供的"主机名：端口"
# 这将同时影响CGI脚本中的SERVER_NAME和SERVER_PORT
#
UseCanonicalName On


#
# TypesConfig 记录媒体类型（mime.types）文件或类似的东东放置的位置
#
<IfModule mod_mime.c>
    TypesConfig conf/mime.types
</IfModule>


#
# DefaultType 是服务器处理未确认类型的文件，如为止的扩展名，的默认类型。
# 如果你的服务器上主要包含的是文本或HTML文档，"text/plain"是较好的设置 
# 如果服务器上主要包含二进制文件，如应用程序或图片，
# 最好设置成"application/octet-stream"防止浏览器将二进制文件以文本的方式显示。
#
DefaultType text/plain


#
# mod_mime_magic模块允许服务器使用文件自身的不同标识来确定文件类型。
# MIMEMagicFile指示模块文件标识的定义所在的位置。
# mod_mime_magic不是默认服务器的一部分。
# (必须自行用LoadModule来追加 [见'全局环境'部分的 DSO 章节],
# 或者在编译服务器时包含mod_mime_magic部分）
# 包含在 <IfModule> 中.
# 就是说，如果该模块是服务器的一部分，MIMEMagicFile标识将执行。
#
<IfModule mod_mime_magic.c>
    MIMEMagicFile conf/magic
</IfModule>


#
# HostnameLookups: 注册客户端的机器名或IP地址。
# 例如：  www.apache.org  (on) 或 204.62.129.132 (off).
# 默认为off，因为对于网络来说，最好让人们有意识的设置为on，
# 因为开启此功能意味着每个客户请求将导致至少向name服务器发送一个lookup请求
#
HostnameLookups Off


#
# ErrorLog: 错误记录文件的地址
# 如果不在<VirtualHost>内指定ErrorLog 
# 改虚拟主机的错误心细将记录到此处。
# 如果在<VirtualHost>中明确指定了错误记录文件，
# 则错误将记录在那儿而不是这儿。
#
ErrorLog logs/error.log


#
# LogLevel: 控制记录在error.log中信息的个数.
# 可能的值：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


#
# 访问记录的位置和格式 (功用的记录文件格式).
# 如果不在<VirtualHost>中定义记录文件，
# 那些访问记录就将保存在这儿。 Contrariwise, if you *do*
# 反之，如果指定了记录文件，那么访问记录将记录在那儿而不是这个文件中。
#
CustomLog logs/access.log common


#
# 如果希望使用代理和参考的记录文件, 取消以下标识的注释符
#
#CustomLog logs/referer.log referer
#CustomLog logs/agent.log agent


#
# 如果想在一个文件中记录访问、代理、参考信息（复合的记录格式）
# 可使用以下标识
#
#CustomLog logs/access.log combined