Nginx

在本节中，我们将会介绍 Nginx UI 中关于 Nginx 控制命令、日志路径等参数的配置选项。

::: tip 提示自 v2.0.0-beta.3 版本起，我们将 nginx_log 配置项改名为 nginx。 :::

日志

Nginx 日志对于监控、排查问题和维护您的 Web 服务器至关重要。它们提供了有关服务器性能、用户行为和潜在问题的宝贵见解。

在本节中，我们将讨论两种主要类型的日志：访问日志和错误日志。

对于从 v1.5.2 或更早版本升级的 Nginx-UI Docker 用户，在配置 app.ini 之前，您需要在 nginx.conf 中添加单独的 access_log 和 error_log 指令。

在 Nginx-UI 容器中，/var/log/nginx/access.log 是一个指向 /dev/stdout 的符号链接，而 /var/log/nginx/error.log 是一个指向 /dev/stderr 的符号链接。这种设置允许您使用 docker logs nginx-ui 命令查看 Nginx 和 Nginx-UI 日志。然而，这两个设备不支持 tail 命令，因此有必要使用额外的日志文件来记录 Nginx 日志。

示例：

error_log /var/log/nginx/error.log notice;
error_log /var/log/nginx/error.local.log notice;

http {
...
    access_log /var/log/nginx/access.log main;
    access_log /var/log/nginx/access.local.log main;
...
}

之后，请在 app.ini 中设置 nginx 访问日志和错误日志路径，然后重新启动 nginx-ui。

示例：

[nginx_log]
AccessLogPath = /var/log/nginx/access.local.log
ErrorLogPath = /var/log/nginx/error.local.log

AccessLogPath

类型：string

此选项用于为 Nginx UI 设置 Nginx 访问日志的路径，以便我们在线查看日志内容。

::: tip 提示在 v2 版本中，我们会读取 nginx -V 命令的输出，以获取 Nginx 访问日志的默认路径。

如果您需要设置不同的路径，您可以使用此选项。 :::

ErrorLogPath

类型：string

此选项用于为 Nginx UI 设置 Nginx 错误日志的路径，以便我们在线查看日志内容。

::: tip 提示在 v2 版本中，我们会读取 nginx -V 命令的输出，以获取 Nginx 错误日志的默认路径。

如果您需要设置不同的路径，您可以使用此选项。 :::

服务监控与控制

在本节中，我们将会介绍 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

::: tip 提示我们建议使用 systemd 管理 Nginx 的用户，将这个值设置为 systemctl restart nginx。否则，当您在 Nginx UI 中重启 Nginx 后，将无法在 systemctl 中获取 Nginx 的准确状态。 :::

若此选项为空，则 Nginx UI 将使用以下命令关闭 Nginx 服务：

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

若无法从 nginx -V 中获得 --sbin-path 路径，则 Nginx UI 将使用以下命令启动 Nginx 服务：

nginx

若可以获取到 --sbin-path 路径，则 Nginx UI 将使用以下命令启动 Nginx 服务：

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

config-nginx.md 3.9 KB 文件历史 原始文件