阿帕奇 HTTP 服务器参考手册

1、原始文件：manual.ps.gz文件叙述：阿帕奇 http 服务器参考手册文件编号：lrg.ldtp.guide.002翻译日期：1996/09/01翻译维护：简体中文版维护:dfbb, apachean http serverreference manual david robinson and the apache group, 1995/保留所有权利。这个产品或文件受版权保护并且得在限制其用途，复制，散播以及编辑的授权下散播。细节请参阅阿帕奇授权书。版权所有者不对这

2、份手册的内容作任何保证及建议而且特别声明不保证符合任何商业目的。版权所有者保留修订这份手册的权利且其内容得依时变更而不必通知任何人这些修订与变更。all rights reserved. this product or documentation protected bycopyright and is distributed under licences restricting itsuse,copying,distribution and decompilation. see the apache licencefor details.the copyright owner gives n

3、o warranties and makes no representationsabout the contents of this manual and specifically disclaimswarranties of merchantability of fitness for any purpose.the copyright owner reserves the right to revise this manual andmake changes from time to time in its contents without notifying anyperson of

4、such revision or changes.trademarksunix is a registered trademark of unix system laboratories, inc.sun and sunos are trademarks of sun microsystems, inc. netscape is atrademark of netscape communications corporation. all other productnames mentioned herein are trademarks of their respective owners.目

5、录(contents) （略）序(preface)这份手册是 1.0 版阿帕奇服务器(apache http server)的文件。这个服务器是阿帕奇计划的产品，此计划试图回应某些对积极发展一套可以免费取得之 http 服务器的关心。这个计划的目标是提供一个安全的，有效率的而且可以扩充功能的服务器，此服务器提供 http 服务且符合目前的 http 标准。这套阿帕奇 httpd 服务器的设计不但与 ncsa httpd 1.3 相容，并且提供常常有人要求的特色，像是。作为身分验认之用的 dbm 资料库。自定的(customised)错误与问题回应方式。多重的 directoryindex 指令

6、。不限次数的 alias 以及 redirect 指令。以内容为基础的(content-based) 文件协商(negotiation)。虚拟服务器阿帕奇授权书copyright 1995 the apache group. all rights reserved.假若符合下列条件，无论是否经过修改，以原始程序及执行程序的形式散播与使用都是许可的:1. 散播原始程序码必须保留上述的版权告示，这份条件列表以及下列声明。2. 以执行程序码的形式散播必须在随附散播的文件以及或是资讯中重现上述的版权告示，这份条件列表以及下列声明。3. 所有提及或使用这套软体特色的广告都必须显示下列讯息:this pr

7、oduct includes software developed by the apache groupfor use in the apache http server project (/).4. apache server 以及 apache group 这些名称没有随附前述的的许可不得用来为这套软体的衍生产品背书或鼓励采用。5. 以任何形式散播都必须保留下列讯息:this product includes software developed by the apache groupfor use in the apache http serve

8、r project (/).redistribution and use in source and binary forms, with or withoutmodification, are permitted provided that the following condictionsare met:1. redistribution of source code must retain the above copyrightnotice, this list of condictions and the following disclaimer

9、.2. redistribution in binary form must reproduce the above copyrightnotice, this list of condictions and the following disclaimer inthe documentation and/or other materials provided with thedistribution.3. all advertising materials mentioning features or use of thissoftware must display the followin

10、g acknowledge: this productincludes software developed by the apache group for use in theapache http server project (/).4. the names apache server and apache group must not be used toendorse or prompt products derived from this software withoutprior written permission.5. redistri

11、bution of any form whatsoever must retain the followingacknowledge: this product includes software developed by theapache group for use in the apache http server project(/).this software is provided by the apache group as is and anyexpressed or implied warranties, including, but

12、not limited to, theimplied warranties of merchantability and fitness for a pariticularpurpose are disclaimed. in no event shall the apache group or itscontributors be liable for any direct,indirect, incidetal, special,exemplary or consequential damages (including,but not limited to,procurement of su

13、bstitute goods or services;loss of use, data orprofits; or business interruption) however caused and on any theoryof liability, wherher in contract, strict liability, or tort(including negligence or other wise)arising in any way out of the useof this software, even if advised of the possibility of s

