APACHE配置檔案中文版 httpd.conf FOR Apache 2.2.4

綜合網上2.0版本的翻譯，加入自己的了解，補充完善。

#

# This is the main Apache HTTP server configuration file. It contains the

# configuration directives that give the server its instructions.

# See <URL:http://httpd.apache.org/docs/2.2/> for detailed information.

# In particular, see

# <URL:http://httpd.apache.org/docs/2.2/mod/directives.html>

# for a discussion of each configuration directive.

# 這是Apache server的主配置檔案. 它包含配置指令，來訓示伺服器。

# 參考 http://httpd.apache.org/docs/2.2/mod/directives.html 了解關于指令的詳細資訊。

# 另外，參看 http://httpd.apache.org/docs/2.2/mod/directives.html 擷取每個配置指令的讨論。

# Do NOT simply read the instructions in here without understanding

# what they do. They're here only as hints or reminders. If you are unsure

# consult the online docs. You have been warned.

# 不要僅僅是閱讀本指令，而應該了解指令做了什麼。在這裡僅起提示的作用。

# 如果你不清楚請參閱線上文檔。特别提示。

# The configuration directives are grouped into three basic sections:

# 配置檔案批令分為三個基本組：

# 1. Directives that control the operation of the Apache server process as a

# whole (the 'global environment').

# 1.控制Apache server的全局操作的指令(全局環境變量)。

# 2. Directives that define the parameters of the 'main' or 'default' server,

# which responds to requests that aren't handled by a virtual host.

# These directives also provide default values for the settings

# of all virtual hosts.

# 2. 配置主服務或者預設服務的指令，它針對那些被虛拟主機以外的請求作出響應。

# 它也包含虛拟主機的一些預設參數。

# 3. Settings for virtual hosts, which allow Web requests to be sent to

# different IP addresses or hostnames and have them handled by the

# same Apache server process.

# 3. 虛拟主機設定，這使得發往不同的ip或者主機名的請求可以被子同一個Apache伺服器處理。

# Configuration and logfile names: If the filenames you specify for many

# of the server's control files begin with "/" (or "drive:/" for Win32), the

# server will use that explicit path. If the filenames do *not* begin

# with "/", the value of ServerRoot is prepended -- so "logs/foo.log"

# with ServerRoot set to "E:/usr/Apache2.2" will be interpreted by the

# server as "E:/usr/Apache2.2/logs/foo.log".

# 配置和日志檔案名：如果你所指定的檔案名以“/”（在Win32中以“盤符：/”）開頭，

# 伺服器将以絕對路徑來處理。如果檔案名不以“/”開頭，則以相對路徑處理，

# 相對于伺服器根（Serverroot）。是以“logs/foo.log”，如果伺服器根目錄

# 為“E:/usr/Apache2.2”，則伺服器解釋為“E:/usr/Apache2.2/logs/foo.log”。

# NOTE: Where filenames are specified, you must use forward slashes

# instead of backslashes (e.g., "c:/apache" instead of "c:\apache").

# 注意：在檔案名的定義中，必須用正斜杠，而不是反斜杠。（比如，“c:/apache”，而不是“c:\apache”）

# If a drive letter is omitted, the drive on which Apache.exe is located

# will be used by default. It is recommended that you always supply

# an explicit drive letter in absolute paths, however, to avoid

# confusion.

# 如果省略了盤符，則以Apache.exe所在的盤符為預設值。建議在絕對路徑中明确

# 指定盤符，以避免混亂。

# ThreadsPerChild: constant number of worker threads in the server process

# MaxRequestsPerChild： maximum number of requests a server process serves

# ThreadsPerChild:每個服務程序中的工作線程常數

# MaxRequestsPerChild：服務程序中允許的最大請求數目

ThreadsPerChild 250

MaxRequestsPerChild 0

# ServerRoot: The top of the directory tree under which the server's

# configuration, error, and log files are kept.

