Apache服务器配置文件httpd

1、本文为apache服务器配置文件httpd.conf的中文说明，早前转自网络未加链接见谅，非 天缘原创文章，仅仅略加完善。#基于ncsa服务器的配置文件由rob mccool编写# apache服务器主配置文件.包括服务器指令的目录设置.# 详见 <url:http:/clocs/>#请在理解用途的基础上阅读各指令。#再读取此文档后，服务器将继续搜索运行#除非用resourceconfig或accessconfig覆盖这儿的标识#配置标识由三个基本部分组成：# 1.作为一个整体来控制apache服务器进程的标识(the 'global envir

2、onment').# 2.用于定义主(默认)服务器参数的标识。# 响应虚拟主机不能处理的请求。# 同时也提供所有虚拟主机的设置值。# 3.虚拟主机的设置。在一个apache服务器进程中配置不同的ip地址和主机名。#配置和日志文件名：指定服务器控制文件命名时， #以7”(或hdrive:/" for win32)开始，服务器将使用这些绝对路径。#如果文件名不是以v"开始的，预先考虑服务器根目录一# 因此"logs/foo.log",如果服务器根目录是7usr/local/apache",# 月艮务器将解释为"/usr/local

3、/apache/logs/foo.log".#注：指定的文件名需要用7"代替"”。# （例,mc:/apache"代替 nc:apachem.#如果省略了驱动器名,默认使用apache.exe所在的驱动器盘符#建议指定盘符，以免混乱。#部分1:全局环境#本部分的表示将影响所有apache的操作#例如，所能处理的并发请求数或配置文件地址# servertype 可取值 inetd 或 standalone. inetd 只适用于 unix 平台#servertype standalone# serverroot:目录树的根结点。服务器配置、出错信息、日志文

4、件都保存在根目录下。# #不要再目录末尾加v”serverroot nc:/program files/apache group/apache"# pidfile:服务器用于记录启动时进程id的文件。#pidfile logs/httpd.pid# scoreboardfile:用于保存内部服务器进程信息的文件。#并非必须。但是如果指定了(此文件当运行apache时生成)#那么必须确保没有两个apache进程共享同一个scoreboard文件。#scoreboardfile logs/apache_runtime_status#在标准配置下，服务器将顺序读取httpd.conf(此文

5、件可通过命令行中f参数指定)，# srm.conf 禾口 access.conf。#目前后两个文件是空的。为了简单起见，建议将所有的标识放在一个文件中。#以下两条注释的标识,是默认设置。#要让务器忽略这些文件可以用vdev/null" (for unix)# 或”nul” (for win32)作为参数。#resourceconfig conf/srm.conf #accessconfig conf/access.conf# timeout:接受和发送timeout的时间#timeout 300# keepalive:是否允许保持连接（每个连接有多个请求）# "off&qu

6、ot; 无效#keepalive on# maxkeepaliverequests:每个连接的最大请求数。#设置为0表示无限制#建议设置较高的值，以获得最好的性能。#maxkeepaliverequests 100# keepalivetimeout:同一连接同一客户端两个请求之间的等待时间。#keepalivetimeout 15#在win32下,apache每次产生一个子进程来处理请求。#如果这个进程死了，会自动产生另一个子进程。#所有的进入请求在子进程中多线程处理。#以下两个标识控制进程的运行# maxrequestsperchild:每个子进程死亡之前最大请求数#如果超过这个请求数,子

7、程序会自动退出，避免延期使用导致内存溢出或其他问题。#大部分系统，并不需要此设置，#但是部分，象solaris，确实值得注意。#对win32,可设置为0 （无限制）#除非有另外的考虑。#注：此值不包括在每个连接初始化请求后,“keptalive”请求# 例如，如果一个子进程处理一个初始化请求和10个后续"keptalive"请求，# 在这个限制下，只会记为一个请求。#maxrequestsperchild 0# threadsperchild:服务器所允许的并发线程数。#此值的设置取决于服务器的响应能力（约多的请求在同一时间激活,则每个请求的处理时间越慢） #和服务器所允许