14、uch damage.this software consists of voluntary contributions made by manyindividuals on behalf of the apache group and was originallybased on public domain software written at the national centerfor supercomputing applications, university of illinois, urbana-champaign. for more information on the ap

15、ache group and the apachehttp server project, please see /.第一章编译以及安装阿帕奇1.1 下载阿帕奇最新的阿帕奇资讯可以在阿帕奇网站 / 找到。此处会列出目前发行的版本，任何更新的公开测试版，同时还有映射的(mirror)网站与匿名文件传输(ftp) 站之细节。1.2 编译阿帕奇这一版的阿帕奇支援所谓的选用性模组。然而，为了使这些模组能有效率，此服务器必须知道哪些模组要编译进去；这需要产生一点短短的程序码(modules.c) 单纯地列出它们。如果你满意我

16、们的标准模组集，而且打算继续让它保持这样，那麽你可以直接编辑我们提供的 makefile 并且如同你以前作过的一样编译它。如果你想要使用选用性模组，那麽无论如何，你都得执行配置指令稿。这样做:1. 编辑 configuration 这个文件。这里面包含每一种机器的 makefile 设定，而且在这底下还有个额外的节区列出要编译进去的模组，以及包含这些模组的文件名称，你将得:(a) 选择适合你机器的一种编译器以及编译选项。(b) 消掉相对於你想包含进去的模组上面的注解（文件底端列出模组的那些行）或者加上对应你自己所撰写之自制(custom)模组的一些新行。注意，如果你想要有dbm 验认(auth

17、)的话必须明确地配置进去；只要消掉对应的行上面的注解即可。2. 执行 configure 这个指令shell;% configureusing configuration as config file%这会产生新版的 makefile 以及 modules.c 文件。如果你想要维护多个配置，那麽你可以这样，例如% configure -file configuration.aiusing alternate config file configuration.ai%3. 键入 make我们放进阿帕奇发行套件里的模组是我们测试过而且有许多阿帕奇发展群成员使用的模组。这些成员或协力团体(third

18、parties)配合特殊需要或功能而贡献的一些额外模组可以在 里找到。在该网页上有如何连结这些模组到阿帕奇核心程序码里去的说明。1.3 安装阿帕奇编译之後，你将会在 src/ 目录里获得一份称为 httpd 的可执行文件。阿帕奇的可执行文件发行套件会提供这个文件。下一个步骤是为服务器编辑配置档。你应该会在称为 conf 的目录里发现三个配置档的发行版本: srm.conf-dist, access.conf-dist 以及httpd.conf-dist 。把它们复制成所需的 srm.conf, access.conf 及httpd.conf 文件。首先编辑 httpd.conf 。这设定此服务

19、器一般的属性；端口号，执行者的身分等等。接下来编辑 srm.conf 文件；这设定文件树的根目录，指定像是服务端剖析的 html 或内部的影像地图(imagemap)剖析等等功能。最後编辑 access.conf 文件，至少作些存取(access)的基本设定。最後，调用httpd 程序，使用 -f 参数配合 httpd.conf 所在的完整路径。像是，最普遍的例子:/usr/local/etc/apache/src/httpd -f/usr/local/etc/apache/conf/httpd.conf现在服务器应该已经开始执行。依照预设 srm.conf 以及 access.conf 这些

20、文件是藉由名称定位的；要藉由其它的名称来指定调用它们的话，可以在 httpd.conf 里面使用accessconfig 以及 resourceconfig 指令。第二章启动阿帕奇2.1 启动阿帕奇httpd 这支程序可以藉由网际网路服务程序 inetd 在每一次有连线要进入 http 服务的时候启动，或者另一种方式，它也可以作为服务程序(daemon)持续地执行，处理请求。无论选择哪一种方式，都必须设定这个 servertype 指令告诉服务器它要如何执行。2.2 命令列选项下列选项可以用在 httpd 的命令列上:- d serverroot把 serverroot 这个参数的起始值设定为

21、 serverroot 。这可以藉由在配置文件里面的 serverroot 命令来加以改变。此预设为/usr/local/etc/httpd 。- f config启动时执行在 config 文件里面的指令。如果 config 没有以 /作为开始的话，那麽它会被当作相对於 serverroot 的路径。此预设值是 conf/httpd.conf 。- x以单一程序(single-process)模式执行，只用在内部除错；服务程序不会脱离终端作业或是产生任何子程序。不要使用这个模式来提供正常的网页服务。- v列印 httpd 的版本，然後结束。-?列印 httpd 选项的一份列表，然後结束。2.

