Как проверить nginx на ошибки

nginx поддерживает следующие параметры командной строки:

• -? | -h — вывод справки
  по параметрам командной строки.
• -c файл — использование альтернативного
  конфигурационного файла файл вместо файла по умолчанию.
• -e файл — использование альтернативного
  лог-файла ошибок файл
  вместо файла по умолчанию (1.19.5).
  Специальное значение stderr выбирает стандартный файл ошибок.
• -g директивы — задание
  глобальных директив конфигурации,
  например

  nginx -g "pid /var/run/nginx.pid; worker_processes `sysctl -n hw.ncpu`;"
  

• -p префикс — задание префикса пути nginx,
  т.е. каталога, в котором будут находиться файлы сервера
  (по умолчанию — каталог /usr/local/nginx).
• -q — вывод только сообщений об ошибках
  при тестировании конфигурации.
• -s сигнал — отправка сигнала
  главному процессу.
  Аргументом сигнал может быть:
  • stop — быстрое завершение
  • quit — плавное завершение
  • reload — перезагрузка конфигурации,
    старт нового рабочего процесса с новой конфигурацией,
    плавное завершение старых рабочих процессов.
  • reopen — переоткрытие лог-файлов
• -t — тестирование конфигурационного файла:
  nginx проверяет
  синтаксическую правильность конфигурации, а затем пытается открыть файлы,
  описанные в конфигурации.
• -T — то же, что и -t,
  а также вывод конфигурационных файлов
  в стандартный поток вывода (1.9.2).
• -v — вывод версии nginx.
• -V — вывод версии nginx, версии компилятора
  и параметров конфигурации сборки.

Перейти к содержимому

# nginx -c /usr/local/etc/nginx/nginx.conf -t

?2008/10/09 19:24:26 [info] 52494#0: the configuration file /usr/local/etc/nginx/nginx.conf syntax is ok2008/10/09 19:24:26 [info] 52494#0: the configuration file /usr/local/etc/nginx/nginx.conf was tested successfully

Nginx произносится как «движок x» — это бесплатный высокопроизводительный HTTP-сервер и обратный прокси-сервер с открытым исходным кодом, отвечающий за обработку нагрузки некоторых из крупнейших сайтов в Интернете. Его можно использовать как автономный веб-сервер и как обратный прокси-сервер для Apache и других веб-серверов.

Если вы разработчик или системный администратор, скорее всего, вы имеете дело с Nginx на регулярной основе.

В этом руководстве мы рассмотрим наиболее важные и часто используемые команды Nginx, включая запуск, остановку и перезапуск Nginx.

Подготовка

Мы предполагаем, что вы вошли в систему как root или пользователь с привилегиями sudo. Команды в этом g должны работать в любом современном дистрибутиве Linux, таком как Ubuntu 18.04, CentOS 8 и Debian 10 .

Запуск Nginx

Запустить Nginx довольно просто. Просто запустите следующую команду:

sudo systemctl start nginx

В случае успеха команда не производит никакого вывода.

Если вы используете дистрибутив Linux без systemd, для запуска Nginx введите:

sudo service start nginx

Вместо того, чтобы вручную запускать службу Nginx, рекомендуется настроить ее запуск при загрузке системы:

sudo systemctl enable nginx

Остановка Nginx

Остановка Nginx быстро завершает все рабочие процессы Nginx, даже если есть открытые соединения.

Чтобы остановить Nginx, выполните одну из следующих команд:

sudo systemctl stop nginxsudo service stop nginx

Перезапуск Nginx

Параметр перезапуска — это быстрый способ остановить, а затем запустить сервер Nginx.

Используйте одну из следующих команд для перезапуска Nginx :

sudo systemctl restart nginxsudo service restart nginx

Это команда, которую вы, вероятно, будете использовать наиболее часто.

Перезагрузка Nginx

Вам необходимо перезагрузить или перезапустить Nginx всякий раз, когда вы вносите изменения в его конфигурацию.

Команда reload загружает новую конфигурацию, запускает новые рабочие процессы с новой конфигурацией и корректно завершает работу старых рабочих процессов.

Чтобы перезагрузить Nginx, используйте одну из следующих команд:

sudo systemctl reload nginxsudo service reload nginx

Тестирование конфигурации Nginx

Всякий раз, когда вы вносите изменения в файл конфигурации сервера Nginx, рекомендуется проверить конфигурацию перед перезапуском или перезагрузкой службы.

Используйте следующую команду, чтобы проверить конфигурацию Nginx на наличие синтаксических или системных ошибок:

sudo nginx -t

Результат будет выглядеть следующим образом:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Если есть ошибки, команда выводит подробное сообщение.

Просмотр статуса Nginx

Чтобы проверить статус службы Nginx, используйте следующую команду:

sudo systemctl status nginx

