Настройка nginx location на Ubuntu 24.04
Директива location в nginx задаёт, какой обработчик получит запрос по определённому пути. На чистом сервере Ubuntu 24.04 вы устанавливаете nginx, создаёте конфиг сайта с блоками location и проверяете его командой sudo nginx -t. После перезагрузки службы запросы к / и /api/ уходят в разные места.
01Установите nginx
Обновите список пакетов и установите nginx из репозитория Ubuntu. После установки служба запускается автоматически и слушает порт 80. Проверьте, что пакет встал без ошибок.
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 выбирает самый длинный совпавший префикс.
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 можно удалить, чтобы он не перехватывал запросы.
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t
04Перезагрузите nginx и проверьте статус
Команда reload применяет новый конфиг без разрыва текущих соединений. Затем status показывает, что служба активна и запущена. Если nginx не поднялся, причина будет в выводе systemctl или в логе ошибок.
sudo systemctl reload nginx
sudo systemctl status nginx
05Проверьте, что location работают
Запрос к корню должен вернуть файл из /var/www/example.com, а запрос к /api/ уйти в PHP-FPM. Смотрите код ответа и заголовки через curl. Если в ответе 404 на /api/, проверьте путь к сокету PHP и наличие файла index.php в каталоге API.
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 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 на 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 на сервере: от установки до рабочего конфига: все материалы темы