萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 電腦基礎知識 >  >> 電腦基本常識

Mac 安裝 Nginx 權限 403 Forbidden 解決:目錄執行權限缺失

在 macOS 上透過 Homebrew 安裝 Nginx (`brew install nginx`) 後,PHP 檔案正常執行,但靜態資源 (圖片、CSS、JS) 卻回傳 403 Forbidden。經排查發現,Nginx 執行用戶 (通常為 `www` 或 `_www`) 無法遍歷父目錄,導致無法讀取靜態檔案。根因在於家目錄 (`/Users/username`) 缺少「其他用戶執行權限 (o+x)」。

問題重現

  • Nginx 設定 `root /Users/han/Documents/git/msg/web/public;`
  • PHP 處理正常 (FastCGI 經由 127.0.0.1:9000)
  • 靜態檔案 `location ~* \.(js|css|png|jpg|jpeg|gif|ico)$` 回傳 403
  • 檔案權限已設 755/644,SELinux/AppArmor 無關 (macOS 無此機制)

核心解決方案:補足父目錄執行權限

Nginx worker process 以非 root 用戶運行,需對 從根目錄到網站根目錄的完整路徑 具備 執行權限 (x) 才能遍歷目錄結構讀取檔案。

# 檢查關鍵目錄權限
ls -ld /Users /Users/han /Users/han/Documents /Users/han/Documents/git /Users/han/Documents/git/msg/web/public

# 典型輸出顯示 Documents 缺少 o+x
drwx------+ 12 han  staff  384  4 25 10:00 /Users/han/Documents

修復指令

# 為「其他用戶」添加執行權限 (o+x) 於缺失目錄
chmod o+x /Users/han/Documents
# 若上層目錄亦缺失,同樣補充
chmod o+x /Users/han
chmod o+x /Users/han/Documents/git
# ... 依此類推至網站根目錄

驗證修復

  1. 重啟 Nginx:`sudo nginx -s reload`
  2. 瀏覽器重新整理,靜態資源應正常載入 (200 OK)。

原理深度解析

  • Unix/Linux/macOS 檔案系統權限模型:讀取目錄內容需 `r`,進入/遍歷目錄需 `x`。
  • 家目錄預設權限 `drwx------` (700) 僅擁有者可存取,保護隱私。
  • Web 伺服器進程非擁有者,屬於「其他用戶」類別,缺 `o+x` 無法 `cd` 進入該目錄尋找檔案,故回傳 403。
  • PHP-FPM 通常以同用戶運行或經由 socket 通訊,權限模型不同,故 PHP 檔案可執行。

最佳實踐建議

  • 生產/開發環境建議將網站根目錄放在 /var/www、/opt/www、/srv/www 等標準路徑,避開家目錄權限陷阱。
  • 若必須放家目錄,僅對必要父目錄加 `o+x`,切勿 `chmod -R 755 /Users/han` 破壞隱私。
  • 使用 Docker 容器化部署可完美隔離權限與環境差異。

一行 `chmod o+x` 解決 macOS Nginx 靜態檔案 403 疑難雜症,根治權限遍歷機制誤解。

copyright © 萬盛學電腦網 all rights reserved