阿帕奇HTTP服务器参考手册

1、WORD格式原始文件： manual.ps.gz文件表达：阿帕奇效劳器参考手册文件编号： LRG.LDTP.GUIDE.002翻译日期： 1996/09/01翻译维护： asdchen简体中文版维护:dfbb, fanghAPACHEAn ServerReference Manual David Robinson and the Apache Group, 1995 ://保存所有权利。这个产品或文件受保护并且得在限制其用途，复制，散播以及编辑的授权下散播。细节请参阅阿帕奇授权书。所有者不对这份手册的内容作任何保证及建议而且特别声明不保证符合任何商业目的。所有者保存修订这份

2、手册的权利且其内容得依时变更而不必通知任何人这些修订与变更。All rights reserved. This product or documentation protected by copyright and is distributed under licences restricting its use,copying,distribution and decompilation. See the Apache licence for details.The copyright owner gives no warranties and makes no representation

3、s about the contents of this manual and specifically disclaims warranties of merchantability of fitness for any purpose.The Copyright owner reserves the right to revise this manual and make changes from time to time in its contents without notifying any person of such revision or changes.专业资料整理WORD格

4、式TRADEMARKS专业资料整理WORD格式Unix is a registered trademark of UNIX System Laboratories, Inc.Sun and SunOs are trademarks of Sun Microsystems, Inc. Netscape is a trademark of Netscape Communications Corporation. All other product names mentioned herein are trademarks of their respective owners.目录 (Content

5、s)略序 (Preface)这份手册是 1.0 版阿帕奇效劳器 (Apache server) 的文件。这个效劳器是阿帕奇方案的产品，此方案试图回应某些对积极开展一套可以免费取得之效劳器的关心。这个方案的目标是提供一个平安的，有效率的而且可以扩大功能的效劳器，此效劳器提供效劳且符合目前的标准。这套阿帕奇d效劳器的设计不但与NCSA d 1.3相容，并且提供常常有人要求的特色，像是。作为身分验认之用的DBM资料库。自定的 (customised)错误与问题回应方式。多重的 directoryindex指令。不限次数的Alias以及 Redirect指令。以内容为根底的(Content-based

6、)文件协商 (negotiation)。虚拟效劳器阿帕奇授权书Copyright 1995 The Apache Group. All rights reserved.假假设符合以下条件，无论是否经过修改，以原始程序及执行程序的形式散播与使用都是许可的 :1. 散播原始程序码必须保存上述的告示，这份条件列表以及以下声明。专业资料整理WORD格式2. 以执行程序码的形式散播必须在随附散播的文件以及或是资讯中专业资料整理WORD格式重现上述的告示，这份条件列表以及以下声明。3.所有提及或使用这套软体特色的广告都必须显示以下讯息:This product includes software deve

