nginx
主页 > 服务器 > nginx >

NGINX白名单的几种方法实现介绍

2026-08-30 | 佚名 | 点击:

1、需求

网关:172.16.0.48 反向代理到 Nginx:172.16.0.32 Nginx 只允许来源是网关 172.16.0.48 访问,拒绝所有其它 IP。

关键点:经过代理转发,Nginx 拿到的源 IP,默认不是真实客户端,而是网关 172.16.0.48,直接用 allow/deny 就可以实现。 注意区分两种场景:①四层转发(TCP 代理);②七层 HTTP 代理。

2、处理方案

方案一:Nginx ngx_http_access_module(七层 HTTP,最常用)

场景:网关是 HTTP 反向代理,把 http 请求转发给 172.16.0.32 的 Nginx。编辑 nginx server/location 块:

1

2

3

4

5

6

7

8

9

10

11

12

13

server {

    listen 80;

    server_name _;

 

    # 只放行网关,其余全部拒绝

    allow 172.16.0.48;

    deny all;

 

    location / {

        root html;

        index index.html;

    }

}

??重要前提:网关是直接 http 代理访问 nginx,没有做 X?Forwarded?For 篡改访问控制;此时 nginx 看到的 remote_addr 就是172.16.0.48。 不要拿 $http_x_forwarded_for 做访问控制!这个 header 客户端可以伪造,不安全。

验证配置 & 重载

1

2

nginx -t

nginx -s reload

多 IP 白名单配置

原理:allow 可以写多条,从上到下匹配,最后 deny all; 拒绝其余所有 IP。 依然记住:allow/deny 匹配的是 $remote_addr(TCP 真实连接源 IP),不要用 X?Forwarded?For 做权限校验。

直接写多条 allow(写在 server /location 块内)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

server {

    listen 80;

    server_name _;

 

    # 白名单IP列表

    allow 172.16.0.48;

    allow 172.16.0.49;

    allow 172.16.0.50;

    # 也支持网段

    allow 192.168.1.0/24;

 

    deny all; # 不在上面白名单全部拒绝403

 

    location / {

        root html;

        index index.html;

    }

}

方案二:防火墙层面(系统 iptables/firewalld,网络层,更彻底)

直接在 Nginx 服务器172.16.0.32操作系统防火墙限制,不管 Nginx 配置,网络层面只允许172.16.0.48访问 80/443,其它 IP 全部 drop。

1

2

3

4

5

6

7

8

9

# 删除80、443公开放行

firewall-cmd --permanent --remove-service=http

firewall-cmd --permanent --remove-service=https

 

# 仅允许网关访问80、443

firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="172.16.0.48/32" port protocol="tcp" port="80" accept'

firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="172.16.0.48/32" port protocol="tcp" port="443" accept'

 

firewall-cmd --reload

  • 优点:就算 Nginx 配置被篡改,外部 IP 依然无法访问服务;
  • 缺点:操作系统层面,需要服务器权限。

方案三:Nginx stream 模块(网关是四层 TCP 代理,stream 块)

如果网关是四层 TCP 转发,Nginx 用stream处理 tcp 流量,ngx_stream_access_module做 IP 限制:

1

2

3

4

5

6

7

8

stream {

    server {

        listen 80;

        allow 172.16.0.48;

        deny all;

        proxy_pass backend;

    }

}

3、坑点提醒

  • ? 错误:拿 $http_x_forwarded_for 做 allow 判断。 X?Forwarded?For 是 HTTP 头,外网用户可以随便伪造,不能用来做访问控制;$remote_addr才是 TCP 真实连接来源 IP。
  • 如果网关做的是 SNAT,Nginx 看到源永远网关 IP,allow 172.16.0.48;deny all直接生效。
  • 如果网络中间还有其他设备(负载均衡、交换机)做源 NAT,那 remote_addr 就不是网关,访问控制会失效,需要排查网络链路。

调试如何看 Nginx 拿到的真实 TCP 源 IP

在 nginx 日志格式加上$remote_addr,看日志确认连接来源 IP:

1

2

3

4

log_format main '$remote_addr - $remote_user [$time_local] "$request" '

                '$status $body_bytes_sent "$http_referer" '

                '"$http_user_agent" "$http_x_forwarded_for"';

access_log /var/log/nginx/access.log main;

执行 tail -f /var/log/nginx/access.log,确认请求过来时remote_addr是172.16.0.48。

