Nginx location 和 proxy_pass 配置详解

关注

原创最新推荐文章于 2026-07-27 11:22:41 发布 665 阅读 AI 写同款· GEO 优化 ›

Nginx代理规则总结更新时间：2022/6/17 18:22本文记录Nginx代理常见的几种规则，例如location，proxy_pass本文仅为记录学习轨迹，如有侵权,联系删除匹配的顺序如下，优先级由高到低这里简单举例说明一下匹配规则的优先级经过实际，大概可以分为以下4种情况（2）proxy_pass包括ip和资源路径，结尾有/ （3）proxy_pass只包括ip，结尾有/ （4）proxy_pass只包括ip，结尾没有/ 三、关于nginx配置文件的字符编码有些时候我们正常在nginx配置文件上阅读详情

概述

Nginx 配置中 location 和 proxy_pass 指令的不同组合方式及其对请求转发路径的影响。

配置效果

1. `location` 和 `proxy_pass` 都带斜杠 `/`

location /api/ {
    proxy_pass http://127.0.0.1:8080/;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080/upload

转发地址不带 location 匹配目录 /api/

2. `location` 不带斜杠，`proxy_pass` 带斜杠 `/`

location /api {
    proxy_pass http://127.0.0.1:8080/;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080//upload

转发地址会多带 /

3. `location` 带斜杠，`proxy_pass` 不带斜杠

location /api/ {
    proxy_pass http://127.0.0.1:8080;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080/api/upload

转发地址会带 location 匹配目录 /api/

4. `location` 和 `proxy_pass` 都不带斜杠

location /api {
    proxy_pass http://127.0.0.1:8080;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080/api/upload

转发地址会带 location 匹配目录 /api/

5. `location` 和 `proxy_pass` 都带斜杠 `/`，但 `proxy_pass` 带地址

location /api/ {
    proxy_pass http://127.0.0.1:8080/server/;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080/server/upload

转发地址不带 location 匹配目录 /api/

6. `location` 不带斜杠，`proxy_pass` 带斜杠 `/`，但 `proxy_pass` 带地址

location /api {
    proxy_pass http://127.0.0.1:8080/server/;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080/server//upload

转发地址不带 location 匹配目录 /api/ ，会多带 /

7. `location` 带斜杠，`proxy_pass` 不带斜杠，但 `proxy_pass` 带地址

location /api/ {
    proxy_pass http://127.0.0.1:8080/server;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080/serverupload

转发地址不带 location 匹配目录 /api/ 直接进行了替换

8. `location` 和 `proxy_pass` 都不带斜杠，但 `proxy_pass` 带地址

location /api {
    proxy_pass http://127.0.0.1:8080/server;
}

访问地址：www.hw.com/api/upload
转发地址：http://127.0.0.1:8080/server/upload

转发地址不带 location 匹配目录 /api

总结

当 proxy_pass 代理地址端口后有目录（包括 /），转发后地址为：代理地址 + 访问 URL 目录部分去除 location 匹配目录。
当 proxy_pass 代理地址端口后无任何内容，转发后地址为：代理地址 + 访问 URL 目录部分（包括 location 地址）。

场景示例

upstream backend_name_hw {
  server 10.10.10.10:32323 max_fails=2 fail_timeout=2;
}

server {
    listen      80;
    server_name hw.test.com;

    client_max_body_size 1024m;
    client_body_timeout 12;
    client_header_timeout 12;
    keepalive_timeout 15;
    send_timeout 10;

    location / {
      proxy_pass http://backend_name_hw;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
    
    location /hello {
      proxy_pass http://backend_name_hw/hello;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

在这里插入图片描述

    location /hw/ {
        proxy_pass http://hw-nginx/index.html;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

在这里插入图片描述

    location /hwhw/  {
        proxy_pass http://hw-nginx/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

在这里插入图片描述

    location /hw/hi/ {
        proxy_pass http://hw-nginx/hello/index.html;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

在这里插入图片描述

    location /hello/index.html {
        proxy_pass http://hw-nginx;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

在这里插入图片描述