Skip to content

Nginx

在本節中,我們將介紹 Nginx UI 中關於 Nginx 控制命令、日誌路徑等參數的配置選項。

提示

自 v2.0.0-beta.3 版本起,我們將 nginx_log 配置項改名為 nginx

日誌

Nginx 日誌對於監控、排查問題和維護您的 Web 伺服器至關重要。它們提供了有關伺服器性能、用戶行為和潛在問題的寶貴見解。

AccessLogPath

  • 類型:string

此選項用於為 Nginx UI 設置 Nginx 訪問日誌的路徑,以便我們在線查看日誌內容。

提示

在 v2 版本中,我們會讀取 nginx -V 命令的輸出,以獲取 Nginx 訪問日誌的默認路徑。

如果您需要設置不同的路徑,您可以使用此選項。

ErrorLogPath

  • 類型:string

此選項用於為 Nginx UI 設置 Nginx 錯誤日誌的路徑,以便我們在線查看日誌內容。

提示

在 v2 版本中,我們會讀取 nginx -V 命令的輸出,以獲取 Nginx 錯誤日誌的默認路徑。

如果您需要設置不同的路徑,您可以使用此選項。

LogDirWhiteList

  • 類型:[]string
  • 版本:>= v2.0.0-beta.36
  • 示例:/var/log/nginx,/var/log/sites

此選項用於為 Nginx UI 設置日誌查看器的目錄白名單。

警告

出於安全原因,您必須指定存儲日誌的目錄。

只有這些目錄中的日誌可以在線查看。

服務監控與控制

在本節中,我們將會介紹 Nginx UI 中關於 Nginx 服務的監控和控制命令的配置選項。

ConfigDir

  • 類型:string

此選項用於設置 Nginx 配置文件夾的路徑。

在 v2 版

本中,我們會讀取 nginx -V 命令的輸出,以獲取 Nginx 配置文件的默認路徑。

如果您需要覆蓋默認路徑,您可以使用此選項。

PIDPath

  • 類型:string

此選項用於設置 Nginx PID 文件的路徑。Nginx UI 將通過判斷該文件是否存在來判斷 Nginx 服務的運行狀態。

在 v2 版本中,我們會讀取 nginx -V 命令的輸出,以獲取 Nginx PID 文件的默認路徑。

如果您需要覆蓋默認路徑,您可以使用此選項。

TestConfigCmd

  • 類型:string
  • 默認值:nginx -t

此選項用於設置 Nginx 測試配置的命令。

ReloadCmd

  • 類型:string
  • 默認值:nginx -s reload

此選項用於設置 Nginx 重新加載配置的命令。

RestartCmd

  • 類型:string

提示

我們建議使用 systemd 管理 Nginx 的用戶,將這個值設置為 systemctl restart nginx。 否則,當您在 Nginx UI 中重啟 Nginx 後,將無法在 systemctl 中獲取 Nginx 的準確狀態。

若此選項為空,則 Nginx UI 將使用以下命令關閉 Nginx 服務:

bash
start-stop-daemon --stop --quiet --oknodo --retry=TERM/30/KILL/5 --pidfile $PID

若無法從 nginx -V 中獲得 --sbin-path 路徑,則 Nginx UI 將使用以下命令開啟 Nginx 服務:

bash
start-stop-daemon --start --quiet --pidfile $PID --exec $SBIN_PATH

Released under the AGPL-3.0 License. (835349c3)