Apache 通過 VirtualHost 實現單台服務器托管多個域名/站點。本文詳細講解基於名稱的虛擬主機配置、主機頭(ServerName/ServerAlias)設置、DocumentRoot 指向任意目錄及權限問題解決。
1. 開啟 NameVirtualHost(Apache 2.4 可省略)
# Apache 2.2 必須
NameVirtualHost *:80
# 2.4 會自動識別,無需此行
2. 完整虛擬主機配置示例
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot "F:/wwwroot/dede" # 站點根目錄
ServerName www.example.com # 主域名(主機頭)
ServerAlias example.com # 別名(無 www 也能訪問)
ErrorLog "logs/dede-error.log"
CustomLog "logs/dede-access.log" common
</VirtualHost>
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot "F:/wwwroot/wordpress"
ServerName wp.example.com
ServerAlias blog.example.com
</VirtualHost>
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot "F:/wwwroot/htdocs" # 默認/兜底站點
ServerName *
ServerAlias *
</VirtualHost>
3. 關鍵指令詳解
| 指令 | 作用 | 注意 |
ServerName | 主機頭主域名,必須準確 | DNS 已解析到此 IP |
ServerAlias | 附加域名,支持通配符 *.example.com | 多寫幾行或空格分隔 |
DocumentRoot | 網站文件物理路徑 | 使用正斜杠或雙反斜杠 |
ErrorLog/CustomLog | 獨立日誌文件 | 便於分站點分析 |
4. 跨目錄訪問權限問題(核心難點)
默認 <Directory /> 拒絕所有訪問,導致 DocumentRoot 指向非默認目錄(如 E:/htdocs)時返回 403 Forbidden: You don't have permission to access / on this server。
錯誤配置
<Directory />
Options FollowSymLinks
AllowOverride None
Order deny,allow
Deny from all
</Directory>
正確配置:為具體目錄授權
<Directory "F:/wwwroot/dede">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted # Apache 2.4 語法
</Directory>
<Directory "E:/htdocs">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
Apache 2.2 舊語法:Order allow,deny / Allow from all。
5. 常見陷阱與排查
- 配置不生效:修改
httpd.conf 或 extra/httpd-vhosts.conf 後必須 httpd -t 語法檢查並 reload/restart。
- 端口衝突:確保 80/443 未被佔用(
netstat -an | findstr :80)。
- Hosts 文件:本地測試需在
C:\Windows\System32\drivers\etc\hosts 添加 127.0.0.1 www.example.com。
- 大小寫敏感:Linux 下路徑區分大小寫,Windows 不區分。
- 編碼:配置文件保存為 UTF-8 無 BOM,避免中文路徑亂碼。
6. HTTPS/SSL 虛擬主機(補充)
<VirtualHost *:443>
ServerName secure.example.com
DocumentRoot "F:/wwwroot/secure"
SSLEngine on
SSLCertificateFile "conf/ssl/example.crt"
SSLCertificateKeyFile "conf/ssl/example.key"
<Directory "F:/wwwroot/secure">
Require all granted
</Directory>
</VirtualHost>
需在 httpd.conf 載入 mod_ssl 並 Listen 443。
總結
虛擬主機核心三步:NameVirtualHost → VirtualHost 塊配置 ServerName/DocumentRoot → Directory 授權。掌握此模式,即可在單台 Apache 上穩定運行數十個獨立站點。
copyright ©
萬盛學電腦網 all rights reserved