8、消耗的系统资源。threadsperchild 50# listen:允许将apache绑顶到指定的ip地址和端口，作为默认值的辅助选项。# 参见 <virtualhost>#listen 3000#listen 8:80# bindaddress:通过此选项可支持虚拟主机。#此标识用于告诉服务器监听哪个ip地址。#包括：”c ip地址，或域名.# 参见 <virtualhost> 和 listen directives.#bin daddress 166.111 丄 78.144# apache模块编译成标准的windows结构。#以下模块绑定到标

9、准的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 modog_config.c mod_

10、asis.c modmap.c#addmodule mod_actions.c mod_setenvif.c modsapi.c# 动态共享对象(dynamic shared object, dso )#要使用基于dso的功能模块，需要替换此处相应的# 'loadmodule1行。这样在使用之前这些包含的标识都将生效。#有关dso及至的详细资料请看apachel.3版中的readme.dsoso。#运行"apche j将列表显示apache内奸的模块(类似标准的连接已经生效)#注：模块载入的顺序很重要。没有专家的建议，不要修改以下的顺序。#loadmodule anon_au

11、th_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 expi

12、res_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 module

13、s/apachemodulelnfo.dll#loadmodule status_module modules/apachemodulestatus.dll#loadmodule usertrackmodule modules/apachemoduleusertrack.dll# extendedstatus在服务器状态句柄被呼叫时控制是产生"完整"的状态信息(extendedstatus on)#还是仅返回基本信息(extendedstatus off)#默认是：off#extendedstatus on#部分2:主服务器配置#此部分的标识用于主服务器所有的设置值,#响应

14、任何virtualhost定义不处理的请求#这些值同时给你稍后在此文件中定义的virtualhost提供默认值。#所有的标识可能会在virtualhost中出现。#对应的默认值会被虚拟主机重新定义覆盖。# port: standalone服务器监听的端口。#在apache能够监听指定端口前，需要在防火墙中进行设置。#其它运行httpd的服务器也可能影响此端口。 disable#如果遇到问题,请关闭所有的防火墙、安全保护和其他的服务。# windos nt的"netstat -a”指令会有助于问题的分析。#port 80# serveradmin:你的地址。如果服务器有任何问题将发信到

15、这个地址。#这个地址会在服务器产生的某些页面中出现，例如，错误报告。#serveradmin chenyl98 at mails dot # servername允许设置主机名。如果与程序获得的不同，主机名将返回客户端。# （例如，用"www”代替主机真实的名字）#注：主机名不能随便指定。必须是你的机器有效的dns名称。否则无法正常工作。#如果不能理解，倾向你的网络管理员询问。#如果你的主机没有注册dns名，可在此输入ip地址。#此时必须用ip地址来访问。（如，9/）#这样扔可以完成重新定向的工作。# 是tcp/ip的本地环路地址，

16、通常命名为localhost.#机器默认此地置为本身。如果只是使用apache来进行本地测试和开发,#可使用作为服务器名.#servername # documentroot:放置服务文档的目录。#默认状态下，所有的请求都以这个目录为基础。#但是直接符号连接和别名可用于指向其他位置。#documentroot "d:/www_root"# apache访问的每个目录可设置相关的服务和特性是允许或（和）不允许。# （同样影响其子目录）#首先，设置"default"地址只有最基本的权限。< directory

17、 />options followsymlinksallowoverride none</directory>#注意从现在开始必须制定开启特殊的权限。#这样就不会产生意想不到的结果。#请仔细确认。#这个地址应与documentroot保持一致#< directory nd:/www_rootn>#此值可是："none； "all；或下列的组合："indexes'；# "ineludes； "followsymlinks； ”execcgi",或"multiviews".#注意&

