Apache配置文件

# This is the main Apache 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服務器配置文件。
# 它給服務器指示配置指令。
# 可去http://httpd.apache.org/docs/2.2/查看詳細信息
# 特別情況可去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').
#  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.
#  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.




# 要明白這些指令是做什麼的。這裏只是一點提醒信息。
#
# 配置指示分爲三個基本組：
# 1. 全局控制Apache操作指示。
# 2. 'main'或者'default'服務器參數定義，
#    這些參數響應非虛擬主機的操作請求。同時也爲所以虛擬主機提供了默認設定值。
# 3. 設置虛擬主機，可以通過一個Apache服務器來實現處理不同IP或者主機名的Web請求。



 


# 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 "/etc/httpd" will be interpreted by the
# server as "/etc/httpd/logs/foo.log".



# 配置名和日誌文件名：
# 如果用“/”或者Win32的“drive:/”開頭，來指定服務器的控制文件名，服務器將使用顯式路徑。
# 如果未用“/”開頭，比如文件名“logs/foo.log”，假設服務器根目錄爲“/etc/httpd”，
# 則，服務器會將它解釋爲“/etc/httpd/logs/foo.log”。

 

### Section 1: Global Environment
#
# The directives in this section affect the overall operation of Apache,
# such as the number of concurrent requests it can handle or where it
# can find its configuration files.

### 章節1：全局環境
# 這節的指令影響Apache的整體操作，比如它能操作的當前連接請求數目或者去哪裏
# 查找其配置文件等。

 

# Don't give away too much information about all the subcomponents
# we are running.  Comment out this line if you don't mind remote sites
# finding out what major optional modules you are running
ServerTokens OS

# 不要泄漏太多的服務器信息。
# 如果不想讓遠程站點瞭解到你的主要選型模塊信息，可以註釋掉該行。

 


# ServerRoot: The top of the directory tree under which the server's
# configuration, error, and log files are kept.
#
# NOTE!  If you intend to place this on an NFS (or otherwise network)
# mounted filesystem then please read the LockFile documentation
# (available at <URL:http://httpd.apache.org/docs/2.2/mod/mpm_common.html#lockfile>);
# you will save yourself a lot of trouble.
#
# Do NOT add a slash at the end of the directory path.
#
ServerRoot "/etc/httpd"




# 服務器的根：目錄樹的頂部，其下存放着配置、錯誤，以及日誌文件等。
#
# 注意！如果你打算將它放到掛載文件系統的NFS（或者其他網絡），建議參閱LockFile文檔
# （有效鏈接爲http://httpd.apache.org/docs/2.2/mod/mpm_common.html#lockfile）
# 你將省去不少麻煩。
#
# 不要在目錄的末尾加斜線“/”
#
ServerRoot "/etc/httpd"



 

# PidFile: The file in which the server should record its process
# identification number when it starts.
#
PidFile run/httpd.pid

# Pid文件：當進程啓動時，服務器應當在其中記錄PID。
#
PidFile run/httpd.pid

 

#
# Timeout: The number of seconds before receives and sends time out.
#
Timeout 120

# Timeout：確定發送超時和接收超時的秒數。
Timeout 120

 

#
# KeepAlive: Whether or not to allow persistent connections (more than
# one request per connection). Set to "Off" to deactivate.
#
KeepAlive Off

# KeepAlive：是否允許保持連接狀態（每次連接可以執行多個請求）。一般設置爲“Off”。
KeepAlive Off

 


#
# MaxKeepAliveRequests: The maximum number of requests to allow
# during a persistent connection. Set to 0 to allow an unlimited amount.
# We recommend you leave this number high, for maximum performance.
#
MaxKeepAliveRequests 100



# MaxKeepAliveRequests：持續連接最大數。0表示無限數量。
# 爲了最大性能，推薦將其設置高一點。
MaxKeepAliveRequests 100

 

#
# KeepAliveTimeout: Number of seconds to wait for the next request from the
# same client on the same connection.
#
KeepAliveTimeout 15

# KeepAliveTimeout：同一客戶端同一連接請求的間隔秒數。
KeepAliveTimeout 15

 

##
## Server-Pool Size Regulation (MPM specific)
##

## 服務器池大小調整（MPM 特性）

 


