在 nginx 中配置代理协议版本,核心在于使用 proxy_ssl_protocols 指令来指定后端服务器支持的 tls/ssl 协议版本。该指令仅对 https 上游(upstream)有效,通过设置如 tlsv1.2 tlsv1.3 等参数,nginx 将严格限制其与后端建立加密连接时使用的协议,从而确保通信安全并符合合规要求。

如何在全局或 Server 块中启用特定 TLS 版本
若需为所有基于 HTTPS 的上游请求统一设置协议版本,可在 http 上下文或具体的 server 块中直接添加 proxy_ssl_protocols 指令。例如,设置为 TLSv1.2 TLSv1.3 可禁用不安全的旧版本协议。此配置会立即影响该作用域内所有指向 HTTPS 后端的 proxy_pass 请求,Nginx 会与后端协商选择双方都支持的最高版本。
events {
worker_connections 1024;
}
http {
# 全局默认配置
proxy_ssl_protocols TLSv1.2 TLSv1.3;
server {
listen 80;
server_name example.com;
location /api {
proxy_pass https://backend-server:8443;
# 继承上方的全局配置
}
}
}
预期结果:当客户端访问 /api 时,Nginx 与 backend-server 的 HTTPS 连接将仅使用 TLSv1.2 或 TLSv1.3。如果后端仅支持 TLSv1.1,连接将失败并返回 502 Bad Gateway 错误。
如何在特定 Location 中覆盖全局协议设置
当不同后端服务需要不同的安全策略时,可以在 location 块中重新定义 proxy_ssl_protocols。这种局部配置会覆盖所在 server 或 http 级别的全局设置。例如,对于内部可信的后端,可以允许较旧的协议;而对于外部敏感接口,则强制使用最新协议。这种细粒度控制确保了灵活性与安全性的平衡。
events {
worker_connections 1024;
}
http {
server {
listen 80;
server_name example.com;
# 默认使用较严格的协议
proxy_ssl_protocols TLSv1.2 TLSv1.3;
location /secure-api {
proxy_pass https://secure-backend:8443;
# 保持默认,使用 TLSv1.2/1.3
}
location /legacy-api {
proxy_pass https://legacy-backend:8443;
# 覆盖为包含旧版本,以兼容老旧系统
proxy_ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
}
}
}
预期结果:访问 /secure-api 时,Nginx 与 secure-backend 协商使用 TLSv1.2 或 TLSv1.3;而访问 /legacy-api 时,Nginx 与 legacy-backend 协商时允许 TLSv1、TLSv1.1 和 TLSv1.2。若 legacy-backend 不支持这些版本,连接同样会失败。
当后端仅支持 TLSv1.2 时配置会发生什么
如果后端服务器仅支持 TLSv1.2,而 Nginx 配置的 proxy_ssl_protocols 中包含了 TLSv1.3 但未包含 TLSv1.2,或者完全禁用了 TLSv1.2,那么 Nginx 将无法与后端建立有效的 SSL/TLS 握手。在这种情况下,Nginx 会记录错误日志,提示无法协商出共同的协议版本,并向客户端返回 502 Bad Gateway 响应。因此,必须确保配置的协议列表与后端实际支持的版本有交集。
events {
worker_connections 1024;
}
http {
server {
listen 80;
server_name example.com;
location /test {
proxy_pass https://backend-only-tls12:8443;
# 假设后端只支持 TLSv1.2
# 如果这里配置了 proxy_ssl_protocols TLSv1.3; 则会失败
# 正确配置应包含 TLSv1.2
proxy_ssl_protocols TLSv1.2;
}
}
}
预期结果:当 proxy_ssl_protocols 设置为 TLSv1.2 且后端仅支持 TLSv1.2 时,连接成功建立。若设置为 TLSv1.3,则连接失败,Nginx 错误日志中将出现类似 "no shared cipher" 或 "protocol version mismatch" 的信息,客户端收到 502 错误。











