Nginx多域名反向代理强制HTTPS出现无限循环问题求助

核心原因及修复方案 #

1. 后端未识别HTTPS请求 #

Nginx已将HTTP请求转HTTPS，并通过X-Forwarded-Proto https告知后端，但如果后端服务未读取该头，会误认为请求是HTTP，进而返回301重定向到HTTPS，形成循环。

修复：

• 开启后端服务读取X-Forwarded-Proto的功能：
  • Flask框架：使用werkzeug.middleware.proxy_fix.ProxyFix中间件，设置x_proto=1
  • Express框架：启用trust proxy配置，配合express-x-forwarded-proto中间件
• 若后端无法修改，在Nginx代理配置中补充以下头信息，强制后端识别HTTPS：

  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Host $host;
  proxy_set_header X-Forwarded-Proto https;
  proxy_set_header X-Url-Scheme https;
  

2. 未覆盖所有域名的Server块 #

当前配置仅针对example.com，其余域名会匹配Nginx默认Server块。若默认块的HTTP转HTTPS规则与HTTPS代理逻辑冲突，会触发循环。

修复：

• 为每个域名单独配置HTTP/HTTPS Server块；若域名后缀统一，可使用通配符（如*.yourdomain.com）；或用server_name _;匹配所有未指定域名（需确保SSL证书支持多域名/通配符）。
• 通用HTTP转HTTPS示例：

  server {
      listen 80 default_server;
      server_name _;
      return 301 https://$host$request_uri;
      add_header Cache-Control "no-cache, no-store, must-revalidate"; # 避免缓存旧规则
  }
  

• 对应通用HTTPS代理示例（需根据域名映射不同后端端口）：

  server {
      listen 443 ssl default_server;
      server_name _;
      ssl_certificate /path/to/multi_domain_cert.crt;
      ssl_certificate_key /path/to/multi_domain_key.key;
  
      location / {
          proxy_pass http://127.0.0.1:对应后端端口;
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-Proto https;
      }
  }
  

3. 后端重定向规则冲突 #

若后端自身配置了强制HTTPS重定向，而Nginx通过HTTP与后端通信，会触发后端的重定向逻辑，导致循环。

修复：

• 关闭后端的强制HTTPS重定向，由Nginx统一处理HTTP转HTTPS。
• 若必须保留后端重定向，需修改后端逻辑，仅当X-Forwarded-Proto为HTTP时才触发重定向。

4. 浏览器缓存旧重定向规则 #

浏览器可能缓存了之前错误的301重定向，导致配置修改后仍循环。

修复：

• 使用浏览器无痕模式测试，或手动清除缓存。
• 在Nginx的301重定向中添加Cache-Control头，禁止长期缓存（如上述示例）。

内容的提问来源于stack exchange，提问作者fp007