# prefork MPM
# StartServers: number of server processes to start
# MinSpareServers: minimum number of server processes which are kept spare
# MaxSpareServers: maximum number of server processes which are kept spare
# ServerLimit: maximum value for MaxClients for the lifetime of the server
# MaxClients: maximum number of server processes allowed to start
# MaxRequestsPerChild: maximum number of requests a server process serves
<IfModule prefork.c>
StartServers       8
MinSpareServers    5
MaxSpareServers   20
ServerLimit      256
MaxClients       256
MaxRequestsPerChild  4000
</IfModule>




# prefork MPM（預分離多進程模塊）
# StartServices：服務器啓動進程數
# MinSpareServers：最小空閒進程數
# MaxSpareServers：最大空閒進程數
# ServerLimit：最大進程數MaxClients時，服務器的最大生存時間值
# MaxClients：服務器運行啓動的最大進程數量
# MaxRequestPerChild：每個服務子進程的最大請求數量
<IfModule prefork.c>
StartServers       8
MinSpareServers    5
MaxSpareServers   20
ServerLimit      256
MaxClients       256
MaxRequestsPerChild  4000
</IfModule>



 


# worker MPM
# StartServers: initial number of server processes to start
# MaxClients: maximum number of simultaneous client connections
# MinSpareThreads: minimum number of worker threads which are kept spare
# MaxSpareThreads: maximum number of worker threads which are kept spare
# ThreadsPerChild: constant number of worker threads in each server process
# MaxRequestsPerChild: maximum number of requests a server process serves
<IfModule worker.c>
StartServers         2
MaxClients         150
MinSpareThreads     25
MaxSpareThreads     75
ThreadsPerChild     25
MaxRequestsPerChild  0
</IfModule>




# worker 多進程模塊
# StartServers：服務器啓動進程的初始化數目
# MaxClients：同時客戶端連接的最大數目
# MinSpareThreads：最小空閒worker線程數
# MaxSpareThreads：最大空閒worker線程數
# ThreadsPerChild：每個服務器子進程的worker線程數
# MaxRequestsPerChild：每個子進程的最大請求數
<IfModule worker.c>
StartServers         2
MaxClients         150
MinSpareThreads     25
MaxSpareThreads     75
ThreadsPerChild     25
MaxRequestsPerChild  0
</IfModule>



 


#
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, in addition to the default. See also the <VirtualHost>
# directive.
#
# 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)
#
#Listen 12.34.56.78:80
Listen 80




# Listen：允許將Apache綁定到除了默認值之外的特定的IP地址和/或端口。也可
# 查看<VirtualHost>指令。
#
# 如下設置特定IP地址，可防止Apache接收所有綁定的IP（0.0.0.0）
# 默認接收所有IP，特定IP的Listen被“#”註釋掉
#Listen 12.34.56.78:80
Listen 80



 


#
# Dynamic Shared Object (DSO) Support
#
# 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.
#
# Example:
# LoadModule foo_module modules/mod_foo.so
#




#
# 動態共享對象（DSO）支持
#
# 爲了能使用編譯爲DSO的模塊函數，我們必須將相應的‘LoadModule’行放在此處，這樣模塊中的指令將有效。
# 靜態編譯模塊（用‘httpd -l’命令可以列出）不需要在這裏加載。
#
# 示例：
# LoadModule foo_module modules/mod_foo.so
#