18、quot;multiviews"必须明确指定"options all”不包括此特性。#options indexes followsymlinks multiviews#此项控制目录中哪些.htaccess文件可覆盖。#允许值："all”或者以下项的组合："options； "fileinfo；# "authconfig", "limit”#allowoverride none#控制哪些用户可从此服务器获得资料。#order allow,denyallow from all</directory># u

19、serdir:当请求user时，追加到用户主目录的路径地址。#在win32下，并不要求指定为用户登陆的主目录。#因此可使用以下的格式。#详细参照文档userdir#<ifmodule mod_userdir.c>userdir ,f:/homepages/m</ifmodule># 控制访问 userdir 目录 the following is an example#以下是一个站点的例子，权限限制为只读。#<directory ne:/program files/apache group/apache/users11 ># allowoverride fi

20、leinfo 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 denyzallow# deny from all# </limitexcept>#</directory>#

21、 directoryindex:预设的html目录索引文件名。#用空格来分隔多个文件名。#<ifmodule mod_dir.c>directoryindex index.html</ifmodule># # accessfilename:每个目录中用于控制访问信息的文件名。accessfilename .htaccess#以下行防止客户端可访问.htaccess文件。#因为.htaccess文件通常包含授权信息，#处于安全的考虑不允许访问。#如果想让访客看到-htaccess文件的内容，#可将这些行注释。#如果修改了上面的accessfilename,#请在此进行相应

22、的修改。#同时，一般会用类似.htpasswd的文件保存密码。#这些文件同样可以得到保护。#<files ,，a.ht">order allow,denydeny from all</files># cachenegotiateddocs:默认下，apache 对每个文档发送"pragma: no-cache"#这彳各要求代理服务器不缓存此文档。#取消下列行的可取消这个属性，这样代理服务器将缓存这些文档。#cachenegotiateddocs# usecanonicalname: （1.3亲斤增）当此设置为on时，#无论何时apache需

23、要构建一个自弓i用的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是服务器处理未确认类型的文件，如为止的扩展名,的

24、默认类型。#如果你的服务器上主要包含的是文本或html文档,"text/plain"是较好的设置#如果服务器上主要包含二进制文件，如应用程序或图片， #最好设置成"application/octetstream"防止浏览器将二进制文件以文本的方式显示。defaulttype text/plain# mod_mime_magic模块允许服务器使用文件自身的不同标识来确定文件类型。# mimemagicfile指示模块文件标识的定义所在的位置。# mod_mime_magic不是默认服务器的一部分。# (必须自行用loadmodule来追加见'全局环

25、境'部分的dso章节,#或者在编译服务器时包含mod_mime_magic部分)#包含在<ifmodule>中.#就是说，如果该模块是服务器的一部分，mimemagicfile标识将执行。#<ifmodule mod_mime_magic.c>mimemagicfile conf/magic</ifmodule># hostnamelookups:注册客户端的机器名或ip地址。# 例如: (on)或 32 (off).#默认为off ,因为对于网络来说，最好让人们有意识的设置为on ,#因为开启此功

26、能意味着每个客户请求将导致至少向name服务器发送一个lookup请求#hostnamelookups off# errorlog:错误记录文件的地址# 如果不在virtualhost内指定 errorlog#改虚拟主机的错误心细将记录到此处。#如果在virtualhost中明确指定了错误记录文件，#则错误将记录在那儿而不是这儿。#errorlog logs/error.log# loglevel:控制记录在error.log中信息的个数.# 可能白勺值:debug, info, notice, warn, error, crit,# alert, emerg.#log level warn#

27、以下标识定义customlog标识使用的格式。（见下）#logformat "%h %l %u %t "%r" %s %b "% referer i" "% user-agent nn combinedlogformat "%h %l %u %t "%r" %s %b" comm onlogformat m% referer i - %u" refererlogformat m% user-age nt i" age nt#访问记录的位置和格式（功用的记录文件格式）.#如果不

