Web 服务器与网关 / 系统课时

配置地址访问控制

配置地址访问控制

本节学习如何使用 Nginx 的 allow 和 deny 指令保护管理接口,只允许指定来源访问敏感路径。同时会处理反向代理场景中的真实客户端地址问题,避免因为代理层存在而错误放行或误拦截。

学习目标

  • 掌握 allow 和 deny 的匹配规则。
  • 学会为管理接口配置 IP 白名单。
  • 理解多层代理环境下真实客户端地址恢复方式。

使用 allow 和 deny 控制访问来源

Nginx 可以根据客户端 IP 判断是否允许访问。典型场景是后台管理接口、运维监控页面和内部 API,只开放给固定办公网或跳板机地址。

配置时通常先允许可信来源,再拒绝其他地址。deny all 表示除明确允许地址外全部拒绝。

nginx
server {
    listen 80;
    server_name admin.example.com;

    location /admin {
        allow 192.168.10.0/24;
        allow 203.0.113.10;
        deny all;

        proxy_pass http://admin_backend;
    }
}

预期结果

text
来源 IP 192.168.10.20
返回管理页面。

来源 IP 198.51.100.20
返回 403 Forbidden。

allow 和 deny 按出现顺序匹配。当一个请求匹配到第一条规则后,Nginx 会执行对应结果,因此规则设计必须清晰。

在代理环境中恢复真实客户端 IP

如果 Nginx 前面还有 CDN、负载均衡或其他代理,默认获取到的 remote_addr 可能是代理服务器地址,而不是用户真实 IP。此时需要配置可信代理来源,并指定真实 IP 头。

多层代理中的真实客户端地址传递关系

nginx
http {
    set_real_ip_from 10.0.0.0/8;
    real_ip_header X-Forwarded-For;
    real_ip_recursive on;

    server {
        location /admin {
            allow 203.0.113.10;
            deny all;
        }
    }
}

预期结果

text
代理转发前:remote_addr = 10.0.0.5
恢复后:remote_addr = 203.0.113.10

只有可信代理网段才能写入真实 IP,否则攻击者可以伪造 X-Forwarded-For 绕过访问控制。

验证访问控制效果

修改配置后,通过不同来源地址或测试代理环境验证允许和拒绝结果。

bash
nginx -t
nginx -s reload
curl -I http://admin.example.com/admin

预期输出

text
HTTP/1.1 403 Forbidden

如果允许来源访问,应返回后端管理服务对应响应,例如 200 或登录页面。

常见错误处理

配置地址控制时,最常见的问题是白名单规则正确但所有用户都被拒绝。这通常不是 allow 配置错误,而是 Nginx 获取到的是代理地址。

排查顺序应为:确认 access.log 中记录的客户端地址、检查代理是否传递真实 IP 头、确认 set_real_ip_from 是否覆盖可信代理网段。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置地址访问控制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通