# 指出伺服器儲存其配置、出錯和日志檔案等的根目錄

# Do not add a slash at the end of the directory path. If you point

# ServerRoot at a non-local disk, be sure to point the LockFile directive

# at a local disk. If you wish to share the same ServerRoot for multiple

# httpd daemons, you will need to change at least LockFile and PidFile.

# 不要在目錄的末尾加上斜杠。如果你想将ServerRoot指向非本地硬碟上,請添加卷到本地硬碟上。

# 如果你想共享 ServerRoot 給多個HTTPD鏡像服務，你必須改變LockFile和PidFile。

ServerRoot "E:/usr/Apache2.2"

# Listen: Allows you to bind Apache to specific IP addresses and/or

# ports, instead of the default. See also the <VirtualHost>

# directive.

# Listen：允許你綁定Apache服務到指定的IP位址和端口上，以取代預設值。請同時參考<VirtualHost>

# 指令。

# Change this to Listen on specific IP addresses as shown below to

# prevent Apache from glomming onto all bound IP addresses (0.0.0.0)

# 像下面那樣使Apache隻在指定的IP位址上監聽，以防止它在IP位址0.0.0.0上監聽。

#Listen 12.34.56.78:80

Listen 8080

# Dynamic Shared Object (DSO) Support

# 動态共享對象（DSO）支援

# To be able to use the functionality of a module which was built as a DSO you

# have to place corresponding `LoadModule' lines at this location so the

# directives contained in it are actually available _before_ they are used.

# Statically compiled modules (those listed by `httpd -l') do not need

# to be loaded here.

# 為了能夠使用那些以DSO模式編譯的子產品中的函數，你必須放置相應的“LoadModule”行在這裡，以便

# 包含在其後的指令在使用之前激活。

# 那些靜态編譯的子產品(即以“httpd -l”列出的子產品)則不需要在這裡加載。

# Example:

# LoadModule foo_module modules/mod_foo.so

LoadModule actions_module modules/mod_actions.so

LoadModule alias_module modules/mod_alias.so

LoadModule asis_module modules/mod_asis.so

LoadModule auth_basic_module modules/mod_auth_basic.so

#LoadModule auth_digest_module modules/mod_auth_digest.so

#LoadModule authn_anon_module modules/mod_authn_anon.so

#LoadModule authn_dbm_module modules/mod_authn_dbm.so

LoadModule authn_default_module modules/mod_authn_default.so

LoadModule authn_file_module modules/mod_authn_file.so

#LoadModule authz_dbm_module modules/mod_authz_dbm.so

LoadModule authz_default_module modules/mod_authz_default.so

LoadModule authz_groupfile_module modules/mod_authz_groupfile.so

LoadModule authz_host_module modules/mod_authz_host.so

LoadModule authz_user_module modules/mod_authz_user.so

LoadModule autoindex_module modules/mod_autoindex.so

#LoadModule cern_meta_module modules/mod_cern_meta.so

LoadModule cgi_module modules/mod_cgi.so

#LoadModule dav_module modules/mod_dav.so

#LoadModule dav_fs_module modules/mod_dav_fs.so

#LoadModule deflate_module modules/mod_deflate.so

LoadModule dir_module modules/mod_dir.so

LoadModule env_module modules/mod_env.so

#LoadModule expires_module modules/mod_expires.so

#LoadModule file_cache_module modules/mod_file_cache.so

#LoadModule headers_module modules/mod_headers.so

LoadModule p_w_picpathmap_module modules/mod_p_w_picpathmap.so

LoadModule include_module modules/mod_include.so

#LoadModule info_module modules/mod_info.so

LoadModule isapi_module modules/mod_isapi.so

LoadModule log_config_module modules/mod_log_config.so

LoadModule mime_module modules/mod_mime.so

#LoadModule mime_magic_module modules/mod_mime_magic.so

#LoadModule proxy_module modules/mod_proxy.so

#LoadModule proxy_ajp_module modules/mod_proxy_ajp.so

