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

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

Директива location в nginx задаёт, какой обработчик получит запрос по определённому пути. На чистом сервере Ubuntu 24.04 вы устанавливаете nginx, создаёте конфиг сайта с блоками location и проверяете его командой sudo nginx -t. После перезагрузки службы запросы к / и /api/ уходят в разные места.

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

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

Обновите список пакетов и установите nginx из репозитория Ubuntu. После установки служба запускается автоматически и слушает порт 80. Проверьте, что пакет встал без ошибок.

bash
sudo apt update
sudo apt install nginx

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

Файл сайта размещается в /etc/nginx/sites-available/example.com. Внутри блока server директива location / отдаёт статику из /var/www/example.com, а location /api/ передаёт запросы на локальный PHP-FPM через сокет. Порядок и точность префиксов важны: nginx выбирает самый длинный совпавший префикс.

nginx
server {
    listen 80;
    server_name example.com;

    root /var/www/example.com;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location /api/ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

03Включите сайт и проверьте синтаксис

Симлинк из sites-available в sites-enabled подключает конфиг к основному файлу nginx. Перед перезагрузкой всегда запускайте sudo nginx -t: команда покажет строку с ошибкой, если скобка не закрыта или директива написана неверно. Симлинк по умолчанию /etc/nginx/sites-enabled/default можно удалить, чтобы он не перехватывал запросы.

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t

04Перезагрузите nginx и проверьте статус

Команда reload применяет новый конфиг без разрыва текущих соединений. Затем status показывает, что служба активна и запущена. Если nginx не поднялся, причина будет в выводе systemctl или в логе ошибок.

bash
sudo systemctl reload nginx
sudo systemctl status nginx

05Проверьте, что location работают

Запрос к корню должен вернуть файл из /var/www/example.com, а запрос к /api/ уйти в PHP-FPM. Смотрите код ответа и заголовки через curl. Если в ответе 404 на /api/, проверьте путь к сокету PHP и наличие файла index.php в каталоге API.

bash
curl -I http://example.com/
curl -I http://example.com/api/
sudo tail -n 50 /var/log/nginx/error.log

Частые ошибки

  • После правки конфига nginx не перезагружается, в выводе nginx: [emerg] unexpected end of file.

    В файле не закрыта фигурная скобка блока server или location. Откройте конфиг и проверьте парность скобок, затем снова выполните sudo nginx -t.

  • Запрос к /api/ возвращает 404, хотя файл существует.

    В location /api/ не указан try_files или неверный путь к сокету PHP-FPM. Проверьте, что сокет /run/php/php8.3-fpm.sock существует, и добавьте try_files $uri =404; перед fastcgi_pass.

  • Сайт открывается по IP, но не по домену, или отдаётся стандартная страница nginx.

    Симлинк в sites-enabled не создан, или активен дефолтный сайт. Удалите /etc/nginx/sites-enabled/default и создайте ссылку командой sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/.

Deploykin

Как это делается в Deploykin

В Deploykin сайт создаётся из панели, и конфиг nginx под Laravel, WordPress или PHP панель пишет сама. Править конфиги можно в редакторе панели: перед сохранением конфиг проверяется на сервере, а прежняя версия уходит в резервную копию.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем отличаются location / и location = /?

location = / совпадает только с точным путём /, а location / работает как префикс для всех путей, которые не перехватил более длинный блок. Точное совпадение имеет приоритет выше префиксного.

Где хранится основной конфиг nginx в Ubuntu 24.04?

Основной файл: /etc/nginx/nginx.conf. Конфиги сайтов лежат в /etc/nginx/sites-available/, а активные подключаются симлинками из /etc/nginx/sites-enabled/.

Что делать, если sudo nginx -t пишет unknown directive?

Директива написана с опечаткой или находится в неправильном контексте, например fastcgi_pass вне блока location. Проверьте строку, которую показывает команда, и сверьте имя директивы с документацией.

Нужно ли перезапускать nginx после каждой правки конфига?

Достаточно sudo systemctl reload nginx. Полный перезапуск restart обрывает соединения и нужен только при смене модулей или портов.

Ещё по теме

Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы

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