pid
Директива `pid` указывает файл, в который NGINX должен записать идентификатор процесса (PID) при запуске в режиме демона. — NGINX Core
Описание
Директива `pid` используется в ядре NGINX для задания расположения файла, который будет содержать идентификатор процесса (PID) мастер-процесса при запуске NGINX. Этот PID-файл имеет решающее значение для управления процессом NGINX, позволяя администраторам легко отслеживать и контролировать его, особенно при выполнении операций, таких как корректное завершение работы или перезагрузка. Указав для этой директивы путь к файлу, NGINX создаст этот файл и запишет в него свой PID при старте. Это облегчает управление процессом и гарантирует, что системные администраторы смогут эффективно управлять службой без необходимости угадывать идентификатор процесса. Параметр директивы `pid` — это единый аргумент, задающий путь к файлу, в котором будет сохраняться PID. Обычно этот путь указывается в место, доступное для записи пользователем, под которым выполняется процесс NGINX, поэтому важно обеспечить корректные права доступа. В случаях, когда указанный PID-файл не может быть создан или записан из-за проблем с правами доступа или неверного пути, NGINX выдаст ошибку и завершит работу, не запустившись. Поэтому необходимо убедиться, что указанный путь действителен и доступен. Директива `pid` должна находиться в основном контексте конфигурации, как правило на верхнем уровне конфигурационного файла, до любых блоков server или location, поскольку она относится ко всему процессу NGINX, а не к отдельным процессам серверов.
Пример конфига
pid /var/run/nginx.pid;
Убедитесь, что указанный путь к файлу PID доступен для записи пользователем, запускающим NGINX; в противном случае NGINX не запустится.
Не компилируйте NGINX без соответствующих прав для указанного пути к файлу PID; это может привести к сбоям при запуске.
Если вы меняете расположение файла PID, убедитесь, что остановили NGINX перед внесением этого изменения, поскольку он не обновит файл PID автоматически, если процесс уже запущен.