Nginx 反向代理配置详解

Mon, 15 Jan 2024 10:00:00 +0800

Nginx 是一款高性能的 HTTP 和反向代理服务器，几乎是后端架构的标配。本文记录常用的反向代理配置。

最简单的反向代理

将所有请求转发到后端应用服务器：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


server {
 listen 80;
 server_name example.com;

 location / {
 proxy_pass http://127.0.0.1:3000;
 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 Host：传递原始域名
X-Real-IP / X-Forwarded-For：让后端拿到真实客户端 IP

负载均衡

用 upstream 块定义后端池：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


upstream backend {
 least_conn;
 server 10.0.0.1:3000 weight=3;
 server 10.0.0.2:3000 weight=2;
 server 10.0.0.3:3000;
}

server {
 listen 80;
 location / {
 proxy_pass http://backend;
 }
}

常用策略：

默认轮询：请求依次分配
weight=：权重越大分到的越多
least_conn：连接数最少的优先
ip_hash：同一客户端固定到同一后端

WebSocket 代理

Nginx 默认不支持 WebSocket 转发，需要显式声明 Upgrade 头：

1
2
3
4
5
6


location /ws {
 proxy_pass http://backend;
 proxy_http_version 1.1;
 proxy_set_header Upgrade $http_upgrade;
 proxy_set_header Connection "upgrade";
}

HTTPS 终结

让 Nginx 处理 HTTPS，后端走明文 HTTP（仅内网用）：

1
2
3
4
5
6
7
8
9


server {
 listen 443 ssl;
 ssl_certificate /etc/nginx/ssl/cert.pem;
 ssl_certificate_key /etc/nginx/ssl/key.pem;

 location / {
 proxy_pass http://127.0.0.1:3000;
 }
}

小结

Nginx 的反向代理功能强大，配置简洁，是后端架构中不可或缺的组件。掌握 proxy_pass、upstream、WebSocket Upgrade 头这三个核心点，基本能覆盖 80% 的日常场景。

负载均衡 on Liangweidong's blog

Nginx 反向代理配置详解

最简单的反向代理

负载均衡

WebSocket 代理

HTTPS 终结

小结