7、loped by the Apache Groupfor use in the Apache server project (://).'4. Apache Server'以及 Apache Group'这些名称没有随附前述的的许可不得用来为这套软体的衍生产品背书或鼓励采用。5.以任何形式散播都必须保存以下讯息:This product includes software developed by the Apache Group for use in the Apache server project (://).'Re

8、distribution and use in source and binary forms, with or without modification, are permitted provided that the following condictions are met:1. Redistribution of source code must retain the above copyright notice, this list of condictions and the following disclaimer.2. Redistribution in binary form

9、 must reproduce the above copyright notice, this list of condictions and the following disclaimer inthe documentation and/or other materials provided with the distribution.3. All advertising materials mentioning features or use of this software must display the following acknowledge: This productinc

10、ludes software developed by the Apache Group for use in the Apache server project (://).'4. The names Apache Server' and Apache Group' must not be used to endorse or prompt products derived from this software without prior written permission.5. Redistribution of any form whatso

11、ever must retain the following acknowledge: This product includes software developed by the Apache Group for use in the Apache server project (://).'THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

12、 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARITICULAR专业资料整理WORD格式PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE GROUP OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDETAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,BUT NOT LIMITED TO, PROCUREMENT OF SUBST

13、ITUTE GOODS OR SERVICES;LOSS OF USE, DATA OR PROFITS; 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 USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF S

14、UCH DAMAGE.This software consists of voluntary contributions made by many individuals on behalf of the Apache Group and was originally based on public domain software written at the National Center for Supercomputing Applications, University of Illinois, Urbana-Champaign. For more information on the

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

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

17、你想要有DBM验认 (auth) 的话必须明确地配置进去；只要消掉对应的行上面的注解即可。2.执行 Configure'这个指令 shell;% ConfigureUsing Configuration' as config file%这会产生新版的 Makefile 以及 modules.c 文件。如果你想要维护多个配置，那麽你可以这样，例如% Configure -file Configuration.aiUsing alternate config file Configuration.ai%3. 键入 make'我们放进阿帕奇发行套件里的模组是我们测试过而且有许

18、多阿帕奇开展群成员使用的模组。这些成员或协力团体(thirdparties)配合特殊需要或功能而奉献的一些额外模组可以在<URL://dist/contrib/modules/>里找到。在该网页上有如何连结这些模组到阿帕奇核心程序码里去的说明。1.3安装阿帕奇专业资料整理WORD格式编译之後，你将会在src/目录里获得一份称为d'的可执行文件。专业资料整理WORD格式阿帕奇的可执行文件发行套件会提供这个文件。专业资料整理WORD格式下一个步骤是为效劳器编辑配置档。你应该会在称为conf'发现三个配置档的发行版本: srm.conf-dist, a

19、ccess.conf-distd.conf-dist。把它们复制成所需的srm.conf, access.confd.conf文件。的目录里以及及专业资料整理WORD格式首先编辑d.conf 身分等等。接下来编辑。这设定此效劳器一般的属性；端口号，执行者的srm.conf文件；这设定文件树的根目录，指定像是专业资料整理WORD格式效劳端剖析的HTML 或内部的影像地图(imagemap) 剖析等等功能。最後编辑 access.conf文件，至少作些存取(access) 的根本设定。最後，调用d程序，使用-f参数配合d.conf所在的完整路径。像是，最普遍的例子:/usr/local/etc/a

20、pache/src/d -f/usr/local/etc/apache/conf/d.conf现在效劳器应该已经开场执行。依照预设srm.conf以及 access.conf这些文件是藉由名称定位的；要藉由其它的名称来指定调用它们的话，可以在d.conf里面使用AccessConfig以及 ResourceConfig指令。第二章启动阿帕奇2.1启动阿帕奇d这支程序可以藉由网际网路效劳程序inetd在每一次有连线要进入效劳的时候启动，或者另一种方式，它也可以作为效劳程序(daemon)持续地执行，处理请求。无论选择哪一种方式，都必须设定这个 ServerType 指令告诉效劳器它要如何执行。2

21、.2命令列选项以下选项可以用在d的命令列上 :-d serverroot把 ServerRoot这个参数的起始值设定为serverroot。这可以藉由在配置文件里面的ServerRoot命令来加以改变。此预设为/usr/local/etc/d。-f config启动时执行在config文件里面的指令。如果config没有以 /作为开场的话，那麽它会被当作相对於ServerRoot的路径。此预设值是 conf/d.conf。专业资料整理WORD格式-X专业资料整理WORD格式以单一程序 (single-process) 模式执行，只用在内部除错；效劳程序不会脱离终端作业或是产生任何子程序。不要使

22、用这个模式来提供正常的网页效劳。-v列印d的版本，然後完毕。-"列印d选项的一份列表，然後完毕。2.3配置档专业资料整理WORD格式此效劳器将会读取三个配置指令文件。任何指令都可以出现在这些文件任何一个里面。这些文件的名称是相对於效劳器的根目录(server root)；专业资料整理WORD格式这是根是藉由ServerRoot指令，或是-d这个命令列旗标所指定的。依惯例这些文件是:conf/d.conf专业资料整理WORD格式包含控制效劳程序运作的指令。文件名称可以配合-f命令列旗专业资料整理WORD格式旗标加以改变。专业资料整理WORD格式conf/srm.conf包含控制效劳器提

23、供给客户端之文件规格的指令。文件名称可以配合 ResourceConfig 指令加以改变。conf/access.conf专业资料整理WORD格式包含控制文件之存取的指令。文件名称可以配合指令加以改变。AccessConfig专业资料整理WORD格式无论如何，这些惯例并不需要完全遵奉。专业资料整理WORD格式此效劳器也会读取一个包含MIMETypesConfig指令设定，而且有个文件型态的文件；这个文件名称藉由conf/mini.types作为预设。专业资料整理WORD格式2.4记录档专业资料整理WORD格式2.4.1pid档专业资料整理WORD格式效劳程序启动时，它把父程序d的程序码 (pr

24、ocess id)存往这个log/d.pid文件。这个文件名称可以配合PidFile指令加以改变专业资料整理WORD格式。这个程序码由管理者用来重新启动或终止效劳程序；一个 HUP 会使效劳程序重新读取其配置档而一个 TERM 信号会使它终止。信号专业资料整理WORD格式如果程序不正常地死掉或被杀掉，那麽必须杀掉d子程序。专业资料整理WORD格式2.4.2错误记录专业资料整理WORD格式效劳器会将错误讯息记录到一个记录档去，预设为log/error_log文件名称可以藉由ErrorLog指令设定；可以为不同的虚拟主机设定不同的错误记录。专业资料整理WORD格式2.4.3传输记录效劳器一般会将每

25、个请求记录到一个传输档，预设为logs/access_log专业资料整理WORD格式。文件名称可以藉由 TransferLog 指令设定；可以为不同的虚拟主机设定不同的传输记录。第三章阿帕奇核心部份(core)的特色这些配置参数控制核心部份的阿帕奇特色，而且是固定可以使用的。专业资料整理WORD格式3.1AccessConfig指令专业资料整理WORD格式语法: AccessConfig文件名称专业资料整理WORD格式预设: AccessConfig conf/access.conf专业资料整理WORD格式用於: server config, virtual host专业资料整理WORD格式状

26、态:核心专业资料整理WORD格式此效劳器读取ResourceConfig更多指令。文件名称系相对於的方式关闭 :文件之後将会继续读取这个文件以取得ServerRoot路径。此特色可以使用如下专业资料整理WORD格式AccessConfig /dev/null专业资料整理WORD格式原本这个文件只包含 <Directory> 可以用於效劳器配置的指令。节区；事实上它现在可以包含任何专业资料整理WORD格式3.2AccessFileName指令专业资料整理WORD格式语法: AccessFileName文件名称专业资料整理WORD格式预设 : AccessFileName .htacc

27、ess用於 : server config, virtual host状态:核心专业资料整理WORD格式回传文件给客户端的时候，如果目录的存取控制档有启动，效劳器会在到达这份文件的路径中的每个目录里以此名称搜寻存取控制档。例如:专业资料整理WORD格式AccessFileName .acl专业资料整理WORD格式在回传 /usr/local/web/index.html/.acl, /usr/.acl, /usr/local/.acl这份文件前，此效劳器将会读取以及 /usr/local/web/.acl以专业资料整理WORD格式取得指令，除非以如下的方式关闭它们:专业资料整理WORD格式&l

28、t;Directory />AllowOverride None</Directory>3.3AllowOverride指令语法 : AllowOverride override override .预设 : AllowOverride All用於 : directory状态:核心效劳器找到 AccessFileName 指定的文件时会需要知道该文件所宣告的哪些指令可以改变稍早的存取资讯。Override可以设为None 在此情况下效劳器将不会读取该档，而设为All的话效劳器将会允许所有的指令，或是以下其中之一:AuthConfig允许验认指令的使用 (AuthDBMGrou

29、pFile, AuthDBMUserFile, AuthGroupFile, AuthName, AuthType, AuthUserFile and require)FileInfo允许控制文件型态之指令的使用 (AddEncoding, AddLanguage, AddType, DefaultType and LanguagePriority)专业资料整理WORD格式Indexes允许控制目录索引之指令的使用 (AddDescription, AddIcon, AddIconByEncoding, AddIconByType, DefaultIcon, DirectoryIndex, F

30、ancyIndexing, HeaderName, IndexIgnore, IndexOptions and ReadmeName)Limit允许控制存取主机之指令的使用(allow, deny and order)Options允许控制特定目录特色之指令的使用(Options and XbitHack)专业资料整理WORD格式3.4AuthName指令专业资料整理WORD格式语法: AuthName验认领域专业资料整理WORD格式用於: directory, .htaccess专业资料整理WORD格式需求: AuthConfig专业资料整理WORD格式状态:核心专业资料整理WORD格式这个

31、指令为某个目录设定验认区域的名称。这个区域会送给客户端所以使用者知道要传送的使用者名称以及密码。它必须藉由AuthType以及require指令来完成，而且要有像AuthUserFile以及 AuthGroupFile专业资料整理WORD格式这些指令配合运作。专业资料整理WORD格式3.5AuthType指令专业资料整理WORD格式语法: AuthType型态专业资料整理WORD格式用於: directory, .htaccess专业资料整理WORD格式需求: AuthConfig专业资料整理WORD格式状态:核心专业资料整理WORD格式这个指令为某个目录选择使用这验认型态。目前只有Basic

32、实作出来。它必须藉由AuthName 以及 require指令来完成，而且还要有像是AuthUserFile以及 AuthGroupFile这些指令配合运作。专业资料整理WORD格式3.6BindAddress指令语法 : BindAddress效劳器位址预设 : BindAddress *用於 : server config状态:核心专业资料整理WORD格式一台 Unix的 效劳器可以监听到该效劳机器每个IP位址的连线专业资料整理WORD格式或者只注意该效劳机器的一个位址。效劳器位址可以是:专业资料整理WORD格式。 *。一个 IP位址。一个完整的网际网路领域名称专业资料整理WORD格式如果

33、此值是 * 的话，那麽该效劳器将会监听每一个否那么它将只监听指定的 IP 位址。IP位址的连线，专业资料整理WORD格式这个选项可以用来作为另一种支援虚拟主机的方式取代节段。<VirtualHost>专业资料整理WORD格式3.7DefaultType指令专业资料整理WORD格式语法: DefaultType mime-型态专业资料整理WORD格式预设: DefaultType text/html专业资料整理WORD格式用於: server config, virtual host, directory, .htacess专业资料整理WORD格式需求: FileInfo专业资料整理

34、WORD格式状态:核心专业资料整理WORD格式有些时候效劳器会被要求提供某份文件，此文件不能藉由其MIME型态专业资料整理WORD格式对映来决定型态。专业资料整理WORD格式效劳器必须知会客户端文件所包含的型态型态的时候它便使用DefaultType(content-type)。例如 :，所以不知道专业资料整理WORD格式DefaultType image/gif对於包含许多没有.gif副文件名的gif图形目录是适宜的。3.8<Directory>指令语法 : <Directory目录 > . </Directory>用於 : server config,

35、virtual host状态:核心专业资料整理WORD格式<Directory>以及</Directory>用来把一组指令包装起来，这些指令专业资料整理WORD格式将只应用到所指明的目录及其子目录上。任何可以用於directory指令都可以使用。Directory是到某目录的完整路径，或是替代字元串(widecard string)。在替代字元串中"'能够符合任何单一字元，的专业资料整理WORD格式而 *'能够符合任何顺序的一些字元。例如:<Directory /usr/local/htppd/htdocs>Option Index

36、es FollowSymLinks</Directory>如果有多个directory节区能符合包含该文件的目录或其父目录，那麽分布在 .htaccess 文件里的指令是以最短先符合的顺序加以应用的，例如 :<Directory />AllowOverride None</Directory><Directory /hoem/*>AllowOverride FileInfo</Directory>专业资料整理WORD格式存取/home/web/dir/doc.html这份文件的步骤是:专业资料整理WORD格式。应用 AllowOver

37、ride None指令关掉.htaccess文件。应用 AllowOverride FileInfo指令目录/home/web。应用任何在/home/web/.htaccess里面的 FileInfo指令。专业资料整理WORD格式这个 directory节段典型是用在出现在任何配置档里。<Directory>在 <Limit>节段里。access.conf文件里，但它们可以指令不能巢状使用，而且不能出现专业资料整理WORD格式3.9DocumentRoot指令专业资料整理WORD格式语法: DocumentRoot目录名称专业资料整理WORD格式预设: Document

38、Root /usr/local/etc/d/htdocs专业资料整理WORD格式用於: server config, virtual host专业资料整理WORD格式状态:核心专业资料整理WORD格式这个指令设定d从这个目录提供文件效劳。除非符合像是Alias这样的指令，效劳器把所要求的URL附加到文件根(document root)来组合到达文件的路径。例如:DocumentRoot /usr/web专业资料整理WORD格式如此对於:/my.host/index.html到 /usr/web/index.html。文件的存取便会参照专业资料整理WORD格式3.10 ErrorDocument

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

40、ment 401 :/foo.bar/subscription_info.htmlErrorDocument 403 "Sorry can't allow you acess today参阅 :自定回应的文件。3.11 ErrorLog指令语法 : ErrorLog文件名称预设 : ErrorLog logs/error_log用於 : server config, virtual host状态:核心这个错误记录指令设定文件名称，效劳器将会把其遭遇的每个错误记录到这个文件去。如果文件名称不是以/开场的话那麽它就会被假设为相对於 ServerRoot的路径。例如 :ErrorL

41、og /dev/null这会有效地关掉错误记录。专业资料整理WORD格式3.12 Group指令专业资料整理WORD格式语法: Group unix-群组专业资料整理WORD格式预设: Group #-1专业资料整理WORD格式用於状态: server config:核心专业资料整理WORD格式这个 Group指令设定效劳器答复要求时所处的群组。为了要能够使用这个指令，必须以 root 身分起始执行独立的效劳器。 Unix- 群组可以是这些其中之一 :群组的名称藉由名称参照所给的群组。# 跟随著群组藉由参照某个群组。专业资料整理WORD格式建议你特别设立一个群组来执行这个效劳器。某些管理者使用

42、这个使用者，但是这并非永远可行或适宜的。nobody专业资料整理WORD格式注意 : 如果你以非 root 使用者的身分启动这个效劳器，它将无法切换到指定的群组，并且取而代之的是它将会继续以原来的使用者所属群组来执行。平安 :参阅 User指令对平安情况的讨论。专业资料整理WORD格式3.13 IdentityCheck指令专业资料整理WORD格式语法: IdentifyCheck布林值专业资料整理WORD格式预设: IdentifyCheck off专业资料整理WORD格式用於: server config专业资料整理WORD格式状态:核心专业资料整理WORD格式这个指令为每次的连线起始RF

43、C931- 相容的远端使用者名称记录，其中客户端需得执行identd或者是类似的东西。这项资讯记录在存取记录(access log)里。布林值是on或者 off。专业资料整理WORD格式除非是作为根本的使用量追踪，这项资讯无论如何不能真的信赖。3.14 <Limit>指令语法 : <Limit方式方式 . > . </Limit>用於 :任何地方状态:核心专业资料整理WORD格式<limit>以及</Limit>用来把一组存取控制指令包装起来，这些指令专业资料整理WORD格式将只应用到指定的存取方式上，其中的方式是指任何有效的方式(m

44、ethod)。除了 <Limit>或是 <Directory>之外的任何指令都可以专业资料整理WORD格式使用；大局部都不会被<Limit>影响。例如:专业资料整理WORD格式<Limit GET POST>require valid-user</Limit>专业资料整理WORD格式如果有个存取控制指令出现在<Limit>指令之外，那麽它会被应用到专业资料整理WORD格式所有的存取方式上。专业资料整理WORD格式3.15 MaxClient指令专业资料整理WORD格式语法: MaxClients数字专业资料整理WORD格式

45、预设: MaxClients 150专业资料整理WORD格式用於: server config专业资料整理WORD格式状态:核心专业资料整理WORD格式这个 MaxClients此值还多的子程序。指令设定所能支援的同时存取要求数目；不会建立比专业资料整理WORD格式3.16 MaxRequestPerChild指令语法 : MaxRequestsPerChild数字预设 : MaxRequestsPerChild 0用於 : server config状态:核心MaxRequestsPerChild这个指令设定一个独立的子效劳程序将能处理的请求数量。在处理MaxRequestsPerChild个请求之後，子程序将会被终止。如果MaxRequestsPerChild为 0的话，那麽该程序永远不会被终止。专业资料整理WORD格式MaxRequestsPerChild设为非0的值做为限制有两个好处:专业资料整理WORD格式。藉由记忆体使用量限制程序使用的记忆体数量；。藉由赋予程序有限的存留时间，可以在效劳器负载降低时协助减少程序的数目。专业资料整理WORD格式3.17 MaxSpareServers指令专业资料整理WORD格式语法: MaxSpareServers数字专业资料整理WOR