NginxManager/README.md
2025-08-04 17:11:47 +08:00

2.1 KiB
Raw Blame History

NGINX 動態 Server 管理工具

此專案提供一個簡易的 PHP 網頁介面,可以動態新增和刪除 NGINX Server 配置,並即時重載 NGINX 配置,方便本地多專案開發環境管理。


主要功能

  • 顯示目前所有 NGINX 動態 Server以 conf.d/*.conf 設定檔為基礎)
  • 新增 Server指定 Port 與根目錄(根目錄為指定的相對路徑,會自動補上預設絕對路徑前綴)
  • 刪除 Server
  • 新增、刪除後自動重載 NGINX 配置
  • 預設排除保留端口(如 80、8080及已被使用的端口
  • 前端輸入檢查,避免重複端口與保留端口使用

系統需求

  • PHP 7.0 以上
  • NGINX 已安裝且可透過命令行重載
  • PHP 有權限讀寫 NGINX conf.d 目錄
  • 適用於 macOS 或 Linux 環境,路徑請自行調整

專案結構

nginx-manager/ │ ├── conf/ │ └── conf.d/ # NGINX 動態 Server 設定檔目錄 ├── index.php # 主頁面,顯示及新增刪除 Server ├── servers.php # 處理新增刪除 Server 請求並重載 NGINX └── README.md


使用說明

  1. 修改 servers.php 中的 $confDir$nginxExe 變數,設定對應的 NGINX 配置目錄與 nginx 可執行檔路徑

  2. 修改 index.php$basePath 變數(預設為 /Users/catantech/Desktop/,用於拼接使用者輸入的相對路徑)

  3. 將此專案放置於支援 PHP 的 Web 伺服器中(例如內建 PHP server 或 Apache

  4. 開啟瀏覽器進入 index.php,即可看到目前動態 Server並可新增或刪除

  5. 新增時,請輸入相對於 $basePath 的路徑(例如:Project/Line_Project_1/Official/out-dev


注意事項

  • 確保 PHP 執行者有讀寫 NGINX 動態設定檔目錄的權限

  • 新增 Server 會立即寫入設定檔並重載 NGINX請確保 NGINX 配置無誤,避免重載失敗

  • 本專案不包含完整的安全檢查,建議用於本地開發環境


授權

MIT License


聯絡

如有問題,歡迎聯絡建喵。