28、在virtualhost中定义记录文件，#那些访问记录就将保存在这儿。contrariwise, if you *do*#反之，如果指定了记录文件，那么访问记录将记录在那儿而不是这个文件中。#customlog logs/accessog comm on#如果希望使用代理和参考的记录文件，取消以下标识的注释符#customlog logs/referer.log referer#customlog logs/age ntog age nt#如果想在一个文件中记录访问、代理、参考信息（复合的记录格式）#可使用以下标识#customlog logs/accessog combined#在服务器产生

29、的页面（如错误文档信息，ftp目录列表等等,不包括cgi产生的文档）中#增加一条服务器版本和虚拟主机名的信息。#设置为"email"将包含mailto: serveradmin的连接.# 可选值：on | off | emailserversignature on#默认下,apache用工作行解析所有cgi脚本#此注释行（脚本的第一行）包括'#和'!后面跟着执行特殊脚本的程序路径，# 对 perl 脚本来说是 c:program filesperl 目录中的 perl.exe。#工作行如下：#!c:/program files/perl/perl#注意真实的

30、工作行不能有缩进，必须是文件的第一行。#当然，cgi进程必须通过适当的scriptalias或execcgi选项标识来启动。#然而，windows下的apache即允许以上的unix方式，也可以通过注册表的形式。#用注册表执行文件的方法同在windows资源管理器中双击运行的注册方法相同。#此脚本操作可在windows资源管理器的"查看"菜单中设置。# "文件夹选项"，然后查看文件类型"。点击编辑按钮。#修改操作属性。apache 1.3会尝试执行open操作，#如果失败则会尝试工作行#这个属性在apache release 2.0中会有改变.

31、#每个机制都有自身特定的安全弱点，这样可能导致别人运行你不希望调用的程序。#最佳的解决方案还在讨论中。#要是这个windows的特殊属性生效(同时会是unix属性无效)#取消下列标识的注释符。#scriptinterpretersource registry#上面的标识可在v directory>块或htaccess文件中单独替换。# 可选择'registry' (windows behavior)或'script'# (unix behavior) option,将覆盖服务器的默认值。# aliases:可无限制的追加别名。格式如下：# alias假名真

32、名#<ifmodule mod_alias.c>#注意如果假名中包含7，服务器会在当前url中发出请求。#因此”/icons”不能用于别名# 必须用"/icons/".#alias /icons/ "c:/program files/apache group/apache/icons/"<directory "c:/program files/apache group/apache/icons">options indexes multiviewsallowoverride noneorder allow,de

33、nyallow from all</directory>#scriptalias:控制哪个目录包含服务器脚本。# scriptalias 本质行和 aliases 样except that#区别在于真名目录中的文档被看作是一个应用程序。#请求时由服务器运行而不是发往客户端。# 7”符号的规则同# alias 相同.#scriptalias /cgi-bin/ hc:/program files/apache group/apache/cgi-bin/'1# "c:/program files/apache group/apache/cgi-binh 可修改为任何放

34、置cgi脚本的目录#<directory typrogram files/apache group/apache/cgi-binh>allowoverride noneoptions noneorder allow,denyallow from all </directory></ifmodule>#别名结束#php脚本说明scriptalias /php/ "d:/php/naddtype application/xhttpdphp .phpaddtype application/xhttpdphp .php3addtype applicatio

35、n/x-httpd-php .phtmlaction application/x-httpd-php "/php/php.exe"#php脚本说明结束# redirect允许告诉客户端服务器上曾经有的文档，但是现在不存在了。#并且可以告诉客户端到哪儿去寻找。# 格式：redirect old-url new-url#控制服务器目录列表显示的标识#<ifmodule mod_autoindex.c># fancyindexing标识是使用特定的目录检索还是标准的(standard )indexoptions fancyindexing# addicon*表明不同文

