容器中Nginx proxy_pass代理外部站点时出现308循环重定向问题

问题根源分析 #

你遇到的308循环重定向，核心原因是代理时传递的Host头不符合目标服务的预期：

• 你的/echo location配置中设置了proxy_set_header HOST $host;，会将请求的Host（mydomain）传给目标服务echo.free.beeceptor.com。
• 目标服务收到陌生Host后，会返回308重定向到自身域名；浏览器跳转后，Nginx又会再次代理并传递mydomain作为Host，形成循环。

此外，目标服务返回的重定向路径若未被Nginx修正，也会加剧路径不匹配的重定向问题。

具体修复方案 #

方案1：修正Host头传递 #

将/echo location中的Host头改为目标服务的域名，让目标服务识别合法请求：

location /echo {
  proxy_set_header Host echo.free.beeceptor.com; # 替换为目标服务原生域名
  proxy_set_header Referer $http_referer;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_pass http://echo.free.beeceptor.com;
}

方案2：添加重定向路径修正（可选） #

如果目标服务返回的重定向路径是自身根路径（比如/），可通过proxy_redirect指令将其替换为你的/echo路径，避免浏览器跳转到错误地址：

location /echo {
  proxy_set_header Host echo.free.beeceptor.com;
  proxy_set_header Referer $http_referer;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_pass http://echo.free.beeceptor.com;
  proxy_redirect http://echo.free.beeceptor.com/ /echo/; # 修正重定向路径映射
}

方案3：确认proxy_pass路径格式（可选） #

当前proxy_pass结尾无斜杠的配置是正确的，它会将/echo后的路径完整映射到目标服务。如果误加了斜杠，Nginx会把/echo替换为空，可能导致路径匹配异常，需避免这种写法。

验证步骤 #

修改配置后执行nginx -s reload重载配置，访问mydomain/echo查看是否正常返回目标服务的响应信息。若仍有问题，可查看Nginx访问日志（通常在/var/log/nginx/access.log）和错误日志，确认重定向的具体来源与跳转路径，进一步排查。

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