Nginx 中 HTTP 代理如何实现请求的重写与拦截-Nginx-PHP中文网

nginx http代理不直接重写请求，而是通过rewrite+proxy_pass组合实现路径改写与代理；rewrite修改请求路径，proxy_pass转发改写后请求，return/deny/if/location控制拦截与跳转；常用场景包括api路径标准化、前端路由代理、防盗链、spa回退及http→https强制跳转。

nginx 中 http 代理如何实现请求的重写与拦截

Nginx 中 HTTP 代理本身不直接“重写请求”，而是通过 rewrite（重写） + proxy_pass（代理）的组合，或配合 location、if、return 等指令实现路径改写、跳转、拦截等行为。关键在于分清：

rewrite 改的是请求路径（内部重写或客户端跳转）；
proxy_pass 做的是把改完后的请求发给后端；
拦截靠的是 return、deny、if 判断或 location 匹配控制流向。

路径重写后再代理（最常用）

适用于统一 API 入口、前端路由代理、后端路径标准化等场景。
比如把 /api/v1/users 改成 /v1/users 再转发给后端服务：

location /api/ {
    rewrite ^/api/(.*)$ /$1 break;
    proxy_pass http://backend;
    proxy_set_header Host $host;
}

rewrite ... break：仅在当前 location 内生效，改完路径后立刻执行 proxy_pass，不重新匹配 location；
proxy_pass 末尾不加 / → 发送完整路径 /api/v1/users；
proxy_pass 末尾加 / → 自动剥离 /api/，发送 /v1/users（推荐）；
不要用 last，否则可能触发循环匹配（尤其当后端也走 / location 时）。

主动拦截非法或敏感请求

不转发、不查文件，直接响应控制：

# 禁止访问配置类资源
location ~* \.(env|ini|conf|yml|json)$ {
    return 403;
}

# 拦截特定路径前缀
location /admin/ {
    deny 192.168.10.5;
    allow 192.168.10.0/24;
    allow 127.0.0.1;
    deny all;
}

# 防盗链（只允许自家域名引用静态资源）
location ~* \.(jpg|png|gif)$ {
    valid_referers server_names *.example.com;
    if ($invalid_referer) {
        return 403;
    }
}

return 403 比 deny all 更明确，且可搭配日志记录；
valid_referers + $invalid_referer 是防盗链标准做法；
deny/allow 顺序必须严格：先列具体拒绝项，再放行大范围，最后 deny all 收底。

基于条件做重定向或兜底路由

常见于单页应用（SPA）或旧链接迁移：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

# 文件不存在时，全部回退到 index.html（支持前端路由）
location / {
    try_files $uri $uri/ /index.html;
}

# 或用 if + rewrite 实现（注意 if 在 location 外慎用）
if (!-e $request_filename) {
    rewrite ^(.*)$ /index.html break;
}

# 将旧文章路径永久跳转到新地址
rewrite ^/blog/(\d+)\.html$ /articles/$1 permanent;

try_files 是更推荐的方式，性能好、逻辑清晰；
if 在 location 块内可用，但避免在 server 级别滥用（Nginx 官方不建议）；
permanent = 301，适合 SEO 迁移；临时跳转用 redirect（302）。

HTTP → HTTPS 强制跳转与域名归一化

属于客户端重定向，不涉及代理，但常与代理共存：

# 所有 HTTP 请求跳 HTTPS
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

# 移除 www（HTTPS 下）
server {
    listen 443 ssl;
    server_name www.example.com;
    ssl_certificate ...;
    ssl_certificate_key ...;
    return 301 https://example.com$request_uri;
}