Nginx версии: установка и настройка на Ubuntu 24.04
Ubuntu 24.04 ставит nginx 1.24 из своего репозитория. Настройка сводится к файлу сайта в /etc/nginx/sites-available/, симлинку в sites-enabled и проверке sudo nginx -t.
01Установите nginx
Пакет из репозитория Ubuntu 24.04 даёт nginx 1.24. После установки сервис запускается сам. Мастер-процесс работает от root, рабочие процессы от www-data.
sudo apt update
sudo apt install nginx
sudo systemctl status nginx
02Проверьте версию и общий конфиг
Версию показывает nginx -v, она же видна в пакете. Общий конфиг лежит в /etc/nginx/nginx.conf, дополнительные файлы подключаются из /etc/nginx/conf.d/*.conf. Сайты лежат в /etc/nginx/sites-available/ и включаются симлинком в /etc/nginx/sites-enabled/.
nginx -v
ls /etc/nginx/sites-available/
ls /etc/nginx/sites-enabled/
03Создайте конфиг сайта
Файл /etc/nginx/sites-available/example.com описывает один сайт. Для Laravel root смотрит в /var/www/example.com/public, а location / содержит try_files $uri $uri/ /index.php?$query_string;. Без try_files все адреса кроме главной отдают 404.
server {
listen 80;
server_name example.com;
root /var/www/example.com/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
04Включите сайт симлинком
nginx читает только файлы из sites-enabled. Симлинк связывает включённый сайт с файлом в sites-available. Если оставить файл только в sites-available, сайт не заработает.
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
05Установите PHP 8.3 и PHP-FPM
Для отдачи PHP нужен пакет php8.3-fpm, он создаёт сокет /run/php/php8.3-fpm.sock. Сниппет snippets/fastcgi-php.conf из пакета уже задаёт SCRIPT_FILENAME, PATH_INFO и проверку, что файл существует. Заголовки запроса, включая Cookie и X-CSRF-TOKEN, nginx передаёт в PHP-FPM сам.
sudo apt install php8.3-fpm
sudo systemctl status php8.3-fpm
ls /run/php/
06Выставьте права на файлы сайта
Владелец файлов сайта: пользователь, который деплоит. www-data нужно только чтение, а запись лишь туда, куда сайт пишет сам: storage и bootstrap/cache у Laravel, wp-content/uploads у WordPress. Каталоги 755, файлы 644. Права по всему пути показывает namei -l.
sudo chown -R deploy:deploy /var/www/example.com
sudo find /var/www/example.com -type d -exec chmod 755 {} \;
sudo find /var/www/example.com -type f -exec chmod 644 {} \;
namei -l /var/www/example.com/public/index.php
07Проверьте конфиг и перезагрузите nginx
sudo nginx -t проверяет все файлы конфига. sudo systemctl reload nginx применяет конфиг без обрыва соединений. Если в конфиге ошибка, reload не применяется, а nginx продолжает работать со старым.
sudo nginx -t
sudo systemctl reload nginx
08Проверьте, что сайт отвечает
Запрос curl -I показывает код ответа и заголовки. Код 200 означает, что nginx отдал страницу. Код 403 или 502 указывает на права или на PHP-FPM, причина видна в /var/log/nginx/error.log.
curl -I http://example.com/
sudo tail -n 50 /var/log/nginx/error.log
Частые ошибки
-
403 Forbidden, в error.log
open() "/var/www/example.com/public/index.php" failed (13: Permission denied).www-dataне может прочитать файл или войти в один из каталогов пути.Проверьте путь командой
namei -lи чтение командойsudo -u www-data cat <файл>. Поставьтеchmod 755на каталог без права входа иchmod 644на файл. Владельца всего сайта менять не нужно. -
502 Bad Gateway, в error.log
connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory). Файла сокета нет: PHP-FPM этой версии не запущен или не установлен, либо вfastcgi_passуказана другая версия PHP.Проверьте
ls /run/php/иsudo systemctl status php8.3-fpm. Запустите службу или исправьте версию вfastcgi_pass. -
413 Request Entity Too Large. Тело запроса больше
client_max_body_size, по умолчанию 1m.Увеличьте
client_max_body_sizeв блокеserver. Для загрузки файлов в PHP заодно поднимитеupload_max_filesizeиpost_max_sizeв/etc/php/8.3/fpm/php.ini. -
404 Not Found на всех адресах Laravel, кроме главной. В
location /нетtry_files, и nginx ищет файл по адресу вместо того, чтобы отдать запрос вindex.php.Добавьте в
location /строкуtry_files $uri $uri/ /index.php?$query_string;и перезагрузите nginx.
Deploykin
Как это делается в Deploykin
В Deploykin сайт создаётся из панели, и конфиг nginx под Laravel, WordPress или PHP панель пишет сама. Править конфиги можно в редакторе панели: перед сохранением конфиг проверяется на сервере, а прежняя версия уходит в резервную копию.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Какая версия nginx ставится на Ubuntu 24.04?
Из репозитория Ubuntu 24.04 ставится nginx 1.24. Версию после установки показывает команда nginx -v.
Чем отличаются sites-available и sites-enabled?
sites-available хранит файлы конфигов всех сайтов, а sites-enabled содержит симлинки на включённые. nginx читает только sites-enabled.
Как применить новый конфиг без обрыва соединений?
Сначала проверьте конфиг командой sudo nginx -t, затем выполните sudo systemctl reload nginx. При ошибке в конфиге nginx продолжит работать со старым.
Где смотреть логи nginx?
По умолчанию /var/log/nginx/access.log и /var/log/nginx/error.log. Если в конфиге сайта заданы свои access_log и error_log, логи пишутся туда.
Почему сайт отдаёт 403 Forbidden?
Чаще всего www-data не может прочитать файл или войти в каталог пути. Проверьте namei -l по пути из error.log и права 755 на каталоги, 644 на файлы.
Ещё по теме
- Руководство · Nginx Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
- Руководство · Nginx Установка nginx на Ubuntu 24.04 и настройка сайта с PHP Пошаговая установка nginx на Ubuntu 24.04: apt, настройка PHP 8.3 через php-fpm, конфиг сайта, логи и проверка через nginx -t и systemctl status.
- Руководство · Nginx found nginx: почему nginx отдаёт 404 и как это исправить Пошаговая инструкция: как найти причину 404 Not Found в nginx на Ubuntu 24.04, проверить конфиг, пути и права, перезагрузить nginx и убедиться, что страница…
- Руководство · Nginx Настройка nginx location на Ubuntu 24.04 Пошаговая настройка nginx на Ubuntu 24.04: установка, директива location, конфиг сайта, проверка синтаксиса и перезагрузка. Разбор частых ошибок.
- Руководство · Nginx Настройка сайта в nginx на Ubuntu 24.04 Пошаговая настройка сайта в nginx на Ubuntu 24.04: конфиг в sites-available, симлинк, проверка nginx -t, reload, права и PHP-FPM. Команды и проверка.
- Руководство · Nginx Настройка WebSocket в nginx на Ubuntu 24.04 Настройте проксирование WebSocket в nginx на Ubuntu 24.04: директивы Upgrade и Connection, location, проверка через curl и браузер, типичные ошибки 400 и 502.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы