Nginx 的 geo 模块本身不直接限流,但可配合 limit_req 实现按地域的差异化限流:先用 geo 根据 IP 归属地生成 $region 变量,再通过 map 映射为动态速率 $limit_rate,最后在 limit_req_zone 中引用该变量实现不同区域不同限流策略。

Nginx 的 geo 模块本身不直接限流,但它可以配合 limit_req 实现按地域(如国家、大区)划分的差异化限流策略。核心思路是:用 geo 指令根据客户端 IP 归属地生成变量(如 $region),再在 limit_req_zone 中基于该变量定义不同速率的限流区域。
准备 IP 归属地数据(关键前提)
geo 模块不自带地理库,需自行维护 IP 段与区域的映射关系。常见做法:
- 使用开源 GeoIP 数据库(如 GeoLite2-CN 或 MaxMind 免费版),导出为 CIDR 格式文本
- 按业务需要聚合:例如将中国所有省份 IP 段统一标记为
cn;东南亚国家(ID、TH、VN 等)合并为sea;欧美主要国家归为global - 保存为
/etc/nginx/conf.d/ip_regions.conf,内容类似:
geo $region {
default global;
include /etc/nginx/conf.d/cn_zones.conf;
include /etc/nginx/conf.d/sea_zones.conf;
include /etc/nginx/conf.d/us_uk_zones.conf;
}
其中每个 include 文件包含大量 1.2.3.0/24 cn; 这类语句。
定义多个限流 zone,绑定 region 变量
在 http 块中声明限流区域,注意:zone 名称必须唯一,且 key 必须包含 $region(或其组合):
limit_req_zone $region$uri zone=region_uri:10m rate=10r/s; limit_req_zone $region zone=by_region:10m rate=100r/s;
说明:
-
$region$uri表示对每个区域的每个 URI 单独限流(更精细) -
$region表示按区域整体限流(更宽松) - 不同
rate值体现策略差异:例如cn区域设为50r/s,global设为5r/s—— 这需通过map指令实现动态速率
用 map 实现“每区域不同限流速率”
geo 只能输出字符串,不能直接控制 rate;需借助 map 将区域映射为速率值:
map $region $limit_rate {
default "5r/s";
cn "30r/s";
sea "10r/s";
us "8r/s";
}
limit_req_zone $binary_remote_addr zone=perip:10m rate=$limit_rate;
⚠️ 注意:rate= 后必须接变量(Nginx 1.13.6+ 支持),且变量值格式必须为 Xr/s 或 Xr/m。这样就能让中国用户单 IP 限速 30qps,海外用户仅 5qps。
在 server 或 location 中启用限流
选择一种策略应用即可,例如按区域+URI 细粒度控制:
server {
location /api/ {
limit_req zone=region_uri burst=20 nodelay;
proxy_pass http://backend;
}
}
或者结合日志记录区域信息,便于后续分析:
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" $region';
access_log /var/log/nginx/access.log main;
验证时可用 curl -H "X-Real-IP: 1.2.3.4" http://yoursite/api/test 模拟指定 IP 请求,并检查响应头中的 X-RateLimit-Remaining(需配合 limit_req_status 和自定义响应头)。


