#LoadModule proxy_balancer_module modules/mod_proxy_balancer.so

#LoadModule proxy_connect_module modules/mod_proxy_connect.so

#LoadModule proxy_http_module modules/mod_proxy_http.so

#LoadModule proxy_ftp_module modules/mod_proxy_ftp.so

LoadModule negotiation_module modules/mod_negotiation.so

#LoadModule rewrite_module modules/mod_rewrite.so

LoadModule setenvif_module modules/mod_setenvif.so

#LoadModule speling_module modules/mod_speling.so

#LoadModule status_module modules/mod_status.so

#LoadModule unique_id_module modules/mod_unique_id.so

LoadModule userdir_module modules/mod_userdir.so

#LoadModule usertrack_module modules/mod_usertrack.so

#LoadModule vhost_alias_module modules/mod_vhost_alias.so

#LoadModule ssl_module modules/mod_ssl.so

LoadModule php5_module "E:/usr/php/php5apache2_2.dll"

# 配置 php.ini 的路徑

PHPIniDir "E:/usr/php"

# 'Main' server configuration

# 主服務配置

# The directives in this section set up the values used by the 'main'

# server, which responds to any requests that aren't handled by a

# <VirtualHost> definition. These values also provide defaults for

# any <VirtualHost> containers you may define later in the file.

# 本節中指令的設定值，将被主服務所使用，主服務響應那些沒有被<VirtualHost>所處理的請求，

# 這些值也為<VirtualHost>容器提供了預設值，你可以在後面的檔案中定義

# All of these directives may appear inside <VirtualHost> containers,

# in which case these default settings will be overridden for the

# virtual host being defined.

# 所有這些指令将出現在<VirtualHost>容器中，這些設定值将在定義virtual host時被覆寫。

# ServerAdmin: Your address, where problems with the server should be

# e-mailed. This address appears on some server-generated pages, such

# as error documents. e.g. [email protected]

# ServerAdmin: 你的位址，當系統故障時，可以給你發email。

# 此位址出現在那些由伺服器生成的頁面上，如出錯文檔。例如：[email protected]

ServerAdmin [email protected]

# ServerName gives the name and port that the server uses to identify itself.

# This can often be determined automatically, but we recommend you specify

# it explicitly to prevent problems during startup.

# ServerNaem 定義了server名稱和端口号，用以标明自己的身份。

# 通常可以自動定義，建議明确地指定它，避免起動時出錯

# If your host doesn't have a registered DNS name, enter its IP address here.

# 如果你沒有注冊DNS名字，請在這裡輸入IP位址。

ServerName www.kysf.net:8080

# DocumentRoot: The directory out of which you will serve your

# documents. By default, all requests are taken from this directory, but

# symbolic links and aliases may be used to point to other locations.

# DocumentRoot: 你的文檔的根目錄。預設情況下，所有的請求都從這裡開始，

# 但是可以使用符号連結和别名來指向到其他的位置。

DocumentRoot "E:/usr/Apache2.2/htdocs"

# Each directory to which Apache has access can be configured with respect

# to which services and features are allowed and/or disabled in that

# directory (and its subdirectories).

# 每個可供Apache通路的目錄，可以配置成允許和（或）禁止哪些服務和特性（包括其子目錄）

# First, we configure the "default" to be a very restrictive set of

# features.

# 首先，我們定義一個預設的非常嚴格的配置

<Directory />

Options FollowSymLinks

AllowOverride None

Order deny,allow

Deny from all

Satisfy all

</Directory>

# Note that from this point forward you must specifically allow

# particular features to be enabled - so if something's not working as

# you might expect, make sure that you have specifically enabled it

# below.

# 注意從這裡開始你一定要明确地允許哪些特别的特性能夠被使用。

# 是以，如果Apache沒有象你所期待的那樣工作的話, 請檢查你是否在下面明确的指定它可用。

# This should be changed to whatever you set DocumentRoot to.

