如何配置Nginx Location实现/api路径的动态代理转发

我来帮你搞定这个Nginx代理的问题！你遇到的无响应情况，大概率是因为对Nginx的location匹配规则和proxy_pass的路径处理逻辑理解不到位。下面分两种常见场景给出正确配置，你可以根据自己的需求选择：

场景1：转发时保留/api前缀 #

如果你希望localhost/api/getMyName这类请求转发到127.0.0.1/api/getMyName（即目标路径保留/api前缀），可以用这个配置：

server {
    listen 80;
    server_name localhost;

    # 匹配所有以/api开头的请求，包括所有子路径
    location /api {
        proxy_pass http://127.0.0.1;
        
        # 这些代理头是可选但推荐的，避免后端服务获取不到正确的请求信息
        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 /api会匹配所有以/api开头的请求，不管后面跟着多少层级的子路径。
• proxy_pass后面没有加结尾的/，Nginx会把完整的请求路径（包括/api）原样转发到目标地址。

场景2：转发时去掉/api前缀 #

如果你希望localhost/api/getMyName转发到127.0.0.1/getMyName（即目标路径去掉/api前缀），用这个配置更合适：

server {
    listen 80;
    server_name localhost;

    # 匹配所有以/api/开头的子路径请求
    location /api/ {
        proxy_pass http://127.0.0.1/;
        
        # 同样加上必要的代理头
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # 精确匹配直接访问localhost/api的请求，重定向到带/的路径，避免匹配异常
    location = /api {
        return 301 /api/;
    }
}

关键说明： #

• location /api/的结尾/是关键，它会匹配所有以/api/开头的子路径（比如/api/getMyName）。
• proxy_pass后面的/会告诉Nginx把请求路径中匹配到的/api/部分替换成/，从而实现去掉前缀的效果。
• 额外的location = /api是为了处理用户直接访问localhost/api的情况，避免出现404或者匹配错误。

你之前配置无效的原因 #

你提到添加/*或*没用，这是因为Nginx的location匹配规则里，*不能直接这么用：

• 普通的前缀匹配不需要通配符，/api就已经能覆盖所有子路径了。
• 如果要用通配符，得用正则匹配（比如location ~^/api/），但前缀匹配已经足够解决你的问题，正则反而会增加不必要的性能开销。

最后一步：验证并重启Nginx #

配置写完后，先测试配置是否有语法错误：

nginx -t

如果提示test is successful，就重启Nginx让配置生效：

sudo nginx -s reload

内容的提问来源于stack exchange，提问作者ey dee ey em