Установка nginx на Ubuntu 24.04 и настройка сайта с PHP
nginx ставится из штатного репозитория Ubuntu 24.04 одной командой sudo apt install nginx. Дальше нужен конфиг сайта и связка с PHP 8.3 через php-fpm, иначе PHP-файлы будут отдаваться как текст или возвращать 502. Проверка сводится к sudo nginx -t, перезагрузке службы и запросу к домену.
01Установите nginx из репозитория
Обновите список пакетов и поставьте nginx. В Ubuntu 24.04 в репозитории лежит nginx 1.24, этого достаточно для сайтов и проксирования. После установки служба запускается сама и включается в автозапуск.
sudo apt update
sudo apt install nginx
02Проверьте, что служба запущена
Команда systemctl status показывает состояние юнита и последние строки журнала. В выводе должно быть active (running). Если служба не поднялась, причина обычно в занятом порту 80 или в синтаксисе конфига.
sudo systemctl status nginx
03Разрешите трафик в firewall
Если включён ufw, откройте профили nginx. Профиль Nginx Full разрешает и 80, и 443. Без этого снаружи будет видна ошибка соединения, хотя локально служба работает.
sudo ufw allow 'Nginx Full'
sudo ufw status
04Установите PHP 8.3 и php-fpm
nginx не выполняет PHP сам, ему нужен php-fpm. В Ubuntu 24.04 это PHP 8.3, пакет php8.3-fpm поднимает отдельную службу на сокете. Дополнительно поставьте php8.3-mysql, если сайт работает с MySQL 8.
sudo apt install php8.3-fpm php8.3-mysql
sudo systemctl status php8.3-fpm
05Создайте каталог сайта и тестовый файл
Каталог сайта разместите в /var/www/example.com. Владельцем сделайте пользователя www-data, от которого работает php-fpm. Тестовый файл с phpinfo() покажет, что PHP действительно исполняется.
sudo mkdir -p /var/www/example.com
sudo chown -R www-data:www-data /var/www/example.com
echo '<?php phpinfo();' | sudo tee /var/www/example.com/index.php
06Напишите конфиг сайта
Файл конфига положите в /etc/nginx/sites-available/example.com. Блок server слушает 80 порт, отдаёт файлы из каталога сайта и передаёт .php в php-fpm через сокет /run/php/php8.3-fpm.sock. Директива try_files не даёт отдавать несуществующие файлы.
server {
listen 80;
server_name example.com www.example.com;
root /var/www/example.com;
index index.php index.html;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
07Включите сайт и проверьте конфиг
Симлинк в sites-enabled включает сайт, стандартный конфиг default при этом лучше убрать, чтобы он не перехватывал запросы. Перед перезагрузкой всегда запускайте sudo nginx -t: команда проверяет синтаксис и пути, при ошибке пишет файл и строку.
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload nginx
08Проверьте работу сайта и логи
Запросите домен или IP сервера через curl: в ответе должен быть код 200 и вывод phpinfo(). Если код 502, php-fpm не отвечает на сокете. Ошибки nginx пишет в /var/log/nginx/error.log, последние строки читаются через tail.
curl -I http://example.com
sudo tail -n 50 /var/log/nginx/error.log
Частые ошибки
-
После установки nginx в браузере открывается страница Apache или стандартная заглушка nginx.
Удалите симлинк
/etc/nginx/sites-enabled/defaultи перезагрузите nginx черезsudo systemctl reload nginx. Проверьте, что ваш конфиг включён вsites-enabled. -
PHP-файл скачивается как текст или возвращает 502 Bad Gateway.
Убедитесь, что служба
php8.3-fpmзапущена, а путь сокета вfastcgi_passсовпадает с/run/php/php8.3-fpm.sock. После правки конфига выполнитеsudo nginx -tи перезагрузите nginx. -
sudo nginx -tпадает сunexpected end of fileилиunknown directive.В конфиге пропущена закрывающая скобка или опечатка в имени директивы. Сообщение указывает файл и строку, исправьте её и повторите проверку.
-
Снаружи сайт не открывается, хотя локально
curlотвечает.Откройте порты в ufw командой
sudo ufw allow 'Nginx Full'и проверьте, что провайдер не блокирует 80 и 443 на уровне сети.
Deploykin
Как это делается в Deploykin
В Deploykin сайт создаётся из панели, и конфиг nginx под Laravel, WordPress или PHP панель пишет сама. Править конфиги можно в редакторе панели: перед сохранением конфиг проверяется на сервере, а прежняя версия уходит в резервную копию.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Какая версия nginx ставится на Ubuntu 24.04?
Из штатного репозитория ставится nginx 1.24. Более новые версии берут из официального репозитория nginx, но для большинства сайтов хватает пакета из Ubuntu.
Зачем нужен php-fpm, если PHP уже установлен?
nginx не умеет исполнять PHP и передаёт запросы внешнему процессу. php-fpm принимает их через сокет, поэтому без запущенной службы php8.3-fpm сайт вернёт 502.
Где смотреть ошибки nginx?
Основной журнал ошибок лежит в /var/log/nginx/error.log, журналы доступа по сайтам в /var/log/nginx/access.log. Читать удобно через sudo tail -n 50 /var/log/nginx/error.log.
Чем отличается reload от restart?
reload перечитывает конфиг без разрыва текущих соединений, restart останавливает и запускает службу заново. После правки конфига достаточно sudo systemctl reload nginx.
Ещё по теме
- Руководство · Nginx Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
- Руководство · 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 Настройка сайта в 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 на сервере: от установки до рабочего конфига: все материалы темы