Результат будет выглядеть примерно так:

 nginx.service - A high performance web server and a reverse proxy server
   Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
   Active: active (running) since Sun 2019-04-21 13:57:01 PDT; 5min ago
     Docs: man:nginx(8)
  Process: 4491 ExecStop=/sbin/start-stop-daemon --quiet --stop --retry QUIT/5 --pidfile /run/nginx.pid (code=exited, status=0/SUCCESS)
  Process: 4502 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
  Process: 4492 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
 Main PID: 4504 (nginx)
    Tasks: 3 (limit: 2319)
   CGroup: /system.slice/nginx.service
           |-4504 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
           |-4516 nginx: worker process
           `-4517 nginx: worker process

Проверка версии Nginx

Иногда вам может потребоваться узнать версию вашего Nginx, чтобы вы могли отладить проблему или определить, доступна ли определенная функция.

Вы можете проверить свою версию Nginx, запустив:

sudo nginx -v

nginx version: nginx/1.14.0 (Ubuntu)

Параметр -V отображает версию Nginx вместе с параметром настройки.

sudo nginx -V

Выводы

В этом руководстве мы показали вам некоторые из наиболее важных команд Nginx. Если вы хотите узнать больше о параметрах командной строки Nginx, посетите документацию Nginx .

Если у вас есть какие-либо вопросы или отзывы, не стесняйтесь оставлять комментарии.

После установка NGINX на Ubuntu Linux, либо как веб-сервер, либо обратный прокси-сервер, вам нужно будет изучить основы администрирования службы.

В этом руководстве мы покажем, как проверить статус NGINX в Ubuntu. Это предоставит вам информацию о состоянии службы NGINX, которая поможет вам определить, работает ли она, успешно ли принимает соединения и т. Д. Мы также объясним различные состояния NGINX, чтобы вы знали, что делать с представленной информацией.

В этом уроке вы узнаете:

• Как проверить статус NGINX с помощью systemd
• Как настроить и получить доступ к странице статуса NGINX
• Как проверить конфигурацию NGINX, перезапустить и перезагрузить службу

Проверка статуса NGINX с помощью systemd

Мы можем увидеть, работает ли NGINX в настоящее время, используя следующие systemctl команда.

$ systemctl status nginx. 

Есть несколько возможных результатов, которые вы можете увидеть при запуске этой команды. Если служба работает без проблем, она скажет «активен (работает)», как показано на скриншоте ниже.

Если NGINX не запущен и в последний раз был корректно завершен, вы увидите статус «неактивен (мертв)».

Если в NGINX произошел сбой или произошел сбой, в статусе может быть указано «сбой» с указанием причины сбоя. На скриншоте ниже сервис аварийно завершил работу в результате запуска команда kill, который нам указывает systemd.

В случае неправильно сконфигурированного файла NGINX состояние NGINX может указывать на то, что он вообще не мог запуститься.

Проверка статуса NGINX на странице статуса

Настройка страницы статуса NGINX может предоставить вам много информации об активных соединениях и другой статистике сервера.

Отредактируйте файл конфигурации вашего сайта NGINX и добавьте следующий блок кода в сервер директива.

местоположение / nginx_status {stub_status on; разрешить 127.0.0.1; все отрицать; }

Это позволит localhost (127.0.0.1) получить доступ к странице example.com/nginx_status чтобы увидеть страницу статуса NGINX.

Результат выглядит так, но будет иметь разные номера в зависимости от количества подключений к вашему серверу.

Активных подключений: 16. сервер принимает обработанные запросы 417 417 610 Чтение: 0 Запись: 3 Ожидание: 5. 

Вот подробное описание того, как интерпретировать данные:

• Активные связи: Общее количество открытых и активных подключений к NGINX.
• Три числа в третьей строке:
  1. Количество принятые соединения
  2. Количество обработанные соединения (обычно то же самое, что и принятые соединения)
  3. Общее количество клиентских запросов
• Чтение: Количество текущих подключений, в которых NGINX читает заголовок запроса.
• Пишу: Количество текущих подключений, в которых NGINX пишет ответ клиенту.
• Ожидающий:: Количество открытых соединений, которые неактивны и ждут запросов.

Проверьте конфигурацию NGINX, перезапустите и перезагрузите NGINX.

Теперь, когда вы знаете, как проверять статус NGINX, знание того, как проверять свою конфигурацию на наличие ошибок, также идет рука об руку, наряду с перезапуском и перезагрузкой NGINX.

Используйте следующую команду, чтобы проверить файлы конфигурации NGINX.

$ sudo nginx -t. nginx: синтаксис файла конфигурации /etc/nginx/nginx.conf в порядке. nginx: файл конфигурации /etc/nginx/nginx.conf прошел успешно. 

И ознакомьтесь с нашим руководством по как перезапустить или перезагрузить NGINX. для объяснения различий.

$ sudo systemctl перезапустить nginx. И. $ sudo systemctl перезагрузить nginx. 

Заключительные мысли

В этом руководстве мы увидели, как проверить статус NGINX в Ubuntu Linux. Это включало проверку службы с помощью systemctl, а также настройку и проверку страницы статуса NGINX. Мы также узнали, как проверить нашу конфигурацию NGINX на наличие ошибок и перезапустить или перезагрузить службу. Вся эта информация важна для веб-администраторов и должна помочь вам следить за состоянием вашего веб-сайта или обратного прокси-сервера.