LoadModule auth_basic_module modules/mod_auth_basic.so
LoadModule auth_digest_module modules/mod_auth_digest.so
LoadModule authn_file_module modules/mod_authn_file.so
LoadModule authn_alias_module modules/mod_authn_alias.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 authz_host_module modules/mod_authz_host.so
LoadModule authz_user_module modules/mod_authz_user.so
LoadModule authz_owner_module modules/mod_authz_owner.so
LoadModule authz_groupfile_module modules/mod_authz_groupfile.so
LoadModule authz_dbm_module modules/mod_authz_dbm.so
LoadModule authz_default_module modules/mod_authz_default.so
LoadModule ldap_module modules/mod_ldap.so
LoadModule authnz_ldap_module modules/mod_authnz_ldap.so
LoadModule include_module modules/mod_include.so
LoadModule log_config_module modules/mod_log_config.so
LoadModule logio_module modules/mod_logio.so
LoadModule env_module modules/mod_env.so
LoadModule ext_filter_module modules/mod_ext_filter.so
LoadModule mime_magic_module modules/mod_mime_magic.so
LoadModule expires_module modules/mod_expires.so
LoadModule deflate_module modules/mod_deflate.so
LoadModule headers_module modules/mod_headers.so
LoadModule usertrack_module modules/mod_usertrack.so
LoadModule setenvif_module modules/mod_setenvif.so
LoadModule mime_module modules/mod_mime.so
LoadModule dav_module modules/mod_dav.so
LoadModule status_module modules/mod_status.so
LoadModule autoindex_module modules/mod_autoindex.so
LoadModule info_module modules/mod_info.so
LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule vhost_alias_module modules/mod_vhost_alias.so
LoadModule negotiation_module modules/mod_negotiation.so
LoadModule dir_module modules/mod_dir.so
LoadModule actions_module modules/mod_actions.so
LoadModule speling_module modules/mod_speling.so
LoadModule userdir_module modules/mod_userdir.so
LoadModule alias_module modules/mod_alias.so
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule cache_module modules/mod_cache.so
LoadModule suexec_module modules/mod_suexec.so
LoadModule disk_cache_module modules/mod_disk_cache.so
LoadModule file_cache_module modules/mod_file_cache.so
LoadModule mem_cache_module modules/mod_mem_cache.so
LoadModule cgi_module modules/mod_cgi.so
LoadModule version_module modules/mod_version.so
#
# The following modules are not loaded by default:
#
#LoadModule cern_meta_module modules/mod_cern_meta.so
#LoadModule asis_module modules/mod_asis.so



 