36、件或扩展名显示的图标。#这些图标只在特定检索状态下显示。#addle on byencodi ng (cmp/c on s/compressed.gif) x-compress x-gzipaddlconbytype (txt,/icons/text.gif) text/*addlconbytype (img/icons/image2.gif) image/*addlconbytype (snd/cons/sound2.gif) audio/*addlconbytype (vidyicons/movie.gif) video/*addle on /icons/bi nary.g 讦.bin .

37、exeaddicon /icons/binhex.g讦.hqxaddle on /icon s/tar.gif .taraddle on /icon s/world2.gif .wrl .wrl.gz .vrml .vrm .ivaddle on /icon s/compressed.gif ,z .z tgz .gz 力 paddle on /icon s/a.gif .ps .ai .epsaddle on /icon s/layout.g 讦.html . shtml htm .pdfaddicon /icons/text.g讦txtaddicon /icons/c.g讦.caddle

38、on /icon s/p.gif .pl .pyaddicon /icons/f.gif .foraddicon /icons/dvi.gif .dviaddle on /icon s/uue ncoded.gif .uuaddicon /icons/script.g讦.conf .sh shar .csh .ksh .teladdicon /icons/tex.gif .texaddicon /icons/bomb.gif coreaddle on /icon s/back.gif .addle on /icon s/ha nd.right.gif readmeaddicon /icons/

39、folder.gif aadirectoryaaaddle on /icon s/bla nk.gif ablankicon 人人# defaulticon用于为制定图标的文件所显示的图标。#defa ul tic on /icons/ un know n.gif# adddescription在服务器生成的检索的某个文件后追加小段说明。#此项只在设置为fancylndexed时有效#格式：adddescription "描述”文件名#adddescription hgzip compressed document11 .gz#adddescription htar archive1

40、' .tar#adddescription hgzip compressed tar archive1' .tgz# readmename是服务器默认的readme文件。#并且会追加到目录列表的最后。# headername是目录中需要预先显不内容的文件名。#如果multiviews在选项中，作为结果,服务器将先找name.html ,#如果存在就包含它。如果name.html不存在,#服务器会继续寻找name.txt如果存在就作为纯文本包含进来。#readmename readmeheadername header# indexlgnore是一系列的文件名。目录索弓將忽略这些

41、文件并且不包含在列表中。#允许使用通配符。#indexlgnore .?*# header* readme* rcs cvs *,v *,t</ifmodule># indexing标识结束#文件类型<ifmodule mod_mime.c># addencoding可用于特殊浏览器(mosaic/x 2.1+)快速传输压缩信息。#注：并不是所有的服务器都支持。#除了名字相似，以下add*标识对上面的fancyindexing定制标识无影响。#addencoding x-compress zaddencoding xgzip gz tgz# addlanguage用于指

42、定文档的语言。#可以使用content标签指定每个文件的语言。#注1:后缀不必与所用语言的关键字相同。# 一波兰语(polish ,标准代码为pl)的文档可以用# "addlanguage pl .po"来避免与perl脚本文件混淆。#注2:以下例子表明两个字母的语言缩写和两个字母的国家缩写并不一定相同。# e.g. 'danmark/dk'对比'danish/da'.#注3:其中'itz使用了三个字符,与rfc的规走不同。#但是这个问题正在修订中,并且重新清理rfc1766#03mdanish (da) allkdutch (rd)

43、 eng-ish (en) jfflljgse estonian (ee)#whfench (fr) mln german (de) jrhda)(w>4greekmodem (e-)# 郦汁型 ita-ian (it) *s!kkorean (kr) norwegian (no)#aalportuguese (p( 丁 n®luxembourgeois* (-tz)#hssspanish (es) albswedish (sv) 莒wvibsnhecata-an (ca) imczech(cz)# 蒲冰 po-ish (pd rahbrazi-ian portuguese (

44、ptbr) japanese oa)#brussian (nj)#addlanguage da .dkaddlanguage rd n- addlanguage en en addlanguage et ee addlanguage fr fr addlanguage de de addlanguage e-e- addlanguage he headdcharset is018859oos0885900addlanguage if 片addlanguage ja jaaddcharset iso2022jp .jisaddlanguage kr kraddcharset iso-2022-k

