检测Nginx ip_hash流量均衡需模拟其哈希逻辑：取IP前三个字节按((a×123+b)×123+c)%server数计算索引，统计各server命中次数并算标准差与最大偏差比。
要检测 Nginx ip_hash 集群的流量分布是否均衡，核心思路是：**采集真实访问日志中的客户端 IP，按哈希规则模拟 Nginx 的 ip_hash 分发逻辑，统计各 upstream server 的命中次数，并计算离散度（如标准差、最大偏差比）**。这不是 Nginx 内置功能，需靠外部脚本完成。
1. 理解 ip_hash 的分发逻辑
Nginx 的 ip_hash 使用 IPv4 地址的前三个字节（A.B.C）做哈希（IPv6 处理不同，但生产中多数仍是 IPv4）。具体算法为：
- 取 IP 的每个字节（如
192.168.5.23→192,168,5） - 计算哈希值：
hash = ((192 * 123 + 168) * 123 + 5) % servers.length（Nginx 使用固定乘数 123 和模运算） - 结果对应 upstream server 列表的索引（0-based）
⚠️ 注意：upstream server 顺序不能变，增删节点会彻底改变原有 IP 的归属，这也是 ip_hash 均衡性天然受限的原因。
2. 提取并预处理访问日志
确保 Nginx 日志格式包含真实客户端 IP（非代理 IP），推荐使用 $remote_addr 或经 real_ip 模块修正后的 $remote_addr：
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
用以下命令快速提取最近 10 万条 IP（避免全量分析太慢）：
zcat /var/log/nginx/access.log.*.gz | tail -n 50000 | awk '{print }' | sort | uniq -c | sort -nr | head -20
更严谨的做法是用 awk '{print $1}' /var/log/nginx/access.log | grep -E '^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$' 过滤出合法 IPv4。
3. 编写 Python 检测脚本（推荐）
以下是一个轻量、可直接运行的 Python 脚本（保存为 check_ip_hash_balance.py）：
#!/usr/bin/env python3
import sys
import re
from collections import Counter
import math
<p>def ip_hash(ip, server_list):
"""模拟 Nginx ip_hash 算法（仅 IPv4）"""
if not re.match(r'^\d{1,3}(.\d{1,3}){3}$', ip):
return -1
parts = list(map(int, ip.split('.')))
if any(x > 255 for x in parts):
return -1</p><h1>只取前三个字节（Nginx 行为）</h1><pre class="brush:php;toolbar:false;">a, b, c = parts[0], parts[1], parts[2]
h = ((a * 123 + b) * 123 + c) % len(server_list)
return hdef main():
if len(sys.argv)
servers = sys.argv[1:]
print(f"Upstream servers: {servers}")
# 从 stdin 读取 IP 列表（每行一个）
ips = [line.strip() for line in sys.stdin if line.strip()]
if not ips:
print("No IPs received.")
sys.exit(1)
assignments = []
for ip in ips:
idx = ip_hash(ip, servers)
if idx >= 0:
assignments.append(servers[idx])
counter = Counter(assignments)
total = len(assignments)
if total == 0:
print("No valid IP assignments.")
return
# 计算均衡度指标
expected = total / len(servers)
deviations = [abs(counter.get(s, 0) - expected) / expected * 100 for s in servers]
max_dev = max(deviations) if deviations else 0
std_dev = math.sqrt(sum((counter.get(s, 0) - expected)**2 for s in servers) / len(servers))
print(f"\nTraffic distribution (total {total} requests):")
for s in servers:
cnt = counter.get(s, 0)
pct = cnt / total * 100
print(f" {s:20} : {cnt:6} ({pct:.1f}%)")
print(f"\nExpected per server: ~{expected:.0f}")
print(f"Std dev: {std_dev:.1f} | Max deviation: {max_dev:.1f}%")if name == 'main': main()
使用方式：
awk '{print $1}' /var/log/nginx/access.log | python3 check_ip_hash_balance.py server1.example.com server2.example.com server3.example.com
4. 自动化与告警建议
将检测集成进日常运维：
- 每天凌晨用
cron抽样昨日日志，输出报告到文件 - 当
Max deviation > 35%或std dev > 50时，触发邮件/钉钉通知（可用mail或curlwebhook） - 结合
nginx -T | grep -A 20 "upstream.*your_backend"自动提取当前 upstream 配置，避免硬编码 server 列表 - 注意：若后端服务器性能差异大，单纯看请求数不等于负载均衡；必要时叠加响应时间、连接数等维度
不复杂但容易忽略的是——ip_hash 本质是“伪静态”映射，它的均衡性高度依赖客户端 IP 的地理/运营商分布。如果大部分流量来自某几个 CIDR 段（如企业 NAT 出口），天然就会倾斜。此时应考虑切到 hash $request_id consistent 或引入服务网格级负载策略。