# 這将改變你對DocumentRoot的設定

<Directory "E:/usr/Apache2.2/htdocs">

# Possible values for the Options directive are "None", "All",

# or any combination of:

# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews

#Options：這個指令的值可以是“None”，“All”，或者下列選項的任意組合：

# Note that "MultiViews" must be named *explicitly* --- "Options All"

# doesn't give it to you.

# 注意，“MultiViews”必須被顯式的指定，“Options All”不能為你提供這個特性。

# The Options directive is both complicated and important. Please see

# http://httpd.apache.org/docs/2.2/mod/core.html#options

# for more information.

# options 指令既複雜又重要，請參見 http://httpd.apache.org/docs/2.2/mod/core.html#options

# 擷取更多資訊。

Options Indexes FollowSymLinks

# AllowOverride controls what directives may be placed in .htaccess files.

# It can be "All", "None", or any combination of the keywords:

# Options FileInfo AuthConfig Limit

# AllowOverride 控制那些被放置在.htaccess檔案中的指令。

# 它可以是“All”，“None”，或者下列指令的組合：

# Controls who can get stuff from this server.

# 控制哪些子產品可以獲得服務。

Order allow,deny

Allow from all

# DirectoryIndex: sets the file that Apache will serve if a directory

# is requested.

# DirectoryIndex: 當請求是一個目錄時，Apache向使用者提供服務的檔案名。（即預設文檔名。-譯者注。）

<IfModule dir_module>

DirectoryIndex index.html

</IfModule>

# The following lines prevent .htaccess and .htpasswd files from being

# viewed by Web clients.

# #下面的設定是防止.htaccess和.htpasswd（通路設定和密碼）檔案被Web客戶檢視。

<FilesMatch "^\.ht">

</FilesMatch>

# ErrorLog: The location of the error log file.

# If you do not specify an ErrorLog directive within a <VirtualHost>

# container, error messages relating to that virtual host will be

# logged here. If you *do* define an error logfile for a <VirtualHost>

# container, that host's errors will be logged there and not here.

# ErrorLog: 錯誤日志檔案位置。

# 如果你沒有在<VirtualHost>内定義ErrorLog指令，這個虛拟主機的錯誤資訊

# 将記錄在這裡。如果你在<VirtualHost>定義了ErrorLog，這些錯誤資訊将記錄在你所

# 定義的檔案裡，而不是這裡定義的檔案。

ErrorLog logs/error.log

# LogLevel: Control the number of messages logged to the error_log.

# Possible values include: debug, info, notice, warn, error, crit,

# alert, emerg.

# LogLevel: 控制記錄在錯誤日志檔案中的日志資訊數量。

# 可能的值包括: debug, info, notice, warn, error, crit, alert, emerg.

LogLevel warn

<IfModule log_config_module>

# The following directives define some format nicknames for use with

# a CustomLog directive (see below).

# 下面的參數設定是為CustomLog指令定義格式别名(看下面)。

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined

LogFormat "%h %l %u %t \"%r\" %>s %b" common

<IfModule logio_module>

# You need to enable mod_logio.c to use %I and %O

# 你需要安裝了mod_logio.c子產品才能使用%I和%O

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio

# The location and format of the access logfile (Common Logfile Format).

# If you do not define any access logfiles within a <VirtualHost>

# container, they will be logged here. Contrariwise, if you *do*

# define per-<VirtualHost> access logfiles, transactions will be

# logged therein and *not* in this file.

# 指定通路日志檔案的位置和格式（一般日志格式）。

# 如果你沒有在<VirtualHost>内定義這個指令，處理資訊将記錄在這裡，

# 如果你定義了這個指令，則處理資訊記錄在你指定的位置，而不是這兒定義的位置。

CustomLog logs/access.log common

# If you prefer a logfile with access, agent, and referer information

# (Combined Logfile Format) you can use the following directive.

# 如果你想要使用一個檔案記錄access，agent和referer資訊（組合日志格式），