22、3 配置档此服务器将会读取三个配置指令文件。任何指令都可以出现在这些文件任何一个里面。这些文件的名称是相对於服务器的根目录(server root) ；这是根是藉由 serverroot 指令，或是 -d 这个命令列旗标所指定的。依惯例这些文件是:conf/httpd.conf包含控制服务程序运作的指令。文件名称可以配合 -f 命令列旗旗标加以改变。conf/srm.conf包含控制服务器提供给客户端之文件规格的指令。文件名称可以配合 resourceconfig 指令加以改变。conf/access.conf包含控制文件之存取的指令。文件名称可以配合 accessconfig指令加以改变。无

23、论如何，这些惯例并不需要完全遵奉。此服务器也会读取一个包含 mime 文件型态的文件；这个文件名称藉由typesconfig 指令设定，而且有个 conf/mini.types 作为预设。2.4 记录档2.4.1 pid 档服务程序启动时，它把父程序 httpd 的程序码(process id)存往这个log/httpd.pid 文件。这个文件名称可以配合 pidfile 指令加以改变。这个程序码由管理者用来重新启动或终止服务程序；一个 hup 信号会使服务程序重新读取其配置档而一个 term 信号会使它终止。如果程序不正常地死掉（或被杀掉），那麽必须杀掉 httpd 子程序。2.4.2 错误

24、记录服务器会将错误讯息记录到一个记录档去，预设为 log/error_log 。文件名称可以藉由 errorlog 指令设定；可以为不同的虚拟主机设定不同的错误记录。2.4.3 传输记录服务器一般会将每个请求记录到一个传输档，预设为 logs/access_log。文件名称可以藉由 transferlog 指令设定；可以为不同的虚拟主机设定不同的传输记录。第三章阿帕奇核心部份(core)的特色这些配置参数控制核心部份的阿帕奇特色，而且是固定可以使用的。3.1 accessconfig 指令语法: accessconfig 文件名称预设: accessconfig conf/access.con

25、f用於: server config, virtual host状态: 核心此服务器读取 resourceconfig 文件之後将会继续读取这个文件以取得更多指令。文件名称系相对於 serverroot 路径。此特色可以使用如下的方式关闭:accessconfig /dev/null原本这个文件只包含 节区；事实上它现在可以包含任何可以用於服务器配置的指令。3.2 accessfilename 指令语法: accessfilename 文件名称预设: accessfilename .htaccess用於: server config, virtual host状态: 核心回传文件给客户端的时候

26、，如果目录的存取控制档有启动，服务器会在到达这份文件的路径中的每个目录里以此名称搜寻存取控制档。例如:accessfilename .acl在回传 /usr/local/web/index.html 这份文件前，此服务器将会读取/.acl, /usr/.acl, /usr/local/.acl 以及 /usr/local/web/.acl 以取得指令，除非以如下的方式关闭它们:allowoverride none3.3 allowoverride 指令语法: allowoverride override override .预设: allowoverride all用於: directory状

27、态: 核心服务器找到 accessfilename 指定的文件时会需要知道该文件所宣告的哪些指令可以改变稍早的存取资讯。override 可以设为 none 在此情况下服务器将不会读取该档，而设为all 的话服务器将会允许所有的指令，或是下列其中之一:authconfig允许验认指令的使用(authdbmgroupfile, authdbmuserfile,authgroupfile, authname, authtype, authuserfile andrequire)fileinfo允许控制文件型态之指令的使用(addencoding, addlanguage,addtype, defa

28、ulttype and languagepriority)indexes允许控制目录索引之指令的使用(adddescription, addicon,addiconbyencoding, addiconbytype, defaulticon,directoryindex, fancyindexing, headername, indexignore,indexoptions and readmename)limit允许控制存取主机之指令的使用(allow, deny and order)options允许控制特定目录特色之指令的使用(options and xbithack)3.4 authn

