Python 后端基础（十八）：Nginx 怎么用，反向代理、静态资源、HTTPS 和负载均衡讲清楚

很多 Python 后端项目本地是直接访问 `localhost:8000`，但上线后一般不会让用户直接访问 Uvicorn 或 Gunicorn。

更常见的做法是：用户先访问 Nginx，Nginx 再把请求转发给后端服务。

【一、Nginx 是什么】

Nginx 是一个高性能 Web 服务器，也常用作反向代理。

常见用途：

- 反向代理后端 API。

- 托管静态资源。

- 配置 HTTPS。

- 做负载均衡。

- 做请求限流。

- 统一入口转发多个服务。

【二、什么是反向代理】

反向代理就是用户不直接访问后端服务，而是访问代理服务器。

用户浏览器

-> Nginx 80/443

-> 后端 FastAPI 8000

用户只知道域名，不需要知道后端服务端口。

配置示例：

server {

listen 80;

server_name example.com;

location /api/ {

proxy_pass http://127.0.0.1:8000/;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

}

}

【三、为什么不用后端服务直接暴露】

原因：

- Nginx 更适合处理公网流量。

- 可以统一配置 HTTPS。

- 可以转发多个后端服务。

- 可以处理静态文件。

- 可以做限流和负载均衡。

- 后端服务只需要监听内网端口。

这是一种更常见的生产部署方式。

【四、静态资源】

前端打包后的文件可以由 Nginx 提供。

location / {

root /var/www/frontend;

index index.html;

try_files $uri $uri/ /index.html;

}

后端只负责 API，前端静态文件交给 Nginx，效率更高。

【五、HTTPS 配置】

HTTPS 证书一般配置在 Nginx 层。

server {

listen 443 ssl;

server_name example.com;

ssl_certificate /etc/nginx/certs/fullchain.pem;

ssl_certificate_key /etc/nginx/certs/privkey.pem;

}

用户访问 HTTPS，Nginx 负责 TLS，后端服务可以继续使用内网 HTTP。

【六、负载均衡】

如果有多个后端实例：

upstream backend {

server 127.0.0.1:8001;

server 127.0.0.1:8002;

}

server {

listen 80;

location /api/ {

proxy_pass http://backend;

}

}

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;

proxy_set_header X-Forwarded-Proto $scheme;

这些头可以让后端知道原始请求的域名、用户 IP 和协议。

【八、常见坑】

- Nginx 转发路径多了或少了 `/`，导致接口 404。

- 后端只监听 `127.0.0.1`，但容器之间访问失败。

- 文件上传大小超过 Nginx 默认限制。

- 超时时间太短，AI 接口还没返回就 504。

- 没配置 HTTPS，登录 token 明文传输。

- 静态资源路径配置不对，前端刷新页面 404。

【九、面试常问】

1. Nginx 在后端部署中有什么作用？

Nginx 常作为统一入口，负责反向代理、静态资源、HTTPS、负载均衡、限流等，把公网请求转发给内部后端服务。

2. 正向代理和反向代理区别是什么？

正向代理代理客户端，比如公司代理服务器；反向代理代理服务端，比如用户访问 Nginx，Nginx 转发到后端服务。

3. 502 和 504 一般是什么问题？

502 通常是网关无法从上游服务获得有效响应，可能后端挂了或端口错了；504 通常是上游服务响应超时，比如后端处理太慢。