Apache通过mod_rewrite和mod_proxy实现灰度发布，核心是“识别请求属性→条件路由→代理后端”，支持Header、Cookie多条件分流，配合默认路由与热更新保障稳定性。
Apache 本身不直接管理灰度逻辑，但能通过 mod_rewrite 提取请求特征 + mod_proxy 显式转发，实现动态内容的灰度发布。关键在于“识别请求属性 → 条件路由 → 代理到对应后端”，整个过程无需重启服务，reload 配置即可生效。
基于请求头做灰度分流
这是最常用、最可控的方式，适合前端或网关层注入灰度标识（如 X-Release-Stage: canary）：
- 确保已启用
mod_proxy、mod_proxy_http和mod_rewrite - 用
RewriteCond %{HTTP:X-Release-Stage} ^canary$ [NC]匹配灰度请求 - 用
RewriteRule ^/(.*)$ http://canary-app:8080/$1 [P,L]将匹配请求代理过去 - 该规则必须放在所有通用
ProxyPass指令之前，否则会被默认路由覆盖
基于 Cookie 实现用户级灰度
适合登录态用户固定走新版本，比如内部员工或白名单用户：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 用
RewriteCond %{HTTP_COOKIE} (?:^|;\s*)gray=(v2|canary)(?:;|$)安全提取 Cookie 值 - 配合
[E=GRAY_VERSION:%1]把值存入环境变量，便于复用 - 后续规则可统一用
RewriteCond %{ENV:GRAY_VERSION} =v2判断，避免重复正则解析 - 注意 Cookie 的
Domain和Path要与请求路径匹配，否则读不到
默认路由 + fallback 保障稳定性
灰度只是“例外路径”，稳定集群才是主干流量：
- 在条件规则之后，配置默认代理：
ProxyPass / http://stable-app:8080/ - 务必补上
ProxyPassReverse / http://stable-app:8080/，否则响应头里的Location或Set-Cookie会暴露后端地址 - 若灰度和稳定后端共用根路径，两个
ProxyPassReverse都要写，顺序不影响匹配 - 建议对后端加
retry=30 timeout=5，故障时自动摘除节点
进阶：多条件组合与配置热更新
真实场景常需叠加判断，比如“先看 Header，没有再按用户 ID 哈希抽样 5%”：
- 可用多个
RewriteCond连续判断，或用SetEnvIf预设环境变量，再配合 Apache 2.4+ 的<If>块做嵌套逻辑 - 把后端定义拆成独立文件（如
backends-canary.conf），主配置用Include引入，切换时只改软链接或 Include 路径 - 执行
apachectl configtest && apachectl graceful即可热生效，不中断已有连接
