Nginx 权重算法中怎么利用环境变量动态改变 upstream 中各节点的权重值

浅磊大大_1955

浅磊大大_1955

2026-07-25

246人浏览

原创

nginx原生不支持upstream中直接使用环境变量设置weight,因weight需编译期确定;可行方案包括:①njs动态选节点、②openresty+lua实现加权调度、③外部api配合动态服务器模块。

nginx 权重算法中怎么利用环境变量动态改变 upstream 中各节点的权重值

Nginx 原生不支持在 upstream 块中直接引用环境变量(如 $ENV_VAR)来设置 weight,因为 upstream 指令在配置解析阶段就完成编译,此时变量尚未求值,且 weight 必须是编译期确定的整数常量。所以不能写成 server 10.0.1.10:8080 weight=$MY_WEIGHT;——这会导致 nginx -t 报错或被忽略。

但你可以通过“绕过静态 weight”的方式,实现效果等价的动态权重控制:把权重决策逻辑移到请求处理阶段,用运行时变量决定实际转发目标。核心思路是——不改 weight,改 proxy_pass 目标。


✅ 利用 NJS(NGINX JavaScript)读取环境变量并动态选节点

NJS 可以访问系统环境变量(通过 os.getenv()),结合 r.variables 和 proxy_pass http://$upstream_target 实现逻辑加权。

示例配置(nginx.conf 中):

# 加载 NJS 脚本(可内联或 external)
js_import /etc/nginx/njs/weight_router.js;

upstream backend_pool {
    # 这里不设 weight,仅作占位或用于 fallback
    server 10.0.1.10:8080;
    server 10.0.1.11:8080;
    server 10.0.1.12:8080;
}

server {
    listen 80;
    location / {
        js_content weight_router.selectByEnv;
        proxy_pass http://$upstream_target;
        proxy_set_header Host $host;
    }
}

/etc/nginx/njs/weight_router.js 内容:

function selectByEnv(r) {
    // 读取环境变量(需确保 nginx 启动时已导出,如 export NODE_A_WEIGHT=7)
    const wA = parseInt(os.getenv('NODE_A_WEIGHT') || '5');
    const wB = parseInt(os.getenv('NODE_B_WEIGHT') || '3');
    const wC = parseInt(os.getenv('NODE_C_WEIGHT') || '2');

    // 构建带权重的候选池(可扩展为加权随机轮询)
    const candidates = [
        { addr: '10.0.1.10:8080', score: wA },
        { addr: '10.0.1.11:8080', score: wB },
        { addr: '10.0.1.12:8080', score: wC }
    ];

    // 简单按 score 降序取最高(或实现 weighted random)
    candidates.sort((a, b) => b.score - a.score);
    r.variables.upstream_target = candidates[0].addr;
}
export default { selectByEnv };

⚠️ 注意:

Nginx Config Linter
Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载
  • 环境变量需在 启动 nginx 主进程前导出(如 systemd service 文件中加 Environment="NODE_A_WEIGHT=8"),NJS 才能读到;
  • proxy_pass http://$upstream_target 要求目标是 IP:PORT 或已配置的 resolver 域名;
  • 此方案无健康检查,建议在脚本中加入 try/catch + 缓存上次成功节点,或搭配 max_fails/fail_timeout 使用。

✅ 利用 OpenResty + Lua(更成熟、支持共享状态)

如果你用的是 OpenResty,可用 ngx.var 或 ngx.getenv() 获取环境变量,并在 balancer_by_lua_block 中做实时调度:

upstream backend {
    server 10.0.1.10:8080;  # 占位,实际不靠它轮询
    server 10.0.1.11:8080;
    server 10.0.1.12:8080;

    balancer_by_lua_block {
        local env_a = tonumber(ngx.getenv("NODE_A_WEIGHT")) or 5
        local env_b = tonumber(ngx.getenv("NODE_B_WEIGHT")) or 3
        local env_c = tonumber(ngx.getenv("NODE_C_WEIGHT")) or 2

        local weights = {
            ["10.0.1.10:8080"] = env_a,
            ["10.0.1.11:8080"] = env_b,
            ["10.0.1.12:8080"] = env_c,
        }

        -- 加权随机选择(简单版)
        local total = env_a + env_b + env_c
        local rand = math.random() * total
        local acc = 0
        for addr, w in pairs(weights) do
            acc = acc + w
            if rand <blockquote><p>✅ 优势:支持熔断、连接数限制、共享字典缓存指标;<br>
❗ 要求 OpenResty,且需启用 <code>lua_shared_dict</code> 配合更复杂的闭环调控。</p></blockquote><hr><h3>✅ 替代方案:用外部 API + nginx-upstream-dynamic-servers 模块</h3><p>如果只是想“让权重随环境变量变化”,更推荐用脚本监听变量变更,再调用模块提供的 HTTP 接口更新:</p><pre class="brush:bash;toolbar:false;"># 示例:当 NODE_A_WEIGHT 改变时,推送新权重
curl -X POST http://localhost/upstream/servers \
     -d '{"server":"10.0.1.10:8080","weight":'"$NODE_A_WEIGHT"' }'

配合 systemd 的 EnvironmentFile= 或 conf.d 下的 .env 文件,由 watchdog 脚本触发更新——比纯 NJS 更稳定、可观测。


不支持直接变量赋值,但所有可行路径都围绕一个事实:权重逻辑必须移出 upstream 块,在请求级或控制面实现。选哪种,取决于你是否已有 OpenResty、是否接受 reload、以及对实时性的要求。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx 环境变量 stream

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

363

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3007

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

5505

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

541

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1456

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3898

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

102

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

397

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

139

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习