29、ame 指令语法: authname 验认领域用於: directory, .htaccess需求: authconfig状态: 核心这个指令为某个目录设定验认区域的名称。这个区域会送给客户端所以使用者知道要传送的使用者名称以及密码。它必须藉由 authtype 以及require 指令来完成，而且要有像 authuserfile 以及 authgroupfile这些指令配合运作。3.5 authtype 指令语法: authtype 型态用於: directory, .htaccess需求: authconfig状态: 核心这个指令为某个目录选择使用这验认型态。目前只有 basic 实作出来

30、。它必须藉由 authname 以及 require 指令来完成，而且还要有像是authuserfile 以及 authgroupfile 这些指令配合运作。3.6 bindaddress 指令语法: bindaddress 服务器位址预设: bindaddress *用於: server config状态: 核心一台 unix 的 http 服务器可以监听到该服务机器每个 ip 位址的连线或者只注意该服务机器的一个位址。服务器位址可以是:。*。一个 ip 位址。一个完整的网际网路领域名称如果此值是 * 的话，那麽该服务器将会监听每一个 ip 位址的连线，否则它将只监听指定的 ip 位址。这个

31、选项可以用来作为另一种支援虚拟主机的方式取代 节段。3.7 defaulttype 指令语法: defaulttype mime-型态预设: defaulttype text/html用於: server config, virtual host, directory, .htacess需求: fileinfo状态: 核心有些时候服务器会被要求提供某份文件，此文件不能藉由其 mime 型态对映来决定型态。服务器必须知会客户端文件所包含的型态(content-type)，所以不知道型态的时候它便使用 defaulttype 。例如:defaulttype image/gif对於包含许多没有 .g

32、if 副文件名的 gif 图形目录是合适的。3.8 指令语法: . 用於: server config, virtual host状态: 核心 以及 用来把一组指令包装起来，这些指令将只应用到所指明的目录及其子目录上。任何可以用於 directory 的指令都可以使用。directory 是到某目录的完整路径，或是替代字元串(widecard string) 。在替代字元串中 ? 能够符合任何单一字元，而 * 能够符合任何顺序的一些字元。例如:option indexes followsymlinks如果有多个 directory 节区能符合包含该文件的目录（或其父目录），那麽分布在 .hta

33、ccess 文件里的指令是以最短先符合的顺序加以应用的，例如:allowoverride noneallowoverride fileinfo存取 /home/web/dir/doc.html 这份文件的步骤是:。应用 allowoverride none 指令（关掉 .htaccess 文件）。应用 allowoverride fileinfo 指令（目录 /home/web ）。应用任何在 /home/web/.htaccess 里面的 fileinfo 指令。这个 directory 节段典型是用在 access.conf 文件里，但它们可以出现在任何配置档里。 指令不能巢状使用，而且不

34、能出现在 节段里。3.9 documentroot 指令语法: documentroot 目录名称预设: documentroot /usr/local/etc/httpd/htdocs用於: server config, virtual host状态: 核心这个指令设定 httpd 从这个目录提供文件服务。除非符合像是 alias这样的指令，服务器把所要求的 url 附加到文件根 (document root)来组合到达文件的路径。例如:documentroot /usr/web如此对於 /index.html 文件的存取便会参照到 /usr/web

35、/index.html 。3.10 errordocument 指令语法: errordocument 错误代码 文件用於: server config, virtual host状态: 核心有问题或错误发生的状况下，可以配置阿帕奇做四种反应1. 如同 ncsa httpd 1.3 的反应2. 输出自定的(customized)讯息3. 重导到某个本地的 url 以处理该问题错误4. 重导到某个外部的 url 以处理该问题错误2-4 是使用 errordocument 来配置，其後跟随 http 反应码以及讯息或是 url 。errordocument 500 /cgi-bin/testere

36、rrordocument 404 /cgi-bin/bad_urls.plerrordocument 401 http:/www.foo.bar/subscription_info.htmlerrordocument 403 sorry cant allow you acess today参阅: 自定回应的文件。3.11 errorlog 指令语法: errorlog 文件名称预设: errorlog logs/error_log用於: server config, virtual host状态: 核心这个错误记录指令设定文件名称，服务器将会把其遭遇的每个错误记录到这个文件去。如果文件名称不是

