Настройка nginx на сервере: от установки до рабочего конфига
Nginx принимает HTTP-запросы и отдаёт статику или передаёт их PHP и другим сервисам. Настройка сводится к правке файлов в /etc/nginx/sites-available, проверке через sudo nginx -t и перезагрузке через sudo systemctl reload nginx. Ошибки видны в /var/log/nginx/error.log.
Что такое nginx и как он работает на сервере
Nginx это веб-сервер и обратный прокси. Он слушает порты 80 и 443, разбирает запрос, выбирает подходящий server по имени домена и порту, затем отдаёт файл с диска или передаёт запрос в PHP-FPM по сокету. Мастер-процесс читает конфиг и управляет рабочими процессами, поэтому перезагрузка конфига не рвёт соединения.
Установка nginx на Ubuntu 24.04
Пакет ставится из штатного репозитория Ubuntu. После установки сервис запускается сам и добавляется в автозагрузку. Проверьте состояние и версию, чтобы убедиться, что мастер-процесс работает.
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 кладут символические ссылки. Такой подход позволяет включать и выключать сайт без удаления его конфига.
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.
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.
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
Проверка и перезагрузка конфигурации
Синтаксическая ошибка в конфиге не даст nginx перезагрузиться. sudo nginx -t показывает файл и строку с проблемой. После успешной проверки применяйте изменения через reload, а не restart: рабочие процессы завершат текущие запросы.
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.
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
Руководства по теме10
- Docker nginx: установка и настройка обратного прокси
- Установка nginx на Ubuntu 24.04 и настройка сайта с PHP
- found nginx: почему nginx отдаёт 404 и как это исправить
- Nginx версии: установка и настройка на Ubuntu 24.04
- Настройка nginx location на Ubuntu 24.04
- Настройка сайта в nginx на Ubuntu 24.04
- Настройка WebSocket в nginx на Ubuntu 24.04
- Кэширование статики в nginx на Ubuntu 24.04
- Как настроить редирект с http на https в nginx
- CVE-2026-123007: уязвимость в HTTP/2 nginx и временная защита