Nginx 反向代理入门实战:proxy_pass、负载均衡与常见配置误区

举报
yd_252022162 发表于 2026/11/14 06:06:54 2026/11/14
【摘要】 很多新手第一次部署 Web 应用时都会遇到同一个问题:服务明明在本地跑得好好的,一放到服务器上,用户却访问不到。这时往往不是程序写错了,而是缺了一个“门面”——反向代理。本文就用一个能直接跑起来的例子,讲清 Nginx 反向代理的用法、负载均衡的做法,以及新手最容易踩的几个坑。 一、反向代理到底在代理谁正向代理是替客户端去访问目标服务器,反向代理则相反:它站在服务器前面,替后端服务接收用户的...

很多新手第一次部署 Web 应用时都会遇到同一个问题:服务明明在本地跑得好好的,一放到服务器上,用户却访问不到。这时往往不是程序写错了,而是缺了一个“门面”——反向代理。本文就用一个能直接跑起来的例子,讲清 Nginx 反向代理的用法、负载均衡的做法,以及新手最容易踩的几个坑。

一、反向代理到底在代理谁

正向代理是替客户端去访问目标服务器,反向代理则相反:它站在服务器前面,替后端服务接收用户的请求。用户只看到 Nginx,并不知道背后是哪台应用服务器在真正干活。这样做有三个直接好处:第一,可以隐藏后端服务的真实地址和端口;第二,可以在入口处统一做缓存、限流和安全控制;第三,后端服务可以随时扩容或下线,用户完全无感知。

二、一个能跑起来的最小配置

假设后端应用监听在 8080 端口,我们希望用户访问 80 端口时由 Nginx 转发过去。把下面这段配置写进 nginx.conf,检查无误后重载即可:

server {
    listen 80;
    server_name example.com;
    location / {
        proxy_pass http://127.0.0.1:8080;
        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_pass,它决定了请求被转发到哪里。后面的三行 proxy_set_header 也别省:它们把原始域名和客户端真实 IP 透传给后端,否则后端拿到的请求头里全是 Nginx 自己的信息,日志和鉴权都可能出错。

三、负载均衡:把流量分给多台后端

一台后端扛不住时,就用 upstream 把多台后端编成一组,Nginx 默认按轮询把请求依次分发:

upstream app_servers {
    server 127.0.0.1:8080 weight=3;
    server 127.0.0.1:8081 weight=1;
    server 127.0.0.1:8082 backup;
}
server {
    listen 80;
    location / {
        proxy_pass http://app_servers;
    }
}

weight 越大,分到的请求越多,适合性能不一的机器混用的场景;标了 backup 的那台平时不接流量,只在其他后端都不可用时顶上。如果业务要求同一用户总是落到同一台后端,可以在 upstream 里改用 ip_hash,让 Nginx 按客户端 IP 做哈希分配。需要注意的是,负载均衡只是分发请求,并不能代替后端本身的高可用设计,数据库和会话状态仍要另外考虑。

四、五个常见配置误区

第一,proxy_pass 后面的地址末尾有没有斜杠,含义完全不同。带斜杠时,location 匹配到的部分会被替换掉;不带斜杠时,原始路径会原样拼到后端地址后面,稍不注意就会转发到错误的路径上。第二,location 的匹配规则容易被误解:location /api/ 只匹配以该前缀开头的请求,而 location = / 只精确匹配根路径,写错一个符号,请求就可能走到另一个分支。第三,改完配置只保存不重载。nginx.conf 改完后一定要先用 nginx -t 检查语法,再用 nginx -s reload 重载,否则新配置根本不会生效。第四,超时时间用默认值硬扛慢接口。后端接口耗时较长时,要合理设置 proxy_connect_timeout、proxy_read_timeout 等参数,否则用户看到的只会是莫名其妙的 502。第五,把所有配置都堆在一个文件里。站点一多,nginx.conf 会变得难以维护,建议按站点拆分成多个配置文件,再用 include 引入,主文件只保留全局设置。

五、出问题时先查什么

反向代理出问题时,别急着改代码,先按顺序排查:用 nginx -t 确认配置语法通过;确认 Nginx 进程已经重载;用 curl 直接访问后端地址,判断是后端挂了还是代理配错了;最后查看 error.log,多数 502、504 的原因都能在日志里找到对应的上游地址和错误码。

结语

反向代理并不神秘,它的核心就是“接请求、转请求、回响应”。先把最小配置跑通,再逐步加上负载均衡和超时、日志这些配套设置,遇到问题按“语法、重载、后端、日志”四步排查,大多数故障都能快速定位。把这套流程走熟之后,再去研究缓存、限流和 HTTPS 卸载,底子会扎实得多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。