Nginx中结合proxy_pass与Lua动态选择后端集群，需基于OpenResty，在access_by_lua_block中设置$backend变量并指向预定义upstream或拼接完整URL，proxy_pass引用该变量实现动态转发。
在 Nginx 中结合 proxy_pass 与 Lua 动态选择后端集群，核心是利用 lua-nginx-module（通常通过 OpenResty 提供）在请求处理的特定阶段（如 access_by_lua* 或 rewrite_by_lua*）修改 $backend 变量，再让 proxy_pass 指向该变量。
1. 基础前提：确保环境支持 Lua
必须使用 OpenResty 或编译了 lua-nginx-module 的 Nginx。验证方式：
- 执行
nginx -V 2>&1 | grep -o with-http-lua-module，有输出即支持 - 配置中能正常使用
lua_package_path、access_by_lua_block等指令
2. 使用变量 + proxy_pass 实现动态转发
proxy_pass 支持变量（从 Nginx 1.3.12+ 开始），但有严格限制：不能包含 URI 路径（即不能写成 proxy_pass http://$backend/xxx），且变量值必须是合法的 upstream 名或 host:port。
推荐做法是预先定义好 upstream 块，用变量引用其名称：
upstream cluster_a {
server 10.0.1.10:8080;
server 10.0.1.11:8080;
}
<p>upstream cluster_b {
server 10.0.2.20:8080;
server 10.0.2.21:8080;
}</p><p>server {
listen 80;
set $backend "cluster_a"; # 默认值，必须初始化</p><pre class="brush:php;toolbar:false;">access_by_lua_block {
local host = ngx.var.host
local uri = ngx.var.uri
local uid = ngx.var.arg_uid or "anonymous"
-- 示例逻辑：按用户 ID 哈希分集群
local hash = ngx.crc32_short(uid)
if hash % 2 == 0 then
ngx.var.backend = "cluster_a"
else
ngx.var.backend = "cluster_b"
end
}
location /api/ {
proxy_pass http://$backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
3. 更灵活的方式：运行时拼接后端地址（不依赖 upstream 块）
若需完全动态构造地址（如从 Redis 查询、或基于请求头实时计算 IP:PORT），可跳过 upstream，直接拼接字符串：
- 确保
proxy_pass后只跟变量，且变量值形如"http://10.0.3.30:8080"或"https://example.com" - 注意协议必须显式写出，Nginx 不会自动补全
- 避免在变量中包含路径（如
"http://x/y"），否则整个 URI 会被重写，导致后端接收错误路径
示例：
access_by_lua_block {
local ip = "10.0.3." .. (ngx.crc32_long(ngx.var.remote_addr) % 4 + 30)
local port = 8080
ngx.var.backend = "http://" .. ip .. ":" .. port
}
<p>location / {
proxy_pass $backend; -- 注意这里没有斜杠结尾，也不带路径
}</p>
4. 注意事项与避坑点
关键限制：
-
proxy_pass中的变量不能在if块内赋值后直接生效（因变量作用域和指令解析时机问题），务必在access_by_lua_block或rewrite_by_lua_block中设置，并确保执行顺序早于 proxy_pass - 不要在
set $backend后用if修改它——Lua 之外的上下文无法可靠更新该变量用于 proxy_pass - 启用
resolver（如需 DNS 解析动态域名），否则变量里用域名会失败 - 动态地址若含端口，确保防火墙与后端服务监听正确；若用 HTTPS，需额外配置 SSL 相关指令（如
proxy_ssl_*）
调试建议：开启 error_log /path/to/log notice;，在 Lua 中用 ngx.log(ngx.NOTICE, "backend=", ngx.var.backend) 打印实际值。
