Nginx 设置黑/白名单IP限制、国家城市IP访问限制，实战教程！

1黑/白名单IP限制访问配置

nginx配置黑白名单有好几种方式，这里只介绍常用的两种方法。

1、第一种方法：allow、deny

deny和allow指令属于ngx_http_access_module，nginx默认加载此模块，所以可直接使用。

这种方式，最简单，最直接。设置类似防火墙iptable，使用方法：

直接配置文件中添加：

#白名单设置，allow后面为可访问IP 
location / {
     allow 123.13.123.12;
     allow 23.53.32.1/100;
     deny  all;
}

#黑名单设置，deny后面接限制的IP，为什么不加allow all? 因为这个默认是开启的 
location / {
     deny 123.13.123.12;
}

#白名单，特定目录访问限制
location /tree/list {
     allow 123.13.123.12;
     deny  all;
}

或者通过读取文件IP配置白名单

location /{
    include /home/whitelist.conf;
    #默认位置路径为/etc/nginx/ 下，
    #如直接写include whitelist.conf，则只需要在/etc/nginx目录下创建whitelist.conf
    deny all;
}

在/home/目录下创建whitelist.conf，并写入需要加入白名单的IP，添加完成后查看如下：

cat /home/whitelist.conf

#白名单IP
allow 10.1.1.10;
allow 10.1.1.11;

白名单设置完成，黑名单设置方法一样。

2、第二种方法，ngx_http_geo_module

默认情况下，一般nginx是有加该模块的，ngx_http_geo_module：官方文档^[1]，参数需设置在位置在http模块中。

此模块可设置IP限制，也可设置国家地区限制。位置在server模块外即可。

语法示例：

• 配置文件直接添加

geo $ip_list {
    default 0;
    #设置默认值为0
    192.168.1.0/24 1;
    10.1.0.0/16    1;
}
server {
   listen       8081;
   server_name  192.168.152.100;
   
   location / {
       root   /var/www/test;
       index  index.html index.htm index.php;
       if ( $ip_list = 0 ) {
       #判断默认值，如果值为0，可访问，这时上面添加的IP为黑名单。
       #白名单，将设置$ip_list = 1，这时上面添加的IP为白名单。
       proxy_pass http://192.168.152.100:8081;
}

• 同样可通过读取文件IP配置

geo $ip_list {
    default 0;
    #设置默认值为0
    include ip_white.conf;
}
server {
    listen       8081;
    server_name  192.168.152.100;
    
    location / {
        root   /var/www/test;
  index  index.html index.htm index.php;
  if ( $ip_list = 0 ) {
   return 403;
   #限制的IP返回值为403，也可以设置为503，504其他值。
   #建议设置503，504这样返回的页面不会暴露nginx相关信息，限制的IP看到的信息只显示服务器错误，无法判断真正原因。
    }

在/etc/nginx目录下创建ip_list.conf，添加IP完成后，查看如下：

cat /etc/nginx/ip_list.conf

192.168.152.1 1;
192.168.150.0/24 1;

设置完成，ip_list.conf的IP为白名单，不在名单中的，直接返回403页面。黑名单设置方法相同。

3、ngx_http_geo_module 负载均衡（扩展）

ngx_http_geo_module，模块还可以做负载均衡使用，如web集群在不同地区都有服务器，某个地区IP段，负载均衡至访问某个地区的服务器。方式类似，IP后面加上自定义值，不仅仅数字，如US,CN等字母。

示例：

如果三台服务器：122.11.11.11，133.11.12.22，144.11.11.33

geo $country {
    default default;
    111.11.11.0/24   uk;
    #IP段定义值uk
    111.11.12.0/24   us;
    #IP段定义值us
    }
upstream  uk.server {
    erver 122.11.11.11:9090;
    #定义值uk的IP直接访问此服务器
} 

upstream  us.server {
    server 133.11.12.22:9090;
    #定义值us的IP直接访问此服务器
}

upstream  default.server {
    server 144.11.11.33:9090;
    #默认的定义值default的IP直接访问此服务器
}
 
server {
    listen    9090;
    server_name 144.11.11.33;

    location / {
      root  /var/www/html/;
      index index.html index.htm;
     }
 }

2国家地区IP限制访问

有些第三方也提供设置，如cloudflare，设置更简单，防火墙规则里设置。这里讲讲nginx的设置方法。

1、安装ngx_http_geoip_module模块

ngx_http_geoip_module：官方文档^[2]，参数需设置在位置在http模块中。

nginx默认情况下不构建此模块，应使用 --with-http_geoip_module 配置参数启用它。

对于ubuntu系统来说，直接安装 nginx-extras组件，包括几乎所有的模块。

sudo apt install nginx-extras

对于centos系统，安装模块。

yum install nginx-module-geoip

2、下载 IP 数据库

此模块依赖于IP数据库，所有数据在此数据库中读取，所有还需要下载ip库（dat格式）。

MaxMind 提供了免费的 IP 地域数据库，坏消息是MaxMind 官方已经停止支持dat格式的ip库。

在其他地方可以找到dat格式的文件，或者老版本的，当然数据不可能最新，多少有误差。

第三方下载地址：https://www.miyuru.lk/geoiplegacy

下载同时包括Ipv4和Ipv6的country、city版本。

#下载国家IP库，解压并移动到nginx配置文件目录，
sudo wget https://dl.miyuru.lk/geoip/maxmind/country/maxmind.dat.gz
gunzip maxmind.dat.gz
sudo mv maxmind.dat /etc/nginx/GeoCountry.dat

sudo wget https://dl.miyuru.lk/geoip/maxmind/city/maxmind.dat.gz
gunzip maxmind.dat.gz
sudo mv maxmind.dat /etc/nginx/GeoCity.dat

3、配置nginx

示例：

geoip_country /etc/nginx/GeoCountry.dat;
geoip_city /etc/nginx/GeoCity.dat;

server {
    listen  80;
    server_name 144.11.11.33;

    location / {
      root  /var/www/html/;
      index index.html index.htm;
      if ($geoip_country_code = CN) {
     return 403;
   #中国地区，拒绝访问。返回403页面
  }
   }
 }

这里，地区国家基础设置就完成了。

Geoip其他参数：

• 国家相关参数：

$geoip_country_code #两位字符的英文国家码。如：CN, US
$geoip_country_code3 #三位字符的英文国家码。如：CHN, USA
$geoip_country_name #国家英文全称。如：China, United States

• 城市相关参数：

$geoip_city_country_code #也是两位字符的英文国家码。
$geoip_city_country_code3 #上同
$geoip_city_country_name #上同.
$geoip_region #这个经测试是两位数的数字，如杭州是02, 上海是 23。但是没有搜到相关资料，希望知道的朋友留言告之。
$geoip_city #城市的英文名称。如：Hangzhou
$geoip_postal_code #城市的邮政编码。经测试，国内这字段为空
$geoip_city_continent_code #不知什么用途，国内好像都是AS
$geoip_latitude #纬度
$geoip_longitude #经度

参考资料