Директива location служит для установки конфигурации в зависимости от URI-запроса. Синтаксис location в общем виде следующий:
Syntax: location [=|~|~*|^~] uri { ... } location @name { ... } Context: server, location
Перед тем, как перейти к более детальному изучению, нужно заметить, что location определяется в контексте server (или в location в случае вложенной директивы), и в одном настраиваемом виртуальном хосте могут использоваться разные конфигурации в зависимости от обрабатываемого сервером URI.
Префикс «@» («собака») определяет именованные расположения. Такие location’ы не используются для обработки обычных запросов. Вместо этого они используются для перенаправления запросов (пример №6). Они не могут быть вложенными и содержать в себе вложенные.
Порядок обработки:
location = / { # Расположение только для URI / # При совпадении дальнейший поиск не осуществляется }
location / { # Совпадает с URI всех запросов, т.к. они все начинаются с "/" # Но! Если будут найдены соответствия в расположениях # с регулярными выражениями или с другим более длинным # строковым литералом (например, "/data/"), # то конфигурация для "/" не будет применена. }
location /data/ { # Это расположение соответствует всем URI, начинающихся с "/data/" # и продолжает поиск по оставшимся location'ам. # В этом примере регулярные выражения и другие строковые литералы # также будут проверены, и "location /data/" будет использован, # если более конкретизирующие расположения не удовлетворят искомому ресурсу. }
location ^~ /img/ { # Соответствует любому URI, начинающемуся с "/img/". # Если соответствие установлено - останавливает дальнейший поиск, # не проверяя регулярные выражения, т.к. используется # префикс ^~ "крышечка/циркумфлекс тильда". }
location ~* \.(png|ico|gif|jpg|jpeg)$ { # Данное расположение соответствует всем запрашиваемым URI, # оканчивающихся ".png", ".ico", ".gif", ".jpg" или ".jpeg". # При этом надо заметить, что запросы внутри расположения "/img/" # будут обработаны в location из примера №4 # Т.е., если расположения из примеров №4 и №5 разместить в таком же # порядке в реальном конфиге, то до этого расположения ресурсов # дойдут только те картинки, которые лежат вне расположения "/img/" }
location / { error_page 404 = @fallback; } location @fallback { # Если при внутреннем перенаправлении не нужно менять URI, # то можно передать обработку ошибки в именованный location }
location ~ ^/a/(?[a-zA-Z]+) { # Тут можно использовать переменную $myvar, # которая представляет из себя строку из латиницы if ($myvar = "sth") { ... } }
Директива location для Anti-hotlinking (борьбы с использованием ресурсов с вашего сервера на сторонних ресурсах. Такой способ использования ваших сетевых ресурсов называется hotlinking). Такое поведение хитрых разработчиков может заметно увеличить нагрузку на ваш сервер. Конфигурация:
location ~ \.(gif|png|jpe?g)$ { valid_referers none blocked mywebsite.com *.mywebsite.com; if ($invalid_referer) { return 403; } }
Следующий пример — запрет на скрипты в разрешённых для записи директориях:
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ { error_page 403 /403.htm; return 403; }
В следующем примере location используется для включения autoindex в nginx (Разрешение на вывод листинга каталога):
location /list_dir { autoindex on; autoindex_exact_size off; autoindex_localtime on; }}
server { listen 80; server_name домен; access_log off; error_log off; location / { # remote HTTP server proxy_pass http://IP:Порт; proxy_redirect http://IP:Порт /; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Real-IP $remote_addr; proxy_connect_timeout 600; } }