#
# Load config files from the config directory "/etc/httpd/conf.d".
#
Include conf.d/*.conf

# 從config目錄“/etc/httpd/conf.d”加載配置文件
# *.conf兼容老版本的Apache
Include conf.d/*.conf

 


#
# ExtendedStatus controls whether Apache will generate "full" status
# information (ExtendedStatus On) or just basic information (ExtendedStatus
# Off) when the "server-status" handler is called. The default is Off.
#
#ExtendedStatus On



# ExtendedStatus 在“server-status”操作被調用時，控制Apache是否產生“full”狀態信息（On）或者
# 基本信息（Off）。默認爲Off。
#
#ExtendedStatus On

 


#
# If you wish httpd to run as a different user or group, you must run
# httpd as root initially and it will switch.
#
# User/Group: The name (or #number) of the user/group to run httpd as.
#  . On SCO (ODT 3) use "User nouser" and "Group nogroup".
#  . On HPUX you may not be able to use shared memory as nobody, and the
#    suggested workaround is to create a user www and use that user.
#  NOTE that some kernels refuse to setgid(Group) or semctl(IPC_SET)
#  when the value of (unsigned)Group is above 60000;
#  don't use Group #-1 on these systems!
#
User apache
Group apache




# 如果想要httpd作爲一個不同用戶或組來運行，最初就必須以root來運行httpd，它會切換到其他用戶或組去。
#
# 用戶/組：作爲運行httpd的用戶/組的名稱。
# - 在SCO（ODT 3）上，使用“User nouser”和“Group nogroup”。
# - 在HPUX上，將無法使用共享存儲作爲nobody，建議的解決辦法是創建一個用戶www並使用這個用戶。
# 注意，有的內核不支持60000以上的組ID值，在這些系統中不要使用“Group #-1”。
#
User apache
Group apache



 


### Section 2: '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.
#
# All of these directives may appear inside <VirtualHost> containers,
# in which case these default settings will be overridden for the
# virtual host being defined.
#




### 章節2：‘Main’服務器配置
#
# 該章節設置‘Main’服務器使用的指令，響應所有非<VirtualHost>定義的請求。
# 這些指令值也爲<VirtualHost>部分提供默認值。
#
# 所有這些指令都可以在<VirtualHost>段中出現，此時，這些默認值將被虛擬主機的相關設置值所覆蓋。



 


#
# 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 root@localhost



# ServerAdmin：服務器管理員的郵箱地址，該地址一般出現在服務器生成頁中，比如錯誤文檔等。
ServerAdmin root@localhost

 


#
# 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.
#
# If this is not set to valid DNS name for your host, server-generated
# redirections will not work.  See also the UseCanonicalName directive.
#
# If your host doesn't have a registered DNS name, enter its IP address here.
# You will have to access it by its address anyway, and this will make
# redirections work in a sensible way.
#
#ServerName www.example.com:80




# ServerName 給出一個服務器用來標識它自己的名稱和端口。
# 通常被自動指定，但爲避免啓動時的問題，推薦明確指定它。
#
# 如果主機沒有設置有效的DNS名稱，server-generated指令將不會工作。
#
# 如果主機沒有註冊DNS，輸入其IP地址。這樣就可以通過IP地址訪問你的主機了。
#
#ServerName www.example.com:80



 


#
# UseCanonicalName: Determines how Apache constructs self-referencing
# URLs and the SERVER_NAME and SERVER_PORT variables.
# When set "Off", Apache will use the Hostname and Port supplied
# by the client.  When set "On", Apache will use the value of the
# ServerName directive.
#
UseCanonicalName Off



# UseCanonicalName：確定apache如何構建自引用URLs和SERVER_NAME、SERVER_PORT變量。
# 當設爲Off時，apache將使用客戶端支持的Hostname和Port。當設爲On時，apache將使用
# ServerName指令值。
#
UseCanonicalName Off

 


#
# 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 "/var/www/html"



# DocumentRoot：提供文檔的根目錄。
# 默認，所有請求都由該目錄提供，但是可以用連接符和別名指向其他位置。
#
DocumentRoot “/var/www/html”

 


#
# 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).
#
# First, we configure the "default" to be a very restrictive set of
# features.
#
<Directory />
    Options FollowSymLinks
    AllowOverride None
</Directory>




# 每個apache存取的目錄（包括子目錄）都可配置爲允許和禁止。
#
# 首先，我們配置嚴格特徵集合的默認值。
#
<Directory />
    Options FollowSymLinks
    AllowOverride None
</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.
#



# 注意，從此點開始，必須指定使能特殊特性的允許。所以，如果一些事情沒有安裝你的期望的運行，
# 確保你已經指定並使能以下特性。

 

#
# This should be changed to whatever you set DocumentRoot to.
#
<Directory "/var/www/html">

# 這裏應當根據你設定的DocumentRoot值進行修改。
<Directory “/var/www/html”>

 


#
# Possible values for the Options directive are "None", "All",
# or any combination of:
#   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
#
# Note that "MultiViews" must be named *explicitly* --- "Options All"
# doesn't give it to you.
#
# 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 Indexes FollowSymLinks




# 指令選項值可以是“None”、“All”，或者下面的任何組合：
# 　　Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
#
# 注意，“MultiViews”必須被清楚地指定---“All”不會幫你指定。
#
# 指令選項複雜並且重要。詳細信息請查閱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 None



# AllowOverride 允許優先，用來控制哪些指令可以放到.htaccess文件中。
# 可以是“All”、“None”，或者下面關鍵字的任何組合：
# 　　Options FileInfo AuthConfig Limit
#
 　　AllowOverride None

 


#
# Controls who can get stuff from this server.
#
    Order allow,deny
    Allow from all

</Directory>



# 控制誰可能獲得服務器阻塞
　　Order allow,deny
　　Allow from all
</Directory>

 


#
# UserDir: The name of the directory that is appended onto a user's home
# directory if a ~user request is received.
#
# The path to the end user account 'public_html' directory must be
# accessible to the webserver userid.  This usually means that ~userid
# must have permissions of 711, ~userid/public_html must have permissions
# of 755, and documents contained therein must be world-readable.
# Otherwise, the client will only receive a "403 Forbidden" message.
#
# See also: http://httpd.apache.org/docs/misc/FAQ.html#forbidden
#
<IfModule mod_userdir.c>
    #
    # UserDir is disabled by default since it can confirm the presence
    # of a username on the system (depending on home directory
    # permissions).
    #
    UserDir disable

    #
    # To enable requests to /~user/ to serve the user's public_html
    # directory, remove the "UserDir disable" line above, and uncomment
    # the following line instead:
    #
    #UserDir public_html

</IfModule>




# UserDir：當接收到~user請求時，附加到用戶home目錄上的目錄名稱。
#
# 端用戶賬戶路徑‘public_html’路徑對web服務器用戶id必須是可存取的。
# 這通常意味着~userid必須擁有711權限值，~userid/public_html必須有755權限值，
# 並且其中包含的文件都是公開的。否則，客戶端只能收到“403 Forbidden”消息。
#
# 可查閱：http://httpd.apache.org/docs/misc/FAQ.html#forbidden
#
<IfModule mod_userdir.c>
　　# UserDir默認被禁止掉，這樣可以確定一個系統用戶名的存在（依賴home路徑許可）。
　　UserDir disable
　　
　　# 要使能/~user/請求以提供用戶的public_html目錄的話，刪除上面的“UserDir disable”行，
　　# 並且取消下面的註釋：
　　#UserDir public_html
</IfModule>



 


#
# Control access to UserDir directories.  The following is an example
# for a site where these directories are restricted to read-only.
#
#<Directory /home/*/public_html>
#    AllowOverride FileInfo AuthConfig Limit
#    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
#    <Limit GET POST OPTIONS>
#        Order allow,deny
#        Allow from all
#    </Limit>
#    <LimitExcept GET POST OPTIONS>
#        Order deny,allow
#        Deny from all
#    </LimitExcept>
#</Directory>




