Apache代理配置不能直接照搬到Nginx，因二者模型不同：Apache过程式、支持运行时重写和.htaccess，Nginx声明式、集中配置、无路径重解析；迁移关键在于重构流量治理逻辑，显性化分流意图、兼容处理与容错机制，再映射为Nginx的location+map+upstream+proxy_*指令组合。
直接照搬 Apache 的代理配置到 Nginx 会失败——因为两者模型不同：Apache 是过程式、支持运行时动态重写和目录级 .htaccess，而 Nginx 是声明式、集中配置、无运行时路径重解析。平滑迁移的关键不是“语法转换”，而是重构流量治理逻辑，把旧拓扑中隐含的分流意图、兼容处理、容错机制显性化落地到 Nginx 的 location + map + upstream + proxy_* 指令组合中。
先还原拓扑意图，再映射为 Nginx 结构
别急着改配置。打开 Apache 的 httpd.conf 和所有 Include 的虚拟主机、.htaccess、mod_proxy 配置，逐条梳理：
- 哪些路径被 proxy_pass 到哪个后端？是否带路径重写（如 ProxyPass /api/ http://old:8080/v1/）？
- 是否存在基于 Header、Cookie 或 IP 的条件转发（如 RewriteCond %{HTTP:X-Env} dev）？
- 有没有健康检查行为（如 ProxyHCExpr）、故障转移策略（BalancerMember status=+H）或权重控制（loadfactor）？
- 是否透传了 Host、X-Forwarded-*、Authorization 等关键头？有无隐藏或修改特定 Header？
把这些逻辑整理成一张表：源路径 → 匹配条件 → 目标后端 → 头处理 → 降级策略。这张表就是 Nginx 配置的蓝图。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
用 map + upstream 实现多维路由与动态后端选择
Apache 常用 RewriteCond + RewriteRule 做条件判断，Nginx 推荐用 map 提前提取变量，避免在 location 中嵌套 if（易出错且性能差）：
- 按请求头选后端：map $http_x_release_stage $upstream_backend { "beta" "micro-beta"; "prod" "micro-prod"; default "legacy"; }
- 按 Cookie 版本灰度：map $cookie_version $upstream_backend { "v2" "new-svc"; ~*v1 "legacy-svc"; default "legacy-svc"; }
- 定义对应 upstream：upstream legacy-svc { server 10.0.1.10:8080 max_fails=3 fail_timeout=30s; } upstream new-svc { server 10.0.2.5:9001; }
- 在 location 中调用：proxy_pass http://$upstream_backend;
路径重写与上下文透传必须显式声明
Apache 的 ProxyPass /api/ http://svc/v2/ 会自动剥离 /api/ 并拼接，Nginx 的 proxy_pass 不具备该语义，需手动用 rewrite 或 proxy_redirect 补齐：
- 若需等效行为（/api/users → /v2/users），用 rewrite：location ^~ /api/ { rewrite ^/api/(.*)$ /v2/$1 break; proxy_pass http://new-svc; }
- 务必透传原始 Host 和客户端真实 IP：proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme;
- 若后端依赖特定 Cookie 名（如 JSESSIONID），用 proxy_cookie_path 和 proxy_cookie_domain 重写路径与域；必要时用 sub_filter 替换响应体中的 Set-Cookie 字段。
健康检查、降级与可观测性不能靠默认值
Apache 的 mod_proxy_hcheck 有成熟探测能力，Nginx 开源版需组合配置才能达到相近效果：
- 基础探活：upstream new-svc { server 10.0.2.5:9001 max_fails=2 fail_timeout=15s; }
- 主动 HTTP 健康检查（需编译 nginx_upstream_check_module）：check interval=5 rise=2 fall=3 timeout=3 type=http; check_http_send "HEAD /health HTTP/1.0\r\n\r\n"; check_http_expect_alive http_2xx;
- 自动降级：proxy_next_upstream error timeout http_500 http_502 http_503; proxy_next_upstream_tries 2;（要求 upstream 同时包含新旧两组 server）
- 可观测性增强：log_format migration '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$upstream_addr" "$upstream_http_x_service_version" $request_time';