# 你可以如下定義這個指令：

#CustomLog logs/access.log combined

<IfModule alias_module>

# Redirect: Allows you to tell clients about documents that used to

# exist in your server's namespace, but do not anymore. The client

# will make a new request for the document at its new location.

# Redirect：允許你用一個已存在的域名描述文檔，但不能用所有的域名（描述）。

# 用戶端将用這個新名稱發出一個新的請求。

# Redirect permanent /foo http://www.kysf.net/bar

# Alias: Maps web paths into filesystem paths and is used to

# access content that does not live under the DocumentRoot.

#Alias: 映射web路徑到檔案系統路徑，通常用于通路不在DocumentRoot裡面的内容

# Alias /webpath /full/filesystem/path

# If you include a trailing / on /webpath then the server will

# require it to be present in the URL. You will also likely

# need to provide a <Directory> section to allow access to

# the filesystem path.

# 如果web路徑中有字尾“/”，則伺服器要求有字尾“/”來描述URL。你也可以用 <Directory> 片段

# 允許通路檔案系統路徑。

# ScriptAlias: This controls which directories contain server scripts.

# ScriptAliases are essentially the same as Aliases, except that

# documents in the target directory are treated as applications and

# run by the server when requested rather than as documents sent to the

# client. The same rules about trailing "/" apply to ScriptAlias

# directives as to Alias.

# ScriptAlias: 指定包含服務腳本的目錄。

# ScriptAliases本質上與Aliases一樣，除了這裡的文檔在請求時做為程式處理和運作，

# 而不是作為文檔發送到用戶端。尾部的“/”規則與Alias一樣。

ScriptAlias /cgi-bin/ "E:/usr/Apache2.2/cgi-bin/"

# "E:/usr/Apache2.2/cgi-bin" should be changed to whatever your ScriptAliased

# CGI directory exists, if you have that configured.

# 更改 "E:/usr/Apache2.2/cgi-bin" 為你的 ScriptAlias（腳本别名）。

<Directory "E:/usr/Apache2.2/cgi-bin">

Options None

# Apache parses all CGI scripts for the shebang line by default.

# This comment line, the first line of the script, consists of the symbols

# pound (#) and exclamation (!) followed by the path of the program that

# can execute this specific script. For a perl script, with perl.exe in

# the C:\Program Files\Perl directory, the shebang line should be:

# 預設的，Apache 将整個行解釋為 CGI 腳本。

# 注釋行、腳本第一行、帶#!的程式路徑，都能執行這個指定的腳本。比如一個 perl 腳本，

# 在 C:\Program Files\Perl 中有 perl.exe 解釋程式，整個行寫為：

#!c:/program files/perl/perl

# Note you _must_not_ indent the actual shebang line, and it must be the

# first line of the file. Of course, CGI processing must be enabled by

# the appropriate ScriptAlias or Options ExecCGI directives for the files

# or directory in question.

# However, Apache on Windows allows either the Unix behavior above, or can

# use the Registry to match files by extention. The command to execute

# a file of this type is retrieved from the registry by the same method as

# the Windows Explorer would use to handle double-clicking on a file.

# These script actions can be configured from the Windows Explorer View menu,

# 'Folder Options', and reviewing the 'File Types' tab. Clicking the Edit

# button allows you to modify the Actions, of which Apache 1.3 attempts to

# perform the 'Open' Action, and failing that it will try the shebang line.

# This behavior is subject to change in Apache release 2.0.

# Each mechanism has it's own specific security weaknesses, from the means

# to run a program you didn't intend the website owner to invoke, and the

# best method is a matter of great debate.

# To enable the this Windows specific behavior (and therefore -disable- the

# equivilant Unix behavior), uncomment the following directive:

#ScriptInterpreterSource registry

# The directive above can be placed in individual <Directory> blocks or the

# .htaccess file, with either the 'registry' (Windows behavior) or 'script'

# (Unix behavior) option, and will override this server default option.