# UserDir目錄的存取控制。以下是一個這些目錄被限制到只讀的站點示例。
#
#<Directory /home/*/public_html>
#    AllowOverride FileInfo AuthConfig Limit
#    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
#    <Limit GET POST OPTIONS>
#        Order allow,deny
#        Allow from all
#    </Limit>
#    <LimitExcept GET POST OPTIONS>
#        Order deny,allow
#        Deny from all
#    </LimitExcept>
#</Directory>



 


#
# DirectoryIndex: sets the file that Apache will serve if a directory
# is requested.
#
# The index.html.var file (a type-map) is used to deliver content-
# negotiated documents.  The MultiViews Option can be used for the
# same purpose, but it is much slower.
#
DirectoryIndex index.html index.html.var



# DirectoryIndex：如果一個目錄被請求時，設置apache將提供文件的目錄索引。
#
# index.html.var文件用來傳遞內容協商了的文檔。MultiViews選項可用於相同目的，但是太慢了。
#
DirectoryIndex index.html index.html.var

 


#
# AccessFileName: The name of the file to look for in each directory
# for additional configuration directives.  See also the AllowOverride
# directive.
#
AccessFileName .htaccess



# AccessFileName：附加存取指令的文件的名稱。也可參照AllowOverride指令。
AccessFileName .htaccess

 


#
# The following lines prevent .htaccess and .htpasswd files from being
# viewed by Web clients.
#
<Files ~ "^\.ht">
    Order allow,deny
    Deny from all
</Files>



# 下面的行防止.htaccess和.htpasswd文件被Web客戶端查看。
<Files ~ "^\.ht">
    Order allow,deny
    Deny from all
</Files>

 

#
# TypesConfig describes where the mime.types file (or equivalent) is
# to be found.
#
TypesConfig /etc/mime.types

# TypesConfig 描述了mime.types文件在哪
TypesConfig /etc/mime.types

 


#
# DefaultType is 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 images, 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



# DefaultType 是服務器無法從文件擴展名確定文檔類型時，將使用的默認MIME類型。
# 如果你的服務器大部分都是text和html文檔，“text/plain”是一個合適值。
# 如果你的服務器大部分都是二進制文檔，“application/octet-stream”可避免服務器嘗試用text來顯示二進制。
#
DefaultType text/plain

 


#
# 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.
#
<IfModule mod_mime_magic.c>
#   MIMEMagicFile /usr/share/magic.mime
    MIMEMagicFile conf/magic
</IfModule>




# mod_mime_magic模塊允許服務器從文件內容來確定文件類型。
# MIMEMagicFile指令告訴該模塊隱含文件類型信息的位置。
<IfModule mod_mime_magic.c>
#   MIMEMagicFile /usr/share/magic.mime
    MIMEMagicFile conf/magic
</IfModule>



 


#
# HostnameLookups: Log the names of clients or just their IP addresses
# e.g., www.apache.org (on) or 204.62.129.132 (off).
# The default is off because it'd be overall better for the net if people
# had to knowingly turn this feature on, since enabling it means that
# each client request will result in AT LEAST one lookup request to the
# nameserver.
#
HostnameLookups Off



# HostnameLookups：將客戶端名稱或其IP地址加入日誌。
# 默認爲off對整個網絡比較好，如果有人明知卻非要打開這個特性，那麼使能它意味着每個客戶端請求都將
# 導致至少一個域名服務器查詢請求。
HostnameLookups Off

 


#
# EnableMMAP: Control whether memory-mapping is used to deliver
# files (assuming that the underlying OS supports it).
# The default is on; turn this off if you serve from NFS-mounted
# filesystems.  On some systems, turning it off (regardless of
# filesystem) can improve performance; for details, please see
# http://httpd.apache.org/docs/2.2/mod/core.html#enablemmap
#
#EnableMMAP off




