在 nginx 中,标准的 upstream 轮询算法(如 round-robin)是静态配置的,无法直接通过修改配置文件并重新加载来动态调整权重。要实现后端权重的动态修改,必须引入第三方模块 nginx-upstream-dynamic-weights。该模块允许在运行时通过 http api 实时更改特定后端服务器的权重,而无需重启或重载 nginx 服务。

如何安装和配置动态权重模块
要启用此功能,首先需要编译安装带有 nginx-upstream-dynamic-weights 模块的 Nginx。在配置文件中,你需要定义一个 upstream 块,并在其中指定后端服务器。与普通 upstream 不同,这里不需要显式设置 weight 参数,因为权重将由外部请求动态注入。同时,需要配置一个 location 用于接收权重更新请求。

events {
worker_connections 1024;
}
http {
upstream backend_pool {
# 使用 dynamic_weights 指令启用模块
dynamic_weights;
server 192.168.1.10:8080;
server 192.168.1.11:8080;
server 192.168.1.12:8080;
}
server {
listen 80;
# 处理权重更新的 API 端点
location /update_weight {
internal;
# 语法: /update_weight?server=IP:PORT&weight=NEW_WEIGHT
dynamic_weights_update;
}
location / {
proxy_pass http://backend_pool;
}
}
}
在上述配置中,dynamic_weights 指令激活了模块的核心功能。当 Nginx 启动后,所有后端服务器的初始权重通常默认为 1。你可以通过向 /update_weight 发送 GET 请求来改变某个节点的权重。例如,将 IP 为 192.168.1.10 的服务器的权重调整为 5,请求 URL 应为 /update_weight?server=192.168.1.10:8080&weight=5。模块会立即在内存中更新该服务器的权重值,后续的负载均衡请求将依据新的权重比例进行分配。
以数据形式体验爵士乐。AI代理流式处理和声分离、色度、音网。误差纳入已测量。
如何通过 API 验证权重变更效果
配置完成后,可以通过命令行工具模拟客户端请求来验证权重是否生效。假设我们有一个简单的测试脚本,连续发送 100 次请求到 Nginx,并统计每个后端服务器处理的请求数量。在未修改权重前,三个服务器的请求分布应大致相等。执行以下命令将第一个服务器的权重设为 10:

# 设置权重
curl "http://localhost/update_weight?server=192.168.1.10:8080&weight=10"
# 模拟 100 次请求并统计结果
curl -s -o /dev/null -w "%{remote_addr}\n" http://localhost/ | sort | uniq -c
运行上述脚本后,观察输出结果。你会发现 192.168.1.10 处理的请求数量显著多于其他两个节点,比例接近 10:1:1。这证明了动态权重模块正在根据最新设置的权重值进行流量调度。如果需要恢复默认状态,可以将权重重置为 1,或者删除该服务器的权重记录(具体行为取决于模块版本,通常设为 1 即可)。这种机制非常适合用于灰度发布、故障转移或根据后端负载情况动态调整流量的场景。
动态权重模块如何处理服务器下线情况
在使用 nginx-upstream-dynamic-weights 时,一个关键问题是当后端服务器宕机或被标记为不可用时,动态设置的权重会发生什么变化。该模块依赖于 Nginx 核心的健康检查机制。如果某台服务器被标记为 down,Nginx 的负载均衡器会自动将其从可用列表中移除,此时无论其动态权重是多少,都不会再收到流量。一旦服务器恢复健康,它将被重新加入上游组,并恢复其之前设置的动态权重值继续参与轮询。这意味着动态权重与服务器状态是解耦的:权重只决定在服务器可用时的流量分配比例,而不影响服务器的可用性判定。开发者在实现自动化运维脚本时,应确保在服务器恢复上线后,能够正确恢复其预期的权重配置,避免因状态切换导致权重丢失或重置为默认值。

















