关键在于用两级 map 将用户标识稳定映射为 backend 变量驱动 proxy_pass：一、优先选用 $cookie_user_id 等可信字段提取 uid；二、第一层 map 清洗 uid，第二层 map 基于哈希或白名单判定高频并映射 upstream 名；三、upstream 名须与 map 输出值严格一致；四、location 中 proxy_pass http://$backend（无尾斜杠）完成零逻辑分流。
要让高频用户自动走到 SSD 集群，关键不是“识别后手动转发”，而是用 map 把用户标识稳定映射成一个可复用的变量，再驱动 proxy_pass 和 upstream 选择——整个过程零 if、零 Lua、零重启，靠查表完成。
一、选准且稳定提取高频用户标识
高频用户通常有长期稳定的访问特征。优先使用以下变量之一作为源，避免临时或不可控字段：
- $cookie_user_id：前端登录后写入的唯一 ID（如 UUID 或数字 UID），最推荐
- $http_x_user_id：由网关或 SDK 统一透传的可信用户 ID（需确保不被伪造）
- $arg_uid：仅限 API 场景下显式携带、且服务端已校验过的 uid 参数
不建议用 $remote_addr（IP 易变）、$args（含多参数难匹配）或未校验的 header。
二、用两级 map 实现“识别 + 分流”解耦
第一层：从原始字段中清洗出标准 UID；第二层：基于业务规则判定是否高频 —— 这样便于单独验证、灰度开关、后续扩展（比如加地域维度）。
示例配置（放在 http{} 块内）：
map $cookie_user_id $clean_uid {
default "";
~^([a-zA-Z0-9_-]{8,})$ "$1";
}
<p>map $clean_uid $backend {
default "upstream-default";</p><h1>按 UID 哈希取模，固定 10% 用户走 SSD 集群（可调比例）</h1><p>"~^(?:[0-9a-f]{32}|[0-9]{8,})$" "upstream-ssd";</p><h1>或更精准：查白名单文件（需配合 include）</h1><h1>include /etc/nginx/conf.d/ssd_users.map;</h1><p>}</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting"><img
src="https://img.php.cn/upload/skill/000/000/081/179116929868126.jpg" alt="Nginx Hosting" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="overflowclass">Nginx Hosting</a>
<p class="overflowclass">通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。</p>
</div>
<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
说明：~^([a-zA-Z0-9_-]{8,})$ 确保只匹配合法长度的 UID 字符串；哈希逻辑由应用层或离线脚本生成白名单，map 仅做查表。
三、声明对应 upstream 并严格对齐名称
map 输出的值（如 "upstream-ssd"）必须与 upstream 块名称完全一致（包括大小写、连字符）：
upstream upstream-ssd {
server 10.20.30.101:8080 max_fails=2 fail_timeout=30s;
server 10.20.30.102:8080 max_fails=2 fail_timeout=30s;
keepalive 32;
}
<p>upstream upstream-default {
server 10.10.20.1:8080;
server 10.10.20.2:8080;
}</p>
⚠️ Nginx 启动时会校验所有 upstream 名称是否存在，拼错直接报错退出。
四、在 location 中安全引用并补全策略
真正路由发生在 location 块，proxy_pass 必须严格按规范写：
location /api/ {
proxy_pass http://$backend; # 末尾无斜杠！
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
<h1>可选：为 SSD 流量启用更大缓冲和连接复用</h1><p>proxy_buffer_size $ssd_buffer_size;
proxy_http_version 1.1;
proxy_set_header Connection '';
}</p>
其中 $ssd_buffer_size 可另配 map 控制（例如对 SSD 流量设 16k，普通流量 4k），提升大响应头处理效率。
不复杂但容易忽略：map 是启动加载的静态查表，只要变量提取准确、名称对齐、proxy_pass 写法合规，高频用户就会被无声、稳定、低延迟地导向 SSD 集群。
