К содержимому

Настройка nginx на сервере: от установки до рабочего конфига

Nginx принимает HTTP-запросы и отдаёт статику или передаёт их PHP и другим сервисам. Настройка сводится к правке файлов в /etc/nginx/sites-available, проверке через sudo nginx -t и перезагрузке через sudo systemctl reload nginx. Ошибки видны в /var/log/nginx/error.log.

Опорная Nginx 3 мин чтения 18 материалов в теме

Что такое nginx и как он работает на сервере

Nginx это веб-сервер и обратный прокси. Он слушает порты 80 и 443, разбирает запрос, выбирает подходящий server по имени домена и порту, затем отдаёт файл с диска или передаёт запрос в PHP-FPM по сокету. Мастер-процесс читает конфиг и управляет рабочими процессами, поэтому перезагрузка конфига не рвёт соединения.

Установка nginx на Ubuntu 24.04

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

bash
sudo apt update
sudo apt install nginx
sudo systemctl status nginx
nginx -v

Структура конфигурации и файлы сайтов

Главный файл /etc/nginx/nginx.conf подключает всё из /etc/nginx/conf.d/*.conf и /etc/nginx/sites-enabled/*. Сайты держат в sites-available, а в sites-enabled кладут символические ссылки. Такой подход позволяет включать и выключать сайт без удаления его конфига.

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

Минимальный server-блок для статического сайта

Директива server_name привязывает блок к домену, root задаёт каталог с файлами. location / с try_files сначала ищет реальный файл, затем каталог, иначе отдаёт 404. Для проверки конфига используйте sudo nginx -t, для применения sudo systemctl reload nginx.

nginx
server {
    listen 80;
    server_name example.com www.example.com;
    root /var/www/example.com;
    index index.html index.php;

    location / {
        try_files $uri $uri/ =404;
    }
}

Передача запросов в PHP 8.3 через PHP-FPM

PHP-файлы nginx сам не исполняет. Он передаёт их в PHP-FPM по Unix-сокету /run/php/php8.3-fpm.sock. Параметр SCRIPT_FILENAME должен указывать на реальный путь файла, иначе FPM вернёт File not found.

nginx
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

Проверка и перезагрузка конфигурации

Синтаксическая ошибка в конфиге не даст nginx перезагрузиться. sudo nginx -t показывает файл и строку с проблемой. После успешной проверки применяйте изменения через reload, а не restart: рабочие процессы завершат текущие запросы.

bash
sudo nginx -t
sudo systemctl reload nginx
sudo tail -n 50 /var/log/nginx/error.log

Безопасность: права, скрытые файлы, лимиты

Каталог сайта должен принадлежать пользователю www-data или отдельному пользователю, а конфиги в /etc/nginx доступны только root. Закройте доступ к .git, .env и резервным копиям через location. Ограничьте размер тела запроса директивой client_max_body_size, если форма или загрузка файлов падает с 413.

nginx
location ~ /\.(git|env|ht) {
    deny all;
}

client_max_body_size 20m;

Типичные ошибки и их причины

Ошибка 502 Bad Gateway означает, что PHP-FPM не отвечает или сокет указан неверно. 403 Forbidden возникает при отсутствии index или неверных правах на каталог. 404 на существующем файле часто связана с неверным root или порядком location.

Частые ошибки

  • Сайт включён копированием файла в sites-enabled вместо символической ссылки, и правки в sites-available не применяются.

    Удалите копию и создайте ссылку: sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/.

  • После правки конфига выполняется systemctl restart nginx, что обрывает активные соединения.

    Сначала проверьте синтаксис через sudo nginx -t, затем примените изменения через sudo systemctl reload nginx.

  • В fastcgi_pass указан несуществующий сокет, например php8.2-fpm.sock при установленном PHP 8.3.

    Сверьте путь с выводом ls /run/php/ и укажите unix:/run/php/php8.3-fpm.sock.

  • Каталог /var/www/example.com принадлежит root, и nginx не может прочитать файлы.

    Выдайте права пользователю www-data: sudo chown -R www-data:www-data /var/www/example.com.

Deploykin

Как это делается в Deploykin

В Deploykin сайт создаётся из панели, и конфиг nginx под Laravel, WordPress или PHP панель пишет сама. Править конфиги можно в редакторе панели: перед сохранением конфиг проверяется на сервере, а прежняя версия уходит в резервную копию.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Как проверить конфигурацию nginx перед перезагрузкой?

Выполните sudo nginx -t. Команда покажет путь к файлу и строку с ошибкой, если синтаксис нарушен.

Где nginx хранит конфиги сайтов?

В /etc/nginx/sites-available лежат полные конфиги, а в /etc/nginx/sites-enabled находятся символические ссылки на включённые сайты.

Почему nginx отдаёт 502 Bad Gateway?

Чаще всего PHP-FPM не запущен или сокет в fastcgi_pass указан неверно. Проверьте systemctl status php8.3-fpm и путь /run/php/php8.3-fpm.sock.

Как перезагрузить nginx без разрыва соединений?

Используйте sudo systemctl reload nginx после успешной проверки sudo nginx -t. Старые рабочие процессы завершат текущие запросы.

Всё по теме Nginx

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.