37、以 / 开始的话那麽它就会被假设为相对於 serverroot 的路径。例如:errorlog /dev/null这会有效地关掉错误记录。3.12 group 指令语法: group unix-群组预设: group #-1用於: server config状态: 核心这个 group 指令设定服务器回答要求时所处的群组。为了要能够使用这个指令，必须以 root 身分起始执行独立的服务器。 unix-群组可以是这些其中之一:群组的名称藉由名称参照所给的群组。# 跟随著群组号码藉由号码参照某个群组。建议你特别设立一个群组来执行这个服务器。某些管理者使用 nobody这个使用者，但是这并非永远可行

38、或合适的。注意: 如果你以非 root 使用者的身分启动这个服务器，它将无法切换到指定的群组，并且取而代之的是它将会继续以原来的使用者所属群组来执行。安全: 参阅 user 指令对安全情况的讨论。3.13 identitycheck 指令语法: identifycheck 布林值预设: identifycheck off用於: server config状态: 核心这个指令为每次的连线起始 rfc931-相容的远端使用者名称记录，其中客户端需得执行 identd 或者是类似的东西。这项资讯记录在存取记录(access log)里。布林值是 on 或者 off 。除非是作为基本的使用量追踪，这项

39、资讯无论如何不能真的信赖。3.14 指令语法: . 用於: 任何地方状态: 核心 以及 用来把一组存取控制指令包装起来，这些指令将只应用到指定的存取方式上，其中的方式是指任何有效的 http 方式(method)。除了 或是 之外的任何指令都可以使用；大部分都不会被 影响。例如:require valid-user如果有个存取控制指令出现在 指令之外，那麽它会被应用到所有的存取方式上。3.15 maxclient 指令语法: maxclients 数字预设: maxclients 150用於: server config状态: 核心这个 maxclients 指令设定所能支援的同时存取要求数目

40、；不会建立比此值还多的子程序。3.16 maxrequestperchild 指令语法: maxrequestsperchild 数字预设: maxrequestsperchild 0用於: server config状态: 核心maxrequestsperchild 这个指令设定一个独立的子服务程序将能处理的请求数量。在处理 maxrequestsperchild 个请求之後，子程序将会被终止。如果 maxrequestsperchild 为 0 的话，那麽该程序永远不会被终止。maxrequestsperchild 设为非 0 的值做为限制有两个好处:。藉由记忆体使用量限制程序使用的记忆体

41、数量；。藉由赋予程序有限的存留时间，可以在服务器负载降低时协助减少程序的数目。3.17 maxspareservers 指令语法: maxspareservers 数字预设: maxspareservers 10用於: server config状态: 核心maxspareservers 这个指令设定最大闲置(idle)子服务程序数量。闲置子服务程序是目前没有处理要求的程序。如果有多於 maxspareservers的暂停程序，那麽父程序会终止超过此数量的子程序。只有在非常忙碌的站台上才有调整这个选项的需要。把这个参数设为非常大的数目通常总是个不好的主意。参阅 minspareservers

42、以及 startservers 。3.18 minspareservers 指令语法: minspareservers 数字预设: minspareservers 5用於: server config状态: 核心minspareservers 这个指令设定最大闲置(idle)子服务程序数量。闲置子服务程序是目前没有处理要求的程序。如果有属於 minspareservers的暂停程序，那麽父程序会以最高每秒一个的速率建立新的子程序。只有在非常忙碌的站台上才有调整这个选项的需要。把这个参数设为非常大的数目通常总是个不好的主意。参阅 maxspareservers 以及 startservers 。

43、3.19 options 指令语法: option 选项 选项 .用於: server config, virtual host, directory, .htaccess需求: options状态: 核心options 这个指令控制某个特定目录所能使用的服务器特色。选项可以设为 none 在此情况下没有额外的特色会起动，或者可以是下列的一个或几个:all除了 multiviews 以外的所有选项。execcgicgi 指令稿的执行权限。followsymlinks服务器将会跟照目录里的符号链结。includesnoexec服务端含入(server-side include) 的权限。inde

44、xes如果有个 url 对映到所要求的目录，而且目录里面并没有目录索引(directoryindex, e.g. index.html) 存在，那麽服务器将会传回这个目录格式化後的列表。multiviews允许 multiviews 内容协商。symlinksifownermatch只有在目标文件或目录与符号链结的拥有者相同时服务器才会去跟照符号链结。如果多个选项可以应用到某个目录上，那麽最底下的指定会完成；选项不会合并。例如:options indexes followsymlinksoption includes这样只有 includes 会设定到 /web/docs/spec 目录上。3

