This module makes it possible to block access to the site with the incorrect values of line "Referer" in the request header.

Keep in mind that it is easy to spoof this header; therefore, the purpose of using of this module consists not in 100% blocking of these requests, but in the blocking of the mass flow of requests, made from typical browsers. Also, consider that the typical browser does not always provide a "Referer" header, even for correct requests.


location /photos/ {
  valid_referers none blocked;
  if ($invalid_referer) {
    return   403;




syntax: valid_referers [none|blocked|server_names] ...

default: none

context: server, location

This directive assigns a value of 0 or 1 to the variable $invalid_referer based on the contents of the referer header.

You can use this to help reduce deep-linking from outside sites. If Referer header is not accounted for in the list of valid_referers, then $invalid_referer will be set to 1 (see example above).

The parameters can be as follows:


Original Documentation