1- # Nginx 日誌
1+ # Nginx
22
3- Nginx 日誌對於監控、排查問題和維護您的 Web 伺服器至關重要。它們提供了有關伺服器效能、使用者行為和潛在問題的寶貴見解。在本節中，我們將討論兩種主要型別的日誌：訪問日誌和錯誤日誌 。
3+ 在本節中，我們將介紹 Nginx UI 中關於 Nginx 控制命令、日誌路徑等參數的配置選項 。
44
5- 對於從 v1.5.2 或更早版本升級的 Nginx-UI Docker 使用者，在配置 ` app.ini ` 之前，至關重要的是在您的 ` nginx.conf `
6- 中新增單獨的 ` access_log ` 和 ` error_log ` 指令。
5+ ::: tip 提示
6+ 自 v2.0.0-beta.3 版本起，我們將 ` nginx_log ` 配置項改名為 ` nginx ` 。
7+ :::
78
8- 在 Nginx-UI 容器中，` /var/log/nginx/access.log ` 是一個指向 ` /dev/stdout ` 的符號連結，而 ` /var/log/nginx/error.log `
9- 是一個指向 ` /dev/stderr ` 的符號連結。這種設定允許您使用 ` docker logs nginx-ui ` 命令檢視 Nginx 和 Nginx-UI 日誌。然而，這兩個裝置不支援
10- ` tail ` 命令，因此有必要使用額外的日誌檔案來記錄 Nginx 日誌。
9+ ## 日誌
10+ Nginx 日誌對於監控、排查問題和維護您的 Web 伺服器至關重要。它們提供了有關伺服器性能、用戶行為和潛在問題的寶貴見解。
1111
12- 示例：
12+ 在本節中，我們將討論兩種主要類型的日誌：訪問日誌和錯誤日誌。
13+
14+ 對於從 v1.5.2 或更早版本升級的 Nginx-UI Docker 用戶，在配置 ` app.ini ` 之前，您需要在 ` nginx.conf `
15+ 中添加單獨的 ` access_log ` 和 ` error_log ` 指令。
16+
17+ 在 Nginx-UI 容器中，` /var/log/nginx/access.log ` 是一個指向 ` /dev/stdout ` 的符號鏈接，而 ` /var/log/nginx/error.log `
18+ 是一個指向 ` /dev/stderr ` 的符號鏈接。這種設置允許您使用 ` docker logs nginx-ui ` 命令查看 Nginx 和 Nginx-UI 日誌。然而，這兩個設備不支持
19+ ` tail ` 命令，因此有必要使用額外的日誌文件來記錄 Nginx 日誌。
20+
21+ 範例：
1322
1423``` nginx
1524error_log /var/log/nginx/error.log notice;
@@ -23,24 +32,92 @@ http {
2332}
2433```
2534
26- 此外，在 ` app.ini ` 中設定 nginx 訪問日誌和錯誤日誌路徑，然後重新啟動 nginx-ui。
35+ 之後，請在 ` app.ini ` 中設置 nginx 訪問日誌和錯誤日誌路徑，然後重新啟動 nginx-ui。
2736
28- 示例 ：
37+ 範例 ：
2938
3039``` ini
3140[nginx_log]
3241AccessLogPath = /var/log/nginx/access.local.log
3342ErrorLogPath = /var/log/nginx/error.local.log
3443```
3544
36- ## AccessLogPath
45+ ### AccessLogPath
46+
47+ - 類型：` string `
48+
49+ 此選項用於為 Nginx UI 設置 Nginx 訪問日誌的路徑，以便我們在線查看日誌內容。
50+
51+ ::: tip 提示
52+ 在 v2 版本中，我們會讀取 ` nginx -V ` 命令的輸出，以獲取 Nginx 訪問日誌的默認路徑。
53+
54+ 如果您需要設置不同的路徑，您可以使用此選項。
55+ :::
56+
57+ ### ErrorLogPath
58+
59+ - 類型：` string `
60+
61+ 此選項用於為 Nginx UI 設置 Nginx 錯誤日誌的路徑，以便我們在線查看日誌內容。
62+
63+ ::: tip 提示
64+ 在 v2 版本中，我們會讀取 ` nginx -V ` 命令的輸出，以獲取 Nginx 錯誤日誌的默認路徑。
65+
66+ 如果您需要設置不同的路徑，您可以使用此選項。
67+ :::
68+
69+ ## 服務監控與控制
70+
71+ 在本節中，我們將會介紹 Nginx UI 中關於 Nginx 服務的監控和控制命令的配置選項。
72+
73+ ### ConfigDir
74+ - 類型：` string `
3775
38- - 型別： ` string `
76+ 此選項用於設置 Nginx 配置文件夾的路徑。
3977
40- 此選項用於為 Nginx UI 設定 Nginx 訪問日誌的路徑，以便我們線上檢視日誌內容。
78+ 在 v2 版
4179
42- ## ErrorLogPath
80+ 本中，我們會讀取 ` nginx -V ` 命令的輸出，以獲取 Nginx 配置文件的默認路徑。
4381
44- - 型別： ` string `
82+ 如果您需要覆蓋默認路徑，您可以使用此選項。
4583
46- 此選項用於為 Nginx UI 設定 Nginx 錯誤日誌的路徑，以便我們線上檢視日誌內容。
84+ ### PIDPath
85+ - 類型：` string `
86+
87+ 此選項用於設置 Nginx PID 文件的路徑。Nginx UI 將通過判斷該文件是否存在來判斷 Nginx 服務的運行狀態。
88+
89+ 在 v2 版本中，我們會讀取 ` nginx -V ` 命令的輸出，以獲取 Nginx PID 文件的默認路徑。
90+
91+ 如果您需要覆蓋默認路徑，您可以使用此選項。
92+
93+ ### TestConfigCmd
94+ - 類型：` string `
95+ - 默認值：` nginx -t `
96+
97+ 此選項用於設置 Nginx 測試配置的命令。
98+
99+ ### ReloadCmd
100+ - 類型：` string `
101+ - 默認值：` nginx -s reload `
102+
103+ 此選項用於設置 Nginx 重新加載配置的命令。
104+
105+ ### RestartCmd
106+ - 類型：` string `
107+
108+ ::: tip 提示
109+ 我們建議使用 systemd 管理 Nginx 的用戶，將這個值設置為 ` systemctl restart nginx ` 。
110+ 否則，當您在 Nginx UI 中重啟 Nginx 後，將無法在 systemctl 中獲取 Nginx 的準確狀態。
111+ :::
112+
113+ 若此選項為空，則 Nginx UI 將使用以下命令關閉 Nginx 服務：
114+
115+ ``` bash
116+ start-stop-daemon --stop --quiet --oknodo --retry=TERM/30/KILL/5 --pidfile $PID
117+ ```
118+
119+ 若無法從 ` nginx -V ` 中獲得 ` --sbin-path ` 路徑，則 Nginx UI 將使用以下命令開啟 Nginx 服務：
120+
121+ ``` bash
122+ start-stop-daemon --start --quiet --pidfile $PID --exec $SBIN_PATH
123+ ```
0 commit comments