45、.20 pidfile 指令语法: pidfile 文件名称预设: pidfile logs/httpd.pid用於: server config状态: 核心pidfile 这个指令设定服务器记录服务程序的程序号码所使用的文件。如果文件名称不是以 / 开始那麽它会被假定是相对於 serverroot 的目录。这个 pidfile 只使用在独立(standalone)模式。能够送个信号给服务器通常会是有用的，可以关闭再重新打开错误记录与传输记录，以及重新读取配置档。这是藉由传送 sighup (kill -1)信号到列在 pidfile 里的程序号码来达成的。3.21 port 指令语法: po

46、rt 数字预设: port 80用於: server config状态: 核心这个 port 指令设定服务器监听的网路端口号。数字是 0 到 65535 的一个数目；某些端口号（特别是低於 1024 的）保留给特殊的协定。参阅/etc/services 里定义的一些端口的列表；标准 http 协定使用 80 端口。port 80 是 unixs 的一个特别端口。所有低於 1024 的端口号都是保留给系统使用的，例如，一般使用者(non-root)不能使用它们；取而代之的是他们可以使用较高的端口号。要使用 80 端口你必须以 root 帐号启动服务器。在连接到该端口後，接受请求之前，阿帕奇将会切

47、换为藉由 user 指令所设定权限较低的使用者身分。如果你不能使用 80 端口，选择任何其它没有使用到的端口。非 root 使用者必须选择高於 1023 的端口号，像是 8000 。安全: 如果你是以 root 启动服务器，确定不要把 user 设为 root 。如果你以 root 身分处理连线的话，你的站台可能会暴露在攻击下。3.22 require 指令语法: require 项目名称 项目 项目 .用於: directory, .htaccess需求: authconfig状态: 核心这个指令选择经过验认可以存取目录的使用者。允许使用的语法是:。require user 使用者辨识码 使

48、用者辨识码 .只有注明的使用者能存取该目录。require group 群组名称 群组名称 .只有在注明群组里的使用者能存取该目录。require valid-user所有合法的使用者都可以存取该目录。如果 require 出现在 节段里，那麽它会限制所注明的存取方式，否则它会限制所有的存取方式。例如:authtype basicauthname somedomainauthuserfile /web/usersauthgroupfile /web/grouplimit require group adminrequire 必须藉由 authname 以及 authtype 这些指令，以及配合

49、像是authuserfile 以及 authgroupfile 指令（用来定义使用者与群组）以便正确运作。3.23 resourceconfig 指令语法: resourceconfig 文件名称预设: resourceconfig conf/srm.conf用於: server config, virtual host状态: 核心此服务器读取 httpd.conf 文件之後将会继续读取这个文件以取得更多指令。文件名称系相对於 serverroot 路径。此特色可以使用如下的方式关闭:resourceconfig /dev/null原本这个文件包含大部分指令，除了服务器配置及 节区以外；事实上

50、它现在可以包含任何可以用於服务器配置的指令。3.24 serveradmin 指令语法: serveradmin 电子邮件地址用於: server config, virtual host状态: 核心serveradmin 设定电子邮件地址，服务器回传任何错误讯息给客户端时会包含这个地址。设定一个像这样的地址可能会有用，例如serveradmin 因为使用者并不会永远知道他们是跟在哪台服务器打交道!3.25 servername 指令语法: servername 完整的领域名称用於: server config, virtual host状态: 核心这个

51、 servername 指令设定服务器的主机名称；这只有在建立重导 url的时候使用。如果没有指定它，那麽服务器会试图从其 ip 位址来决定；然而这个方法可能不能信赖，或者无法回传适当的主机名称。例如:servername 如果正式(canonical) 名称是 它还能够使用上述的名称。3.26 serverroot 指令语法: serverroot 目录名称预设: serverroot /usr/local/etc/httpd用於: server config状态: 核心这个 serverroot 指令设定服务器所在的目录。它典型会包含有子目录conf/ 以及 logs/ 。其它配置档的相对路径是相对於这个路径。3.27 servertype 指令语法: servertype 型态预设: