用 $binary_remote_addr 替代 $remote_addr 可显著降低限流共享内存占用,因其对 IPv4/IPv6 分别固定存储为 4/16 字节二进制值,避免字符串冗余与动态开销,实测单 key 节省超 50% 空间。

用 $binary_remote_addr 替代 $remote_addr 做限流键,确实能显著降低共享内存占用——这不是玄学,而是 Nginx 在底层对 IP 地址做了二进制压缩存储。关键不在“用了什么变量”,而在于它怎么存、存多少。
为什么 binary_remote_addr 更省空间
Nginx 的限流状态(每个 IP 的请求时间戳、计数等)都存在共享内存 zone 里。这个结构体本身有固定开销,但真正吃内存的,是 key 字段——也就是用来区分不同客户端的标识。
-
$remote_addr是字符串格式,比如"192.168.1.1"占 11 字节,"2001:db8::1"这类 IPv6 地址可达 39 字节,且长度不固定,Nginx 需按最大可能长度预留空间 + 额外指针管理开销 -
$binary_remote_addr对 IPv4 固定输出 4 字节二进制值,IPv6 固定 16 字节;没有字符串终止符、无编码转换、无动态分配,直接 memcpy 进哈希表节点 - 实测表明:在纯 IPv4 环境下,单个 key 存储成本从平均 32–40 字节降至约 12–16 字节(含结构体头),综合节省超 50%
10MB zone 实际能存多少 IP?别再靠“1MB ≈ 1 万 IP”粗估
网上常说“1MB 存 1 万个 IP”,那是基于旧版 Nginx 或未启用 binary 的估算。真实容量取决于:
- IP 协议类型:IPv4 下,
$binary_remote_addr每个 key 占用约 12 字节(key 数据)+ 32 字节(状态结构体)≈ 44 字节/条 - 内存对齐与哈希桶开销:Nginx 使用带链地址法的哈希表,zone 内存并非 100% 存数据,约 15–20% 用于桶数组和指针
- 计算示例:10MB = 10 × 1024 × 1024 = 10,485,760 字节;扣除 18% 管理开销后剩约 8.6MB;按 44 字节/IP,理论可存约 20 万个 IPv4 地址
动手验证内存差异:两行配置对比
在同一台 Nginx(v1.20+)上分别测试,观察 nginx -t 后的共享内存实际占用(通过 cat /proc/$(pidof nginx)/maps | grep "limit" 或 nginx -V 2>&1 | grep -o "built by.*" 确认版本):
- 低效写法(不推荐):
limit_req_zone $remote_addr zone=bad:10m rate=5r/s; - 高效写法(推荐):
limit_req_zone $binary_remote_addr zone=good:10m rate=5r/s;
启动后用 ps aux --sort=-vsz | head -5 查看主进程 VSZ,两者差值通常在 2–4MB——这就是纯因 key 格式带来的内存节约,不依赖任何第三方模块。
注意事项:binary_remote_addr 不等于万能,得看你的流量场景
它省的是内存,不是逻辑。以下情况需谨慎:
- 使用了可信代理(如 CDN、LB),且真实 IP 在
X-Forwarded-For中:此时$binary_remote_addr是代理 IP,会把所有用户“压成一个 key”。必须配合set_real_ip_from+real_ip_header提前还原,再基于$remote_addr(已被修正)取 binary 值 - IPv6 用户占比高:虽然 binary 仍比字符串省,但单条 key 从 4 字节涨到 16 字节,整体容量下降明显,建议按实际日志统计 IPv6 比例后再规划 zone 大小
- 需要按用户 ID、token 或设备指纹限流:那就不能用
$binary_remote_addr,该换 key 就换,内存优化让位于业务语义











