Apache httpd.conf 核心配置指令詳細中文註釋參考手冊

核心伺服器配置區塊

伺服器運行模式

ServerType standalone  # 獨立守護進程模式 (推薦)，而非 inetd 超級伺服器模式
ServerRoot "d:/Apache" # 伺服器根目錄，存放 conf、logs、modules 等
PidFile logs/httpd.pid # 主進程 PID 記錄檔
ScoreBoardFile logs/apache_status # 進程間通訊記分板檔案 (部分架構需求)

連線與效能參數

Timeout 300              # 連線/傳輸逾時秒數 (300 秒)
KeepAlive On             # 啟用持久連線 (HTTP/1.1)
MaxKeepAliveRequests 100 # 單一持久連線最大請求數 (0=不限)
KeepAliveTimeout 15      # 持久連線等待下一請求逾時秒數
MaxRequestsPerChild 0    # 子進程處理請求上限 (0=無限，防記憶體洩漏設 >0)
ThreadsPerChild 50       # 每子進程執行緒數 (Worker MPM)

網路監聽設定

Port 80                  # 監聽埠 (Apache 1.3 語法，2.0+ 用 Listen)
#Listen 3000             # 替代埠
#Listen 12.34.56.78:80   # 指定 IP:埠
#BindAddress *           # 綁定所有 IP (舊版語法)

模組載入 (DSO 機制)

#LoadModule anon_auth_module modules/ApacheModuleAuthAnon.dll
# 格式：LoadModule 模組名稱 模組檔案路徑
# 移除 # 啟用模組，Apache 2.0+ 建議使用 a2enmod 指令管理

主伺服器配置區塊

基本身份識別

ServerAdmin you@your.address  # 管理員信箱，錯誤頁面顯示
#ServerName new.host.name      # 伺服器主機名 (建議明確設定)
DocumentRoot "d:/Apache/htdocs" # 網站文件根目錄

目錄存取控制 <Directory>

<Directory />
    Options FollowSymLinks      # 允許符號連結
    AllowOverride None          # 禁止 .htaccess 覆蓋
</Directory>

# Options 參數說明：
# None       - 僅允許瀏覽
# FollowSymLinks - 允許符號連結
# ExecCGI    - 允許執行 CGI
# Includes   - 允許 SSI (Server Side Includes)
# Indexes    - 目錄無索引檔時顯示列表
# MultiViews - 內容協商 (多語言等)
# All        - 以上所有 (除 MultiViews)

使用者目錄與預設文件

UserDir "d:/Apache/users/"     # 使用者個人目錄映射 (~username)
DirectoryIndex index.html      # 預設首頁檔案順序
AccessFileName .htaccess       # 分散式配置檔名

URL 規範化與快取控制

UseCanonicalName On   # 使用 ServerName:Port 產生自參照 URL
#CacheNegotiatedDocs   # 代理伺服器快取協商文件 (通常不啟用)

虛擬主機相關指令 (Apache 1.1+)

<VirtualHost *:80>
    ServerName www.example.com
    ServerAlias example.com *.example.com  # 別名支援萬用字元
    DocumentRoot "/www/example"
    ServerPath /legacy/                    # 相容舊瀏覽器的路徑前綴
</VirtualHost>

Windows 專用指令

# CGI 腳本解譯器來源控制 (Windows only)
ScriptInterpreterSource registry|script
# registry: 從註冊表依副檔名查找解譯器
# script: 依腳本 #! 行指定解譯器 (預設)

網路緩衝調優

SendBufferSize 65536  # TCP 發送緩衝區大小 (位元組)，高延遲高頻寬環境建議調大

配置檢查與套用

# 語法檢查
apachectl configtest
# 或
httpd -t

# 平滑重啟 (不中斷現有連線)
apachectl graceful
# 或
httpd -k graceful

版本兼容性提示

• 本參考基於 Apache 1.3.12 Win32 版本
• Apache 2.0+ 採用 MPM 架構，部分配置語法不同 (如 Listen 取代 Port/BindAddress)
• 生產環境建議參考官方最新文檔：httpd.apache.org/docs