Apache 本機配置基於域名的虛擬主機完整教學

在本機開發環境配置虛擬主機，可模擬真實域名存取，方便多專案並行開發。以下以 Windows + WAMP 為例，Linux/Mac 原理相同。

步驟 1：啟用虛擬主機設定檔

打開 httpd.conf，找到並取消註解：

# Virtual hosts
Include conf/extra/httpd-vhosts.conf

步驟 2：修改 hosts 檔案映射域名

編輯 C:\Windows\System32\drivers\etc\hosts（需管理員權限）：

127.0.0.1    myproject.local
127.0.0.1    api.myproject.local

建議使用 .local 或 .test 結尾，避免與真實域名衝突。

步驟 3：配置 httpd-vhosts.conf

確保啟用 NameVirtualHost：

NameVirtualHost *:80

新增虛擬主機區塊：

<VirtualHost *:80>
    ServerAdmin admin@myproject.local
    DocumentRoot "C:/wamp/www/myproject/public"
    ServerName myproject.local
    ServerAlias www.myproject.local
    ErrorLog "logs/myproject-error.log"
    CustomLog "logs/myproject-access.log" common
    
    <Directory "C:/wamp/www/myproject/public">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

步驟 4：保留 localhost 存取

若仍需 https://localhost 存取原有專案，需額外定義：

<VirtualHost *:80>
    ServerName localhost
    DocumentRoot "C:/wamp/www"
    <Directory "C:/wamp/www">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

並在 hosts 加入 127.0.0.1 localhost。

常見問題排查

• 403 Forbidden：檢查 <Directory> 區塊的 Require all granted
• 域名無法解析：確認 hosts 檔案生效（可 ipconfig /flushdns）
• 端口衝突：確認 80 埠未被佔用，或改用 8080

進階：使用泛域名

ServerAlias *.myproject.local

搭配 dnsmasq 可實現自動泛域名解析，適合多租戶 SaaS 開發。