IBM Cloud私有端点OpenShift集群反向代理505错误求助

核心原因 #

505 Bad Gateway错误的本质是反向代理（Nginx）与后端OpenShift控制台服务器之间的HTTP协议版本不兼容——Nginx默认转发请求时使用的HTTP版本可能不被OpenShift控制台支持。

具体排查与修复步骤 #

1. 强制指定HTTP协议版本 #

Nginx默认通过proxy_pass转发请求时用的是HTTP/1.0，而OpenShift控制台通常要求HTTP/1.1或更高版本。修改你的Nginx配置，添加协议版本及相关头信息：

server {
    listen 80;
    server_name subdomain.domain.com;
    location / {
        proxy_pass https://console.subdomain.domain.com/;
        # 强制使用HTTP/1.1协议
        proxy_http_version 1.1;
        # 转发请求Host头，避免后端服务器识别异常
        proxy_set_header Host $host;
        # 适配HTTP/1.1长连接特性，清空Connection头
        proxy_set_header Connection "";
    }
}

修改完成后重启Nginx：systemctl restart nginx，再重新测试curl请求。

2. 验证反向代理与OpenShift集群的网络连通性 #

由于集群部署在私有端点，必须确保：

• 反向代理服务器能正常解析console.subdomain.domain.com的私有IP：执行nslookup console.subdomain.domain.com或dig console.subdomain.domain.com，确认返回的是集群私有端点的正确IP。
• 反向代理服务器能访问OpenShift控制节点的443端口：在代理服务器上执行nc -zv console.subdomain.domain.com 443或telnet console.subdomain.domain.com 443，验证端口是否可达。
• 检查IBM Cloud的VPC路由规则，确保反向代理所在子网与OpenShift集群私有子网之间有有效的路由连通。

3. 直接测试后端服务的协议兼容性 #

在反向代理服务器上，用指定HTTP版本的curl命令直接请求后端控制台，验证服务本身是否正常：

curl -v --http1.1 https://console.subdomain.domain.com/

如果这个请求成功，说明问题确实出在Nginx的HTTP版本配置上；如果仍然失败，需要检查OpenShift控制台的运行状态，或查看IBM Cloud集群的日志信息，确认控制台服务是否正常。

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