# DefaultType: the default MIME type the server will use for a document

# if it cannot otherwise determine one, such as from filename extensions.

# If your server contains mostly text or HTML documents, "text/plain" is

# a good value. If most of your content is binary, such as applications

# or p_w_picpaths, you may want to use "application/octet-stream" instead to

# keep browsers from trying to display binary files as though they are

# text.

DefaultType text/plain

<IfModule mime_module>

# TypesConfig points to the file containing the list of mappings from

# filename extension to MIME-type.

TypesConfig conf/mime.types

# AddType allows you to add to or override the MIME configuration

# file specified in TypesConfig for specific file types.

#AddType application/x-gzip .tgz

# AddEncoding allows you to have certain browsers uncompress

# information on the fly. Note: Not all browsers support this.

#AddEncoding x-compress .Z

#AddEncoding x-gzip .gz .tgz

# If the AddEncoding directives above are commented-out, then you

# probably should define those extensions to indicate media types:

AddType application/x-compress .Z

AddType application/x-gzip .gz .tgz

# AddHandler allows you to map certain file extensions to "handlers":

# actions unrelated to filetype. These can be either built into the server

# or added with the Action directive (see below)

# To use CGI scripts outside of ScriptAliased directories:

# (You will also need to add "ExecCGI" to the "Options" directive.)

#AddHandler cgi-script .cgi

# For type maps (negotiated resources):

#AddHandler type-map var

# Filters allow you to process content before it is sent to the client.

# To parse .shtml files for server-side includes (SSI):

# (You will also need to add "Includes" to the "Options" directive.)

#AddType text/html .shtml

#AddOutputFilter INCLUDES .shtml

#添加 .PHP 檔案擴充

AddType application/x-httpd-php .php

# The mod_mime_magic module allows the server to use various hints from the

# contents of the file itself to determine its type. The MIMEMagicFile

# directive tells the module where the hint definitions are located.

#MIMEMagicFile conf/magic

# Customizable error responses come in three flavors:

# 1) plain text 2) local redirects 3) external redirects

# Some examples:

#ErrorDocument 500 "The server made a boo boo."

#ErrorDocument 404 /missing.html

#ErrorDocument 404 "/cgi-bin/missing_handler.pl"

#ErrorDocument 402 http://www.kysf.net/subscription_info.html

# EnableMMAP and EnableSendfile: On systems that support it,

# memory-mapping or the sendfile syscall is used to deliver

# files. This usually improves server performance, but must

# be turned off when serving from networked-mounted

# filesystems or if support for these functions is otherwise

# broken on your system.

#EnableMMAP off

#EnableSendfile off

# Supplemental configuration

# The configuration files in the conf/extra/ directory can be

# included to add extra features or to modify the default configuration of

# the server, or you may simply copy their contents here and change as

# necessary.

# Server-pool management (MPM specific)

#Include conf/extra/httpd-mpm.conf

# Multi-language error messages

#Include conf/extra/httpd-multilang-errordoc.conf

# Fancy directory listings

#Include conf/extra/httpd-autoindex.conf

# Language settings

#Include conf/extra/httpd-languages.conf

# User home directories

#Include conf/extra/httpd-userdir.conf

# Real-time info on requests and configuration

#Include conf/extra/httpd-info.conf

# Virtual hosts

#Include conf/extra/httpd-vhosts.conf

# Local access to the Apache HTTP Server Manual

#Include conf/extra/httpd-manual.conf

# Distributed authoring and versioning (WebDAV)

#Include conf/extra/httpd-dav.conf

# Various default settings

#Include conf/extra/httpd-default.conf

# Secure (SSL/TLS) connections

#Include conf/extra/httpd-ssl.conf

# Note: The following must must be present to support

# starting without SSL on platforms with no /dev/random equivalent

# but a statically compiled-in mod_ssl.

<IfModule ssl_module>

SSLRandomSeed startup builtin

SSLRandomSeed connect builtin