当前位置：首页>Linux>Linux进阶 | Nginx 服务安装与配置(五):反向代理与 502 排错实战

Linux进阶 | Nginx 服务安装与配置(五):反向代理与 502 排错实战

2026-03-08 15:02:32

在开始本篇的内容前，可以关注并私信【nginx】获取【深入剖析Nginx】电子书！废话不多说，开始本节的内容！

前一篇我们完成了：

多站点部署
虚拟主机配置
日志拆分

但真正的生产环境，Nginx 很少只做“静态服务器”。

一、什么是反向代理？

通俗解释：

用户 → Nginx → 后端应用 → Nginx → 用户

在企业架构中，Nginx 充当流量入口层。

二、模拟一个后端服务

为了演示，我们用 Python 快速启动一个后端服务。

在服务器执行：

python3 -m http.server 8080

这会在 8080 端口启动一个简单 HTTP 服务。

测试：

curl http://127.0.0.1:8080

如果有返回，说明后端正常。

三、配置反向代理

编辑虚拟主机文件：

vim /etc/nginx/conf.d/proxy.conf

写入：

server {    listen 80;    server_name proxy.local;    location / {        proxy_pass http://127.0.0.1:8080;    }}

检查并重载：

nginx -tnginx -s reload

访问：

http://proxy.local

四、proxy_pass 的路径坑点（高频踩坑）

这是面试与生产中最容易出错的地方。

看两个配置：

情况 1（带斜杠）

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

情况 2（不带斜杠）

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

假设访问：

/api/test

五、前后端分离典型配置

server {  listen 80;  server_name demo.local;  location / {    root /data/www/frontend;    index index.html;  }  location /api/ {    proxy_pass http://127.0.0.1:8080/;  }}

六、502 Bad Gateway 排查

最常见线上问题。

原因一：后端未启动

检查：

ss -lntp | grep 8080

systemctl stop firewalld

原因四：权限或 SELinux

临时关闭：

setenforce 0

七、504 Gateway Timeout

表示：后端响应超时

默认超时时间较短。

可增加：

proxy_read_timeout 60s;

放在 location 内。

八、增强版代理配置（推荐生产使用）

location /api/ {  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;}