pid
`pid` 指令指定 NGINX 在以 daemon mode 运行时应将其进程 ID 写入的文件。 — NGINX Core
pid
main
语法pid file;
默认值none
上下文main
模块NGINX Core
参数1
说明
`pid` 指令在 NGINX 核心中用于定义一个文件的位置,该文件在 NGINX 启动时将包含主进程的进程 ID (PID)。这个 PID 文件对于管理 NGINX 进程至关重要,允许管理员轻松跟踪和控制进程,尤其是在执行诸如平滑关闭或重新加载等操作时。通过为该指令提供一个文件路径,NGINX 会在启动时创建该文件并将其 PID 写入其中。这有助于进程管理,确保系统管理员无需猜测进程 ID 就能有效管理服务。 `pid` 指令的参数是一个单一的参数,用于指定存储 PID 的文件路径。通常,该路径应设置为由运行 NGINX 进程的用户可写的位置,因此确保正确的权限很重要。如果由于权限问题或路径错误导致无法创建或写入指定的 PID 文件,NGINX 将报告错误并退出而不启动。因此,务必确保所提供的路径有效且可访问。`pid` 指令必须出现在主配置上下文,通常位于配置文件的顶层,在任何 server 或 location 块之前,因为它涉及整个 NGINX 进程而不是单个服务器进程。
配置示例
pid /var/run/nginx.pid;
⚠
确保指定的 PID 文件路径对运行 NGINX 的用户可写;否则 NGINX 将无法启动。
⚠
不要在对指定 PID 文件路径没有适当权限的情况下编译 NGINX;这可能导致启动失败。
⚠
如果更改 PID 文件位置,请在进行更改前停止 NGINX,因为如果进程已在运行,NGINX 不会自动更新 PID 文件。