Nginx: map | Web Мастерская

В мире веб-разработки каждая деталь имеет значение. Один неверный параметр или неправильно сконфигурированный модуль могут серьёзно снизить производительность и вызвать неудобства у пользователей. Одной из уникальных возможностей Nginx является модуль map, позволяющий динамически изменять переменные в зависимости от условий. Сегодня мы детально рассмотрим, что это за модуль, зачем он нужен и как его использовать на практике.

Что такое модуль map?

Модуль map — это особый компонент Nginx, предназначенный для динамического формирования переменных на основании определённых критериев. Например, можно создать условия, при которых переменная изменяется в зависимости от содержимого заголовка запроса, URL или даже IP-адреса клиента.

Основное назначение модуля — создание динамических связей между параметрами запроса и поведением сервера. Это открывает широкие возможности для оптимизации производительности, обеспечения безопасности и персонализации выдачи контента.

Принцип работы модуля map

Работа модуля основана на создании таблиц соответствия (mapping tables), где каждому значению ключа сопоставляется соответствующее значение переменной. Затем, основываясь на текущих условиях, Nginx выбирает нужное значение и подставляет его в нужные места конфигурации.

Пример использования map

Предположим, нам нужно перенаправлять пользователей на разные серверы в зависимости от региона. Воспользуемся модулем map:

map $http_host $backend {
    hostnames;
    domain.ru upstream_a;
    domain.com upstream_b;
    default upstream_default;
}

server {
    listen 80;
    server_name domain.ru domain.com;

    location / {
        proxy_pass http://$backend;
    }
}

В приведённом примере мы создали таблицу соответствий, где разным доменам назначены разные бекенд-сервера. Далее в разделе location мы используем сформированную переменную $backend для проксирования запросов.

Распространённые сценарии использования

1. Географическая фильтрация трафика
Часто бывает нужно направить пользователей из разных регионов на соответствующие серверы или регионы. Используя модуль map и гео-данные, можно легко реализовать такую схему:

map $geoip_country_code $country_backend {
    RU ru_upstream;
    UA ua_upstream;
    default global_upstream;
}

2. Управление правами доступа
Допустим, мы хотим закрыть доступ к сайту для определённых стран или сетей. Для этого удобно использовать модуль map:

map $remote_addr $ban_ip {
    1.2.3.4 blocked;
    default allowed;
}

server {
    deny all;
    allow $ban_ip;
}

3. Переключение протоколов
Иногда необходимо автоматически переключать пользователей с HTTP на HTTPS. Модуль map позволяет сделать это прозрачно и аккуратно:

map $scheme $redirect_to_https {
    http https;
    default $scheme;
}

server {
    listen 80;
    server_name mysite.com;

    location / {
        return 301 $redirect_to_https://$host$request_uri;
    }
}

Советы по применению

Простота и гибкость: старайтесь строить таблицы соответствий максимально простыми и чистыми. Чем проще таблица, тем легче будет её читать и поддерживать.
Производительность: учитывайте, что каждая проверка увеличивает затраты на вычисления. Старайтесь минимизировать количество проверок и использовать кэширование там, где это уместно.
Совместимость: помните, что модуль map доступен начиная с версии Nginx 0.7.21. Убедитесь, что ваша версия поддерживает необходимые функции.

Модуль map в Nginx — это важный инструмент, позволяющий гибко управлять поведением сервера в зависимости от условий. Правильно организованная схема соответствий повысит производительность, упростит управление системой и откроет простор для креативных решений. Экспериментируйте, пробуйте разные подходы и найдёте оптимальный сценарий для вашего проекта.