Hashicorp Boundary 认证后SSH连接报WebSocket拨号失败排查
边界网关连接异常排查指南
异常现象
- 密码认证流程正常,可成功获取有效会话Token
- 执行
boundary connect ssh -target-id ttcp_bNARIi1qIZ命令时触发两类连锁报错: - WebSocket握手失败:尝试连接
https://boundary.dev.mydomain.cloud:9202/v1/proxy时,解析得到的后端IP 10.0.16.28:9202出现TCP连接操作超时 - SSH密钥交换失败:提示
kex_exchange_identification: read: Connection reset by peer - 部署环境:启用Istio服务网格的Kubernetes集群,Controller与Worker以边车容器形式部署在同一个Pod内
排查校验清单
1. Worker代理端口暴露链路
- 核对Kubernetes Service的端口映射规则:Istio服务网格默认仅转发已在Service中显式声明的端口流量,需确认Worker的9202代理端口已纳入对应Service的端口定义,且Service的标签选择器能正确匹配Pod标签
- 检查公网入口路由规则:确认Istio Gateway/Ingress已开放9202端口的入站转发规则,允许外部流量直达Worker的代理监听端口
- 修正Worker公开地址配置:当前
worker.hcl中public_addr = "boundary.dev.mydomain.cloud"未携带对外暴露的端口号,若实际入口端口不是默认的9202,必须在该配置中明确补全端口信息,避免Controller向客户端下发错误的连接地址
2. TLS配置一致性校验
这里极易出现配置错位:很多部署在K8s上的用户习惯在Ingress/Gateway层做统一TLS终止,但Boundary客户端获取Worker地址后是直连Worker代理端口完成数据传输的,不经过统一API入口的转发逻辑。
- 当前配置中Worker的proxy监听器为
tls_disable = true(即9202端口运行明文HTTP服务),但报错中客户端以HTTPS协议发起连接,协议不匹配会直接触发握手超时、连接重置的连锁异常 - 需双向对齐配置:要么在Worker端为proxy监听器开启对应TLS证书配置,要么将Controller下发给客户端的Worker连接协议调整为HTTP,杜绝HTTPS客户端连接明文HTTP服务的错位场景
3. Worker注册状态校验
- 查看Worker容器启动日志:确认Worker可通过集群内地址
boundary.boundary.svc.cluster.local:9201正常连通Controller,且已成功将代理端口、对外地址信息注册到Controller的路由列表中 - 检查同Pod端口冲突:Controller的API端口默认9200、集群通信端口默认9201,Worker代理端口默认9202,需确认同Pod内不存在端口绑定冲突,导致Worker的proxy监听器未正常启动
4. Istio环境规则排查
- 检查Pod的Sidecar配置:确认istio-proxy未对9202端口的入站流量做拦截限制
- 检查集群网络策略:确认NetworkPolicy配置未拦截外部对Worker 9202端口的访问请求
内容的提问来源于stack exchange,提问作者Phil Chae
相关产品推荐
相关产品推荐