45、r .iso-kraddlanguage no .noaddlanguage pl .poaddcharset iso-8859-2 .iso-pladdlanguage pt .ptaddlanguage pt-br ptbraddlanguage itzuaddlanguage ca .caaddlanguage es .esaddlanguage sv .seaddlanguage cz .czaddlanguage ru .ruaddlanguage tw twaddcharset big5 .big5 .big5addcharset windows-1251 .cp-1251addc

46、harset cp866.cp866addcharset iso-8859-5 .iso-ruaddcharset koi8-r.koi8-raddcharset ucs-2.ucs2addcharset ucs-4.ucs4addcharset utf-8.utf8# languagepriority可设置语言的优先级。#优先级降序排列#在此处按照字母顺序,可自行修改#<ifmodule mod_negotiation.c>languagepriority en da nl et fr de el it ja kr no pl pt ptbr ru itz ca es sv tw

47、</ifmodule># addtype可临时改变mime.types或者指定特殊文件的格式。#例如：php 3.x模块（非apache标准配件，参见）可用下面格式定 义：#addtype application/xhttpdphp3 .php3#addtype application/xhttpdphp3-source .phps# php 4.x,使用：#addtype application/xhttpdphp .php#addtype application/x-httpd-php-source .phpsaddtype application/x-tar .tgz# ad

48、dhandler可将特定文件扩展名映射到处理方法上。#与文件类型无关。此特性可内建到服务器中或者追加在操作指令中（见下）#如果希望用服务器端应用或scriptaliased外的cgi,取消以下行的注释符#用cgi脚本：#addhandler cgi-script .cgi#用服务器解析的html文档#addtype text/html .shtml#addhandler server-parsed .shtml#取消以下注释符可激活apache的send-asis http file特性#addhandler send-as-is asis#如果使用服务器端解析的图像定位文件，使用以下标识：#

49、addhandler imap-file map#要激活type maps使用：#add handler typemap var</ifmodule>#文档类型说明结束# action定义在文件匹配时执行相应的脚本。#可简化常用cgi文件的调用。# 格式：action media/type /cgi-script/location# 格式：action handlerame /cgi-script/location# metadir:指定保存meta信息文件的目录。#这些文件包含附加的http头，在发送文档是一并发送。#metadir .web# metasuffix:指定包含me

50、ta信息的文件的后缀。#metasuffix .meta#可定制的错误响应（apache类型）#共三种风格：# 1）纯文本#errordocument 500 nthe server made a boo boo.#注：第一个”号用于表示是文本，实际不输出# 2）本地重定向#errordocument 404 /missing.html# to redirect to local url /missing.html#errordocume nt 404 /cgi-bin/missing_handler.pl#注：可重定向到任何一个服务器端的脚本或文档# 3）外部重定向#errordocumen

51、t 402 http:/some.other_#注：大部分与初始请求关联的环境变量对这样的脚本无效。#基于浏览器的定制操作<ifmodule mod setenvif.o#以下标识修改普通的http响应操作。#第一个标识针对netscape2.x和其他无此功能的浏览器取消保持激活状态的功能#这些浏览器在执行这些功能时会出错。#第二个标识针对ie4.0b2设置。其中有一条不完整的http/1.1指令#在301或302 （重定向）响应时不能正确的保持激活状态#browsermatch "mozilla/2" nokeepalivebrowsermatch "ms

52、ie 4.0b2;" nokeepalive downgrade1.0 force-response-1.0#下面的标识通过不产生基本的1.1响应取消对违反http/1.0标准的浏览器的响应。#browsermatch "realplayer 4.0" force-response-1.0browsermatch "java/1.0" forceresponse1.0browsermatch njdk/1.0" force-response-1.0</ifmodule>#浏览器定制标识结束#允许使用url"http:/servername/server查看服务器状态报告#修改your_"来匹配相应的域名以激活此功能