Примеры директивы location в Nginx

Nginx позволяет вкладывать блоки location в другие блоки location для более детального управления.

location /nested {
    location /nested/subnested {
        root /var/www/html;
    }
    root /var/www/html;
}

В этом примере запросы к /nested/subnested будут обрабатываться внутренним блоком location, а запросы к /nested (но не к /nested/subnested) будут обрабатываться внешним блоком location.

Пример реального веб-сервера

Давайте рассмотрим практический пример настройки локального веб-сервера с несколькими блоками location.

server {
    listen 80;
    server_name localhost;

    # Блок location root
    location / {
        root /var/www/html;
        index index.html;
    }

    # Точное соответствие для конкретной страницы
    location = /about {
        root /var/www/html;
        index about.html;
    }

    # Совпадение префикса с конечной точкой API
    location /api {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Соответствие регулярных выражений для PHP-файлов
    location ~ \.php$ {
        root /var/www/html;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi_params;
    }

    # Соответствие файлам изображений без учета регистра
    location ~* \.(jpg|jpeg|png|gif|ico)$ {
        root /var/www/images;
    }

    # Вложенные блоки расположения для административного раздела
    location /admin {
        root /var/www/admin;
        index index.html;

        location /admin/stats {
            proxy_pass http://localhost:8080/stats;
        }
    }
}

В этой конфигурации:

• В корневом каталоге хранятся статические файлы из /var/www/html.
• Запросы на /about обслуживаются блоком точного соответствия, указывающим на about.html.
• Префикс /api перенаправляется на серверную службу, работающую на порту 3000.
• PHP-файлы обрабатываются сервером FastCGI.
• Файлы изображений передаются с /var/www/images.
• Вложенные блоки location используются для обработки /admin и /admin/stats с различными настройками.

Основной файл конфигурации Nginx содержит основные директивы конфигурации для сервера Nginx. Расположение файла конфигурации Nginx обычно /etc/nginx/nginx.conf.

После изменения конфигурации Nginx необходимо перезапустить службу, чтобы применить изменения. Это можно сделать без разрыва активных соединений, выполнив:

sudo systemctl reload nginx

Тестирование и отладка блоков location

Перед развёртыванием или использованием конфигурации NGINX важно убедиться, что каждый блок location работает должным образом. Мы предоставим простые способы тестирования вашей конфигурации, выявления ошибок на ранних этапах и устранения распространённых проблем с помощью встроенных инструментов, таких как curl и файлы журналов.

Проверьте синтаксис конфигурации, прежде чем применять изменения таким образом:

sudo nginx -t

Затем перезагрузите NGINX, чтобы применить изменения без удаления активных подключений:

sudo systemctl reload nginx

Протестируйте поведение местоположения с помощью curl и отправляйте запросы, чтобы проверить, отвечает ли правильный блок location:

curl -I http://localhost/about
curl -X POST http://localhost/prefix/form
curl -H "User-Agent: Chrome" http://localhost/exact-match

Проверьте наличие кодов состояния, заголовков и содержимого.

Просмотр обработки запросов и ошибок в режиме реального времени:

tail -f /var/log/nginx/access.log
tail -f /var/log/nginx/error.log

Давайте запишем контрольный список устранения неполадок в блоке location.

• Запускал nginx -t? Убедитесь, что синтаксис конфигурации допустим.
• Перезагрузил NGINX? Не забудьте перезагрузить после внесения изменений.
• Соответствует ли запрос в точности? Убедитесь, что запрашиваемый URI соответствует ожидаемому блоку (учитывайте конечные косые черты).
• Правильно ли установлен приоритет блока? Проверьте, не перехватывает ли управление блок с более высоким приоритетом.
• Существует ли корневой путь? Убедитесь, что корневой путь или псевдоним указывают на действительный каталог/файл.
• Использовали curl или инструменты браузера? Изучите детали запроса/ответа, чтобы отследить поведение.
• Вы проверили журналы? Поищите записи в журналах доступа и ошибок, связанные с вашим запросом.
• Вы пробовали изолировать блок? Временно закомментируйте другие блоки, чтобы определить, какой из них обрабатывает запрос.

Ограничение доступа к xувствительным местам

Для обеспечения безопасности разумно ограничить доступ к частным маршрутам, таким как /admin, /config, или внутренним инструментам. Директивы allow и deny в NGINX позволяют контролировать доступ на основе IP-адреса.

location /admin {
    allow 192.168.1.100;
    deny all;
    root /var/www/admin;
    index index.html;
}

В этом случае путь /admin может быть доступен только клиенту с IP-адресом 192.168.1.100. Ответ 403 Forbidden будет отправлен любому другому IP-адресу, который попытается получить к нему доступ. Вы также можете разрешить доступ с нескольких адресов или диапазонов и запретить доступ с остальных. Этот метод прост и эффективен для защиты доступа без использования аутентификации или внешних инструментов.

Понимание зависимости root от псевдонима в блоках Location

В зависимости от того, как настроен ваш блок location, при отправке статических файлов необходимо использовать правильную директиву. Это может быть директива root или псевдоним. Неправильное использование этих директив может привести к тому, что NGINX не сможет правильно найти файлы.

Вот краткое сравнение:

location /files/ {
    alias /data/downloads/;
}