1、需求

网关:172.16.0.48 反向代理到 Nginx:172.16.0.32 Nginx 只允许来源是网关 172.16.0.48 访问,拒绝所有其它 IP。

关键点:经过代理转发,Nginx 拿到的源 IP,默认不是真实客户端,而是网关 172.16.0.48,直接用 allow/deny 就可以实现。 注意区分两种场景:①四层转发(TCP 代理);②七层 HTTP 代理。

2、处理方案

方案一:Nginx ngx_http_access_module(七层 HTTP,最常用)

场景:网关是 HTTP 反向代理,把 http 请求转发给 172.16.0.32 的 Nginx。编辑 nginx server/location 块:

1

2

3

4

5

6

7

8

9

10

11

12

13

server {

    listen 80;

    server_name _;

 

    # 只放行网关,其余全部拒绝

    allow 172.16.0.48;

    deny all;

 

    location / {

        root html;

        index index.html;

    }

}

??重要前提:网关是直接 http 代理访问 nginx,没有做 X?Forwarded?For 篡改访问控制;此时 nginx 看到的 remote_addr 就是172.16.0.48。 不要拿 $http_x_forwarded_for 做访问控制!这个 header 客户端可以伪造,不安全。

验证配置 & 重载

1

2

nginx -t

nginx -s reload

多 IP 白名单配置

原理:allow 可以写多条,从上到下匹配,最后 deny all; 拒绝其余所有 IP。 依然记住:allow/deny 匹配的是 $remote_addr(TCP 真实连接源 IP),不要用 X?Forwarded?For 做权限校验。

直接写多条 allow(写在 server /location 块内)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

server {

    listen 80;

    server_name _;

 

    # 白名单IP列表

    allow 172.16.0.48;

    allow 172.16.0.49;

    allow 172.16.0.50;

    # 也支持网段

    allow 192.168.1.0/24;

 

    deny all; # 不在上面白名单全部拒绝403

 

    location / {

        root html;

        index index.html;

    }

}

方案二:防火墙层面(系统 iptables/firewalld,网络层,更彻底)

直接在 Nginx 服务器172.16.0.32操作系统防火墙限制,不管 Nginx 配置,网络层面只允许172.16.0.48访问 80/443,其它 IP 全部 drop。

1

2

3

4

5

6

7

8

9

# 删除80、443公开放行

firewall-cmd --permanent --remove-service=http

firewall-cmd --permanent --remove-service=https

 

# 仅允许网关访问80、443

firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="172.16.0.48/32" port protocol="tcp" port="80" accept'

firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="172.16.0.48/32" port protocol="tcp" port="443" accept'

 

firewall-cmd --reload

  • 优点:就算 Nginx 配置被篡改,外部 IP 依然无法访问服务;
  • 缺点:操作系统层面,需要服务器权限。

方案三:Nginx stream 模块(网关是四层 TCP 代理,stream 块)

如果网关是四层 TCP 转发,Nginx 用stream处理 tcp 流量,ngx_stream_access_module做 IP 限制:

1

2

3

4

5

6

7

8

stream {

    server {

        listen 80;

        allow 172.16.0.48;

        deny all;

        proxy_pass backend;

    }

}

3、坑点提醒

  • ? 错误:拿 $http_x_forwarded_for 做 allow 判断。 X?Forwarded?For 是 HTTP 头,外网用户可以随便伪造,不能用来做访问控制;$remote_addr才是 TCP 真实连接来源 IP。
  • 如果网关做的是 SNAT,Nginx 看到源永远网关 IP,allow 172.16.0.48;deny all直接生效。
  • 如果网络中间还有其他设备(负载均衡、交换机)做源 NAT,那 remote_addr 就不是网关,访问控制会失效,需要排查网络链路。

调试如何看 Nginx 拿到的真实 TCP 源 IP

在 nginx 日志格式加上$remote_addr,看日志确认连接来源 IP:

1

2

3

4

log_format main '$remote_addr - $remote_user [$time_local] "$request" '

                '$status $body_bytes_sent "$http_referer" '

                '"$http_user_agent" "$http_x_forwarded_for"';

access_log /var/log/nginx/access.log main;

执行 tail -f /var/log/nginx/access.log,确认请求过来时remote_addr是172.16.0.48。

原文链接:
相关文章
最新更新