map指令可直接提取cookie值并映射upstream，推荐用内置变量$cookie_version避免正则误匹配；需定义在http块顶层，proxy_pass动态拼接要求nginx≥1.3.10，default分支必须指向真实upstream以防502。
直接用 map 指令就能实现，不推荐 if + set 做路由判断——它在 location 块里行为不可靠，容易漏匹配、错分流，线上出过多次 502 或全量走默认 upstream 的事故。
怎么从 Cookie 提取值并映射到 upstream
Nginx 不自动解析 Cookie 字段，得靠正则从 $http_cookie 原始字符串里抠。常见错误是写 ~*gray=on，结果 graylog=xxx; gray=on 也被误命中。
- 正确写法用分组捕获+边界控制：
~*gray=([^;]+)，再用$1引用值（但map里不能用$1，只能靠整个匹配逻辑） - 更稳妥的写法是加单词边界：
~*;\s*gray=([^;]+)或直接锚定开头：~*^.*;\s*gray=([^;]+).*$，不过实践中用~*gray=([^;]+)(?:;|$)更简洁可靠 - 若 Cookie 名是
version，直接用 Nginx 内置变量$cookie_version——它已自动解码并剥离分号，无需正则，也不存在跨字段污染问题 -
map必须定义在http块顶层，不能嵌套在server或location里，否则会报 “invalid number of arguments”
proxy_pass 怎么拼接动态 upstream 名
必须确保 Nginx 版本 ≥ 1.3.10，否则 proxy_pass http://$upstream_name 会报 “invalid URL prefix” 错误。旧版本只能退化为 if + rewrite 或引入 Lua。
Linux Ai Server
下载
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 推荐命名规范：upstream 名统一带前缀，如
upstream backend_v1 { ... }、upstream backend_v2 { ... }，然后map输出v1/v2，再拼成http://backend_$version - 避免空值风险：
map的default分支必须存在，且值要对应一个真实定义的 upstream，否则请求直接 502 - 不要在
proxy_pass后加 URI 路径（如http://$upstream/），这会导致路径被重写；保持http://$upstream纯域名形式，路径由原始请求携带
为什么加了 Cookie 却没生效
最常踩的坑不是配置写错，而是调试时没看清实际发出去的请求头——浏览器 DevTools 的 Application → Cookies 里看到的值，未必等于 HTTP 请求头里真实发送的 Cookie: 字符串。
- 检查是否启用了
SameSite=Lax或Secure，导致测试环境（HTTP）下 Cookie 根本没发出去 - 用
curl -v -H "Cookie: gray=v2" http://your-domain/直连验证，绕过浏览器策略干扰 - 临时加响应头辅助排查：
add_header X-Upstream-Used $upstream_name;或add_header X-Cookie-Match "$cookie_gray"; - 确认 Nginx 编译时启用了
--with-http_map_module（主流发行版默认开启，但自编译或精简镜像可能未包含）
真正难的不是写对那几行 map，而是灰度期间如何让 default 分支足够健壮、如何防止正则误匹配、以及怎么在不重启的前提下快速切回老版本——这些细节没压进配置里，光有语法正确没用。
