Nginx通过location匹配+proxy_pass路径截断实现企业官网伪静态，如/location /news/ { proxy_pass https://backend/api/articles/;}/将/news/20240101转为/api/articles/20240101，根路径用=精确匹配或^~统一处理，辅以rewrite跳转、大小写规范及header透传确保语义转换与缓存协同。
在 Nginx 中用 proxy_pass 做反向代理时，实现企业官网的伪静态路径优化，核心是让外部访问的友好 URL（如 /about、/news/20240101）不暴露后端真实路径或参数，同时保持后端服务无需改造。这并非靠重写 URL 参数实现，而是通过 location 匹配 + proxy_pass 路径截断 + 可选的 rewrite 补充来完成。
明确伪静态目标与后端接口约定
企业官网伪静态通常指：用户请求 /company 实际调用后端 /api/pages?slug=company，或请求 /products/detail?id=123 被转为 /api/v1/product/123。务必先和开发确认后端是否支持 RESTful 路由或接受 slug 参数 —— Nginx 本身不生成内容，只做路径映射与透传。
- 避免把伪静态理解为“隐藏 .php”——那是静态文件场景，代理场景重点是路径语义转换
- 后端若只支持 query 形式（如
/index.php?c=page&a=show&slug=news），Nginx 可用rewrite ... break拼接参数，再 proxy_pass 到 PHP-FPM 或网关 - 若后端是 Node/Java 等现代服务，优先走 clean path（如
/api/page/news），更利于 cache 和 SEO
用 location + proxy_pass 截断路径实现干净转发
这是最常用也最推荐的方式。利用 proxy_pass 后带路径时自动截断匹配前缀的特性，避免手动 rewrite。
例如，所有以 /news/ 开头的请求，需转发到后端 /api/articles/，且保留后续路径：
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
location /news/ {
proxy_pass https://backend-api.example.com/api/articles/;
}说明：
– 请求 /news/20240101 → 后端收到 /api/articles/20240101
– /news/category/tech → /api/articles/category/tech
– 注意末尾斜杠必须一致，否则 Nginx 不截断，会把完整路径（包括 /news/...）拼过去
对根级伪静态页（如 /about、/contact）做精准匹配转发
这类无层级的单页，适合用 = 精确匹配或 ^~ 前缀匹配，避免误触其他规则：
location = /about {
proxy_pass https://backend-api.example.com/api/pages?slug=about;
}
<p>location = /contact {
proxy_pass <a href="https://www.php.cn/link/e81b242446051beef26f1b77447b7206">https://www.php.cn/link/e81b242446051beef26f1b77447b7206</a>;
}</p><h1>或统一处理</h1><p>location ^~ / {
proxy_set_header X-Original-URI $request_uri;
proxy_pass <a href="https://www.php.cn/link/a80b0d78801cbc324e13fa9e0df7e4b5">https://www.php.cn/link/a80b0d78801cbc324e13fa9e0df7e4b5</a>;
}注意：
– proxy_pass 含 query string 时，Nginx 默认丢弃原始 URI 中的参数（如 /about?ref=ad 的 ?ref=ad 不会自动带上），需显式拼接或用 $args
– 更稳妥写法：proxy_pass https://www.php.cn/link/a80b0d78801cbc324e13fa9e0df7e4b5&args=$args;
补充：兼容旧链接、强制规范路径格式
上线新伪静态规则后，常需处理历史链接跳转或补全缺失斜杠：
- 将
/products自动补斜杠跳转到/products/（利于 location /products/ 匹配）：location = /products { return 301 /products/; } - 把带 .html 后缀的请求（如
/about.html）重写为无后缀：rewrite ^/(.*)\.html$ /$1 permanent;，再交由后续 location 处理 - 统一小写路径（部分 CMS 生成大写）：
map $uri $lower_uri { default $uri; ~^(?<up>.*)$ ${up,,}; }<br> proxy_pass https://backend/$lower_uri;（需开启underscores_in_headers on等配合）
不复杂但容易忽略的是 header 透传与缓存协同。加上 proxy_set_header X-Forwarded-Path $uri; 可帮后端识别原始路径；搭配 proxy_cache 时，用 proxy_cache_key "$scheme$request_method$host$uri$is_args$args"; 才能正确区分不同伪静态入口的缓存。