# EnableMMAP：存儲器鏡像文件傳輸控制（需要操作系統的支持）。
# 默認爲on；如果從NFS-mounted文件系統提供文件則設爲off。
# 有些系統，設爲off（不考慮文件系統）能提高性能；詳情請
# 查閱http://httpd.apache.org/docs/2.2/mod/core.html#enablemmap
#
#EnableMMAP off



 


#
# EnableSendfile: Control whether the sendfile kernel support is
# used to deliver files (assuming that the OS supports it).
# The default is on; turn this off if you serve from NFS-mounted
# filesystems.  Please see
# http://httpd.apache.org/docs/2.2/mod/core.html#enablesendfile
#
#EnableSendfile off



# EnableSendfile：文件傳輸內核使能控制（需要系統支持）。
# 默認爲on；如果從NFS-mounted文件系統提供文件則設爲off。
# 請查閱http://httpd.apache.org/docs/2.2/mod/core.html#enablesendfile
#
#EnableSendfile off

 


#
# 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 logs/error_log



# ErrorLog：錯誤日誌文件的位置。
# 如果不在<VirtualHost>段中指定錯誤日誌指令，虛擬主機的錯誤日誌信息也會記錄到這個文件。
# 如果在<VirtualHost>段中指定錯誤日誌指令，則此虛擬主機的錯誤將會在那裏記錄而不在該文件記錄。
#
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 warn



# LogLevel：控制什麼級別的信息被記錄到error_log日誌文件中。
# 可能的值包括：debug，info，notice，warn，error，crit，alert，emerg。
#
LogLevel warn

 


#
# The following directives define some format nicknames for use with
# a CustomLog directive (see below).
#
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combine
d
LogFormat "%h %l %u %t \"%r\" %>s %b" common
LogFormat "%{Referer}i -> %U" referer
LogFormat "%{User-agent}i" agent

# "combinedio" includes actual counts of actual bytes received (%I) and sent (%O); this
# requires the mod_logio module to be loaded.
#LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio



# 下面的指令，爲CustomLog指令定義了一些暱稱。
# “combinedio”包含實際接收和發送字節的實際計數；這需要加載mod_logio模塊。

 


#
# 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.
#
#CustomLog logs/access_log common



# 普通日誌文件的位置和格式。
# 若在<VirtualHost>段中定義該指令，則其普通日誌文件不會存在該文件中。
#
#CustomLog logs/access_log common

 


#
# If you would like to have separate agent and referer logfiles, uncomment
# the following directives.
#
#CustomLog logs/referer_log referer
#CustomLog logs/agent_log agent



# 若是想分離代理和引用日誌文件，則取消下面指令的註釋。
#
#CustomLog logs/referer_log referer
#CustomLog logs/agent_log agent

 

#
# For a single logfile with access, agent, and referer information
# (Combined Logfile Format), use the following directive:
#
CustomLog logs/access_log combined

# 若是不想用分離代理和引用日誌文件，則用下面的指令：
#
CustomLog logs/access_log combined

 


#
# Optionally add a line containing the server version and virtual host
# name to server-generated pages (internal error documents, FTP directory
# listings, mod_status and mod_info output etc., but not CGI generated
# documents or custom error documents).
# Set to "EMail" to also include a mailto: link to the ServerAdmin.
# Set to one of:  On | Off | EMail
#
ServerSignature On




# 可選地添加一行包含服務器版本和虛擬主機名稱信息到服務器生成的頁中（內部錯誤文檔、FTP目錄列表、mod_status和
# mod_info輸出等，但非CGI生成文檔或者自定義錯誤文檔）。
# 設置爲“EMail”也包含mailto管理員郵箱的鏈接。
# 可設置爲其中之一： On | Off | EMail
#
ServerSignature On



 


#
# Aliases: Add here as many aliases as you need (with no limit). The format is
# Alias fakename realname
#
# Note that if you include a trailing / on fakename then the server will
# require it to be present in the URL.  So "/icons" isn't aliased in this
# example, only "/icons/".  If the fakename is slash-terminated, then the
# realname must also be slash terminated, and if the fakename omits the
# trailing slash, the realname must also omit it.
#
# We include the /icons/ alias for FancyIndexed directory listings.  If you
# do not use FancyIndexing, you may comment this out.
#
Alias /icons/ "/var/www/icons/"

