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

Настройка сайта в nginx на Ubuntu 24.04

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

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

01Проверьте, что nginx установлен

На сервере nginx уже должен работать: страница про установку не нужна. Одна команда покажет версию и путь к бинарнику. Если пакета нет, установите его командой sudo apt install nginx и вернитесь к проверке.

bash
nginx -v

02Создайте файл конфига сайта

Конфиги сайтов лежат в /etc/nginx/sites-available/, общий конфиг в /etc/nginx/nginx.conf. Создайте файл для домена example.com с корнем в /var/www/example.com. Директива root указывает на каталог, откуда nginx берёт файлы.

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, его можно удалить, чтобы он не перехватывал запросы.

bash
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 продолжает работать со старым конфигом, поэтому сначала исправьте файл.

bash
sudo nginx -t
sudo systemctl reload nginx

05Выложите файлы и выставьте права

Файлы сайта кладутся в /var/www/example.com, владельцем остаётся пользователь, который деплоит. www-data нужно только чтение: каталоги 755, файлы 644. Права по всему пути показывает namei -l, а чтение от имени nginx проверяет sudo -u www-data cat.

bash
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 для них не нужны.

nginx
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 по своему файлу лога.

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

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