Nginx Block And Deny IP Address OR Network Subnets

last updated in Categories ,

How do I block or deny access based on the host name or IP address of the client visiting website under nginx web server?

Nginx comes with a simple module called ngx_http_access_module to allow or deny access to IP address. The syntax is as follows:


deny IP;
deny subnet;
allow IP;
allow subnet;
# block all ips
deny    all;
# allow all ips 
allow    all;

Note rules are checked in the order of their record to the first match.

How Do I Configure Nginx To Block IPs?

Edit nginx.conf file, enter (note my nginx path is set to /usr/local/nginx/, replace this according to your setup):
# cd /usr/local/nginx/conf/
# vi nginx.conf

Add the following line in http section:

## Block spammers and other unwanted visitors  ##
 include blockips.conf;

Save and close the file. Finally, create blockips.conf in /usr/local/nginx/conf/, enter:
# vi blockips.conf
Append / add entries as follows:


Save and close the file. Test the config file, enter:
# /usr/local/nginx/sbin/nginx -t
Sample outputs:

the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
configuration file /usr/local/nginx/conf/nginx.conf test is successful

Reload the new config, enter:
# /usr/local/nginx/sbin/nginx -s reload

How Do I Deny All and Allow Only Intranet/LAN IPs?

Edit config file as follows:

location / {
  # block one workstation
  # allow anyone in
  # drop rest of the world 
  deny    all;

Granted access to network with the exception of the address

How Do I Customize HTTP 403 Forbidden Error Messages?

Create a file called error403.html in default document root, enter:
# cd /usr/local/nginx/html
# vi error403.html

<head><title>Error 403 - IP Address Blocked</title></head>
Your IP Address is blocked. If you this an error, please contact webmaster with your IP at

If SSI enabled, you can display the client IP easily from the html page itself:

Your IP Address is <!--#echo var="REMOTE_ADDR" --> blocked.

Save and close the file. Edit your nginx.conf file, enter:
# vi nginx.conf

# redirect server error pages to the static page
 error_page   403  /error403.html;
 location = /error403.html {
         root   html;

Save and close the file. Reload nginx, enter:
# /usr/local/nginx/sbin/nginx -s reload

See also:



Posted by: Vivek Gite

The author is the creator of nixCraft and a seasoned sysadmin, DevOps engineer, and a trainer for the Linux operating system/Unix shell scripting. Get the latest tutorials on SysAdmin, Linux/Unix and open source topics via RSS/XML feed or weekly email newsletter.

19 comment

  1. I am not a administrator. how i can stop 403 error..
    Please tell me..
    My all downloading is block and e found error 403 & 404..please solve it.

    1. You can’t, it is a server side configuration. Only server admin can configure and allow or deny access.

  2. How do I get Live Journal to unblock my IP Adress? Administrators need to make sure that the IP Address that they are blocking is malicious first, and stop blocking genuine customers.

  3. I have the same problem. Cant google it anyhow.
    unknown directive “deny”…

    Although nginx -V does not show any signs of “disinclussion” of the module. So I’m guessing its enabled? Any help appreciated.

  4. My upstream load balancer use SNAT, so in Nginx it sees all source IP as load balancer IP.

    Is there a way in Nginx to find out the real IP of client browser in order to use ngx_http_access_module?


  5. Excellent post. I already knew how to use the deny / allow, but didn’t know you could include other files. Idea’s are now brewing in my head.

  6. Very interesting article. I notice lots of entries in my access log such as the following
    from this morning:

    \xFB\x81\xF1`\xC7k\x12L\x09PS\xB8\xDB\xD0\xAC9\xF5 \xE4k\xB0\x80\x929\xCA\x8E\x93e\xF3\xFEf$\x1B\x87z7\x8C\x96Iy\xB1L/K\xB6&\x12\xC3}\x02J\x1E\xBF\xDE\x22\xE5\xA7\xE82\xD7\xE1\xFDo\xF6\x05o\xCC\xCBE&" 400 172 "-" "-"
    I presume these are attempts to hack into my site. If so, is there a way to block all attempts which use this type of string. Many thanks, Bill
  7. I did that but it won’t works. no error but i can visit the site with the block ip. I’m using latest ver of nginx.

    have you tested it yourself?

  8. Hi nixcraft, it might be an off-topic but I really need to know about the ip address formatting. On your example you have used “allow”

    Does it mean that ip to will be allowed for that specific location? My current IP address is xx.xx.xx.223. When I set something like xx.xx.xx.0/230 nginx through me an error that says. invalid parameter “xx.xx.xx.0/230”

    What is the real deal here?

  9. I get the same problem. I can specify one IP address ok but when I try a range of IPs like:


    I get invalid parameter. Why is this? I want to allow local lan not just one IP address

  10. Does anybody know a solution for a setup like:
    – i have 100+ vhosts
    – i have one htaccess file with all the users/passwords for basic auth
    – for some of the vhosts , i want it to set so that for some specific vhosts only one or more specific users from htaccess file would have access , and i don’t want to create another htaccess file for those vhosts.

    this is the relevant part from my active apache2 configuration that i want to convert to nginx

    AuthUserFile /var/htpasswd/htpasswd
    AuthType Basic
    AuthName “Auth Required”
    Satisfy Any

    Order Deny,Allow
    Deny from all
    Allow from x.x.x.x
    Allow from x.x.x.x
    Require user user_name

  11. The /24 is not a range like 0..24. It specifies a bitmask, in this case the first 24 bits should be relevant. As there are 8 bits between each dot of an IP adress, this means that the first three numbers are relevant and the number after the last dot may be anything from 0 to 255. So you should be fine because covers evrerything form to

  12. Hello there,

    I have 5 servers running behind load balancers.
    What is the best way to implement this configuration? NFS storage? OR rsync to sync the file?

    Please advise.

    Still, have a question? Get help on our forum!