<Directory "/var/www/icons">
    Options Indexes MultiViews
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>



# Aliases：在此添加無限個你需要的別名。
# 格式爲 Alias 別名 真名
# 注意，如果別名中以“/”結尾，則服務器將要求“/”出現在URL中。
# 別名中有“/”，則真名中必須有“/”。反之亦然。
#

 


#
# WebDAV module configuration section.
#
<IfModule mod_dav_fs.c>
    # Location of the WebDAV lock database.
    DAVLockDB /var/lib/dav/lockdb
</IfModule>



# WebDAV模塊配置部分。
# WebDAV鎖定數據庫的位置設置。

 


#
# ScriptAlias: This controls which directories contain server scripts.
# ScriptAliases are essentially the same as Aliases, except that
# documents in the realname 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 /cgi-bin/ "/var/www/cgi-bin/"



# ScriptAlias：服務器腳本目錄別名。
# 腳本目錄存放服務器響應請求時執行的應用程序，而非發送給客戶端的文件。
# “/”的處理跟Alias相同。
#
ScriptAlias /cgi-bin/ “/var/www/cgi-bin/”

 


#
# "/var/www/cgi-bin" should be changed to whatever your ScriptAliased
# CGI directory exists, if you have that configured.
#
<Directory "/var/www/cgi-bin">
    AllowOverride None
    Options None
    Order allow,deny
    Allow from all
</Directory>



# “/var/www/cgi-bin”應當對應到你自己的CGI路徑，如果你需要該配置。

 


#
# Redirect allows you to tell clients about documents which used to exist in
# your server's namespace, but do not anymore. This allows you to tell the
# clients where to look for the relocated document.
# Example:
# Redirect permanent /foo http://www.example.com/bar



# 重定向允許你告訴客戶端曾經在你空間中使用的文檔已經不存在了。通知客戶端去什麼位置查找文檔。

 

#
# Directives controlling the display of server-generated directory listings.
#

#
# 服務器生成路徑列表顯示的控制指令
#

 

#
# IndexOptions: Controls the appearance of server-generated directory
# listings.
#
IndexOptions FancyIndexing VersionSort NameWidth=* HTMLTable

# IndexOptions：服務器生成目錄列表的索引控制。
IndexOptions FancyIndexing VersionSort NameWidth=* HTMLTable

 


#
# AddIcon* directives tell the server which icon to show for different
# files or filename extensions.  These are only displayed for
# FancyIndexed directories.
#
AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip

AddIconByType (TXT,/icons/text.gif) text/*
AddIconByType (IMG,/icons/image2.gif) image/*
AddIconByType (SND,/icons/sound2.gif) audio/*
AddIconByType (VID,/icons/movie.gif) video/*

............      ............       ............



# AddIcon* 指令使服務器對不同文件顯示不同的文件類型圖標。

 

#
# DefaultIcon is which icon to show for files which do not have an icon
# explicitly set.
#
DefaultIcon /icons/unknown.gif

# DefaultIcon爲未明確設置圖標的文件指定一個默認類型圖標。
DefaultIcon /icons/unknown.gif

 


#
# AddDescription allows you to place a short description after a file in
# server-generated indexes.  These are only displayed for FancyIndexed
# directories.
# Format: AddDescription "description" filename
#
#AddDescription "GZIP compressed document" .gz
#AddDescription "tar archive" .tar
#AddDescription "GZIP compressed tar archive" .tgz



# AddDescription 允許你對在服務器生成文件索引後面加入對某類文件的簡短描述。
#
#AddDescription "GZIP compressed document" .gz
#AddDescription "tar archive" .tar
#AddDescription "GZIP compressed tar archive" .tgz

 


#
# ReadmeName is the name of the README file the server will look for by
# default, and append to directory listings.
#
# HeaderName is the name of a file which should be prepended to
# directory indexes.
ReadmeName README.html
HeaderName HEADER.html



# ReadmeName 是附加到目錄列表的README文件（服務器將默認查找）的名稱指定命令。
# HeaderName 是應當添加到目錄索引中的文件名稱。
ReadmeName README.html
HeaderName HEADER.html

 

#
# IndexIgnore is a set of filenames which directory indexing should ignore
# and not include in the listing.  Shell-style wildcarding is permitted.
#
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t

# IndexIgnore索引忽略，即目錄索引應當忽略並且不包括在列表裏的文件集。允許Shell風格的通配符。
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t