Nginx动态配置upstream的使用小结

一、常见动态配置方法

1. 使用 Nginx Plus（商业版）

upstream_conf API（旧版）或 ngx_http_api_module（新版）提供RESTful接口动态管理upstream。
示例：通过HTTP请求添加/删除后端服务器。
仅适用于商业版，开源版不支持。

2. 使用开源替代方案

ngx_http_dyups_module（第三方模块）：
- 通过API动态增删/修改upstream。
- 需自行编译安装，可能存在版本兼容性问题。
lua-nginx-module（OpenResty）：
- 用Lua脚本操作ngx.shared.DICT或结合外部存储（如Redis）实现动态更新。
- 示例：通过Lua从数据库读取后端列表并更新upstream。

3. 结合服务发现工具

Consul + nginx-upsync-module：
- 从Consul同步upstream配置到Nginx。
- 步骤：
- 编译Nginx时添加nginx-upsync-module。
- 配置upstream从Consul拉取节点列表。
- 在Consul中管理服务节点，Nginx自动同步。

Kubernetes环境：

使用nginx-ingress-controller自动根据Service Endpoints更新upstream。

4. 动态DNS解析

在upstream中使用域名，并通过resolver指令设置动态DNS：

resolver 8.8.8.8 valid=10s;
upstream backend {
    server backend.example.com resolve;
}

Nginx按valid时间间隔重新解析域名，实现节点变化自动更新。

二、配置示例（以OpenResty为例）

使用Lua动态更新upstream：

http {
    lua_shared_dict dynamic_upstreams 10m;

    upstream backend {
        server 0.0.0.0; # 占位符
        balancer_by_lua_block {
            local balancer = require "ngx.balancer"
            local upstreams = ngx.shared.dynamic_upstreams
            local peers = upstreams:get("backend_peers") or "127.0.0.1:8080"
            -- 解析peers并设置当前请求的后端
            balancer.set_current_peer(host, port)
        }
    }

    location /update {
        content_by_lua_block {
            -- 从请求参数或外部存储获取新节点列表
            local new_peers = ngx.var.arg_peers
            ngx.shared.dynamic_upstreams:set("backend_peers", new_peers)
            ngx.say("Updated")
        }
    }
}