瀏覽器解析域名時,優先檢查本地 **Hosts 檔案**(`C:\Windows\System32\drivers\etc\hosts` / `/etc/hosts`),找不到才查詢 DNS。將自定義域名指向 `127.0.0.1` 即可在本機訪問。
127.0.0.1 myproject.local
127.0.0.1 api.myproject.local
::1 myproject.local # IPv6sudo vim /etc/hosts
# 末尾添加
127.0.0.1 myproject.local
::1 myproject.local
<VirtualHost *:80>
ServerName myproject.local
ServerAlias www.myproject.local
DocumentRoot "D:/www/myproject/public"
<Directory "D:/www/myproject/public">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog "logs/myproject-error.log"
CustomLog "logs/myproject-access.log" common
</VirtualHost>
<VirtualHost *:80>
ServerName api.myproject.local
DocumentRoot "D:/www/myproject-api/public"
<Directory "D:/www/myproject-api/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
server {
listen 80;
server_name myproject.local www.myproject.local;
root /var/www/myproject/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
<VirtualHost *:80>
ServerName dev.local
ServerAlias *.dev.local
VirtualDocumentRoot "D:/www/%1/public"
<Directory "D:/www">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
# 訪問 foo.dev.local → D:/www/foo/public
# 訪問 bar.dev.local → D:/www/bar/public
| 問題 | 解決 |
|---|---|
| 修改 hosts 後不生效 | 管理員權限編輯、檢查檔案編碼為 ANSI/UTF-8 無 BOM、執行 `ipconfig /flushdns` (Win) / `sudo dscacheutil -flushcache` (Mac) |
| Chrome 顯示「不安全」 | Chrome 強制 `.local` 等 TLD 使用 HTTPS。改用 `.test`、`.localhost`、`.invalid`、`.example` (RFC 6761 保留 TLD) 或配置本地 SSL |
| Docker 容器內無法解析 | 容器有獨立 `/etc/hosts`,需在 `docker run --add-host=myproject.local:host-gateway` 或 `extra_hosts` 配置 |
| 多專案端口衝突 | 統一用 80 埠 + 虛擬主機區分,避免 `:8080`、`:3000` 等 |