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

Nginx версии: установка и настройка на Ubuntu 24.04

Ubuntu 24.04 ставит nginx 1.24 из своего репозитория. Настройка сводится к файлу сайта в /etc/nginx/sites-available/, симлинку в sites-enabled и проверке sudo nginx -t.

Руководство Nginx 3 мин чтения

01Установите nginx

Пакет из репозитория Ubuntu 24.04 даёт nginx 1.24. После установки сервис запускается сам. Мастер-процесс работает от root, рабочие процессы от www-data.

bash
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/.

bash
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.

nginx
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, сайт не заработает.

bash
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 сам.

bash
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.

bash
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 продолжает работать со старым.

bash
sudo nginx -t
sudo systemctl reload nginx

08Проверьте, что сайт отвечает

Запрос curl -I показывает код ответа и заголовки. Код 200 означает, что nginx отдал страницу. Код 403 или 502 указывает на права или на PHP-FPM, причина видна в /var/log/nginx/error.log.

bash
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 на сервере: от установки до рабочего конфига: все материалы темы

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