Настройка сайта в nginx на Ubuntu 24.04
Сайт в nginx настраивается одним файлом в /etc/nginx/sites-available/, симлинком в sites-enabled и перезагрузкой конфига. На Ubuntu 24.04 это nginx 1.24, сайт отдаётся от www-data.
01Проверьте, что nginx установлен
На сервере nginx уже должен работать: страница про установку не нужна. Одна команда покажет версию и путь к бинарнику. Если пакета нет, установите его командой sudo apt install nginx и вернитесь к проверке.
nginx -v
02Создайте файл конфига сайта
Конфиги сайтов лежат в /etc/nginx/sites-available/, общий конфиг в /etc/nginx/nginx.conf. Создайте файл для домена example.com с корнем в /var/www/example.com. Директива root указывает на каталог, откуда nginx берёт файлы.
server {
listen 80;
server_name example.com www.example.com;
root /var/www/example.com;
index index.html index.php;
access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;
location / {
try_files $uri $uri/ =404;
}
}
03Включите сайт симлинком
nginx читает только файлы из /etc/nginx/sites-enabled/. Симлинк связывает файл из sites-available с каталогом включённых сайтов. Если в sites-enabled остался default, его можно удалить, чтобы он не перехватывал запросы.
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo rm -f /etc/nginx/sites-enabled/default
04Проверьте конфиг и перезагрузите nginx
sudo nginx -t проверяет все файлы конфига и печатает syntax is ok и test is successful. Перезагрузка применяет конфиг без обрыва соединений. При ошибке nginx продолжает работать со старым конфигом, поэтому сначала исправьте файл.
sudo nginx -t
sudo systemctl reload nginx
05Выложите файлы и выставьте права
Файлы сайта кладутся в /var/www/example.com, владельцем остаётся пользователь, который деплоит. www-data нужно только чтение: каталоги 755, файлы 644. Права по всему пути показывает namei -l, а чтение от имени nginx проверяет sudo -u www-data cat.
sudo mkdir -p /var/www/example.com
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/index.html
sudo -u www-data cat /var/www/example.com/index.html
06Подключите PHP-FPM
Для PHP добавьте в location ~ \.php$ сниппет из пакета и сокет PHP 8.3. Сниппет fastcgi-php.conf уже задаёт SCRIPT_FILENAME и проверку существования файла. Заголовки запроса, включая Cookie, nginx передаёт в PHP-FPM сам, отдельные fastcgi_param для них не нужны.
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
07Проверьте, что сайт отвечает
Запрос с сервера покажет код ответа и заголовки. Код 200 значит, что конфиг, права и PHP-FPM в порядке. Если пришёл 403 или 502, причину ищите в /var/log/nginx/error.log по своему файлу лога.
curl -I http://example.com/
sudo tail -n 50 /var/log/nginx/error.log
Частые ошибки
-
Сайт включён только в
sites-available, симлинка вsites-enabledнет, и nginx отдаёт чужой сайт или 404.Создайте симлинк
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/и перезагрузите конфиг. -
После правки конфига выполнили
reloadбезsudo nginx -t, и nginx остался со старым конфигом.Сначала
sudo nginx -t, затемsudo systemctl reload nginx. Ошибка в конфиге не применяется, но и не роняет работающий nginx. -
На весь сайт сделали
chown -R www-data, и PHP может переписать собственный код.Верните владельца пользователю деплоя, а
www-dataоставьте чтение. Запись давайте только каталогам, куда сайт пишет сам. -
Загрузка файла больше 1 МБ возвращает 413 Request Entity Too Large.
Увеличьте
client_max_body_sizeв блокеserverи заодноupload_max_filesizeиpost_max_sizeв/etc/php/8.3/fpm/php.ini.
Deploykin
Как это делается в Deploykin
В Deploykin сайт создаётся из панели, и конфиг nginx под Laravel, WordPress или PHP панель пишет сама. Править конфиги можно в редакторе панели: перед сохранением конфиг проверяется на сервере, а прежняя версия уходит в резервную копию.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Где лежит конфиг сайта в nginx на Ubuntu 24.04?
Файл сайта создаётся в /etc/nginx/sites-available/, включается симлинком в /etc/nginx/sites-enabled/. Общий конфиг находится в /etc/nginx/nginx.conf.
Чем reload отличается от restart?
sudo systemctl reload nginx применяет новый конфиг без обрыва соединений. При ошибке в конфиге nginx продолжает работать со старым, а restart останавливает и запускает процесс заново.
Почему после правки конфига ничего не изменилось?
Конфиг не перезагружен или файл сайта не включён симлинком в sites-enabled. Проверьте sudo nginx -t и наличие симлинка.
Какие права нужны на файлы сайта?
Каталоги 755, файлы 644, владелец это пользователь деплоя. www-data достаточно чтения, запись нужна только в каталоги, куда сайт пишет сам.
Ещё по теме
- Руководство · 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 версии: установка и настройка на Ubuntu 24.04 Пошаговая настройка nginx на Ubuntu 24.04: установка версии 1.24, конфиг сайта, PHP 8.3, проверка nginx -t и reload, разбор ошибок 403, 502, 504.
- Руководство · Nginx Настройка nginx location на Ubuntu 24.04 Пошаговая настройка nginx на Ubuntu 24.04: установка, директива location, конфиг сайта, проверка синтаксиса и перезагрузка. Разбор частых ошибок.
- Руководство · Nginx Настройка WebSocket в nginx на Ubuntu 24.04 Настройте проксирование WebSocket в nginx на Ubuntu 24.04: директивы Upgrade и Connection, location, проверка через curl и браузер, типичные ошибки 400 и 502.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы