mirror of
https://github.com/imputnet/cobalt.git
synced 2025-06-28 17:38:31 +00:00
147 lines
3.6 KiB
Markdown
147 lines
3.6 KiB
Markdown
# WebSocket 连接故障排除指南
|
||
|
||
## 问题描述
|
||
WebSocket 连接失败: `WebSocket connection to 'wss://freesavevideo.online/ws' failed:`
|
||
|
||
## 解决方案
|
||
|
||
### 1. GCP/GKE WebSocket 支持要求
|
||
|
||
GCP 的 Google Kubernetes Engine (GKE) 支持 WebSocket，但需要特定配置：
|
||
|
||
#### HTTP(S) 负载均衡器
|
||
- GKE Ingress 默认支持 WebSocket 连接升级
|
||
- 确保使用 HTTPS (wss://) 而不是 HTTP (ws://)
|
||
|
||
#### 防火墙规则
|
||
GCP 不需要特殊的端口配置，因为 WebSocket 使用标准的 HTTP/HTTPS 端口：
|
||
- HTTP: 80
|
||
- HTTPS: 443
|
||
|
||
### 2. 已实施的修复
|
||
|
||
#### 客户端修复
|
||
- ✅ 修复了 WebSocket URL，现在连接到正确的 API 域名
|
||
- ✅ 生产环境使用 `wss://api.freesavevideo.online/ws`
|
||
|
||
#### 服务器配置
|
||
- ✅ 添加了详细的连接日志
|
||
- ✅ 添加了健康检查端点 `/health` 和 `/ws/health`
|
||
- ✅ WebSocket 服务器监听路径 `/ws`
|
||
|
||
#### Kubernetes 配置
|
||
- ✅ Ingress 配置支持 WebSocket 协议升级
|
||
- ✅ 添加了 GKE 特定的注解
|
||
|
||
### 3. 部署步骤
|
||
|
||
1. **构建并推送新的 Docker 镜像**:
|
||
```bash
|
||
# 在项目根目录
|
||
docker build -t gcr.io/你的项目ID/cobalt:latest .
|
||
docker push gcr.io/你的项目ID/cobalt:latest
|
||
```
|
||
|
||
2. **更新 Helm Chart**:
|
||
```bash
|
||
# 更新 values.yaml 中的镜像标签
|
||
helm upgrade cobalt-api ./cobalt-chart --namespace default
|
||
```
|
||
|
||
3. **验证部署**:
|
||
```bash
|
||
# 检查 Pod 状态
|
||
kubectl get pods -l app.kubernetes.io/name=cobalt-chart
|
||
|
||
# 检查服务状态
|
||
kubectl get svc
|
||
|
||
# 检查 Ingress 状态
|
||
kubectl get ingress
|
||
|
||
# 查看 Pod 日志
|
||
kubectl logs -l app.kubernetes.io/name=cobalt-chart -f
|
||
```
|
||
|
||
### 4. 测试连接
|
||
|
||
#### 健康检查
|
||
```bash
|
||
# 测试 API 健康状态
|
||
curl https://api.freesavevideo.online/health
|
||
|
||
# 测试 WebSocket 健康状态
|
||
curl https://api.freesavevideo.online/ws/health
|
||
```
|
||
|
||
#### WebSocket 连接测试
|
||
使用浏览器开发者工具测试：
|
||
```javascript
|
||
// 在浏览器控制台中测试
|
||
const ws = new WebSocket('wss://api.freesavevideo.online/ws');
|
||
ws.onopen = () => console.log('WebSocket 连接成功');
|
||
ws.onerror = (error) => console.error('WebSocket 错误:', error);
|
||
ws.onclose = () => console.log('WebSocket 连接关闭');
|
||
```
|
||
|
||
### 5. 常见问题
|
||
|
||
#### 5.1 SSL/TLS 证书问题
|
||
如果遇到证书问题：
|
||
```bash
|
||
# 检查证书状态
|
||
kubectl describe managedcertificate apifreesavevideo-tls
|
||
```
|
||
|
||
#### 5.2 负载均衡器配置问题
|
||
```bash
|
||
# 检查负载均衡器状态
|
||
kubectl describe ingress
|
||
|
||
# 查看负载均衡器事件
|
||
kubectl get events --sort-by=.metadata.creationTimestamp
|
||
```
|
||
|
||
#### 5.3 网络连接问题
|
||
```bash
|
||
# 从 Pod 内部测试网络
|
||
kubectl exec -it <pod-name> -- curl localhost:80/health
|
||
|
||
# 测试 WebSocket 端点
|
||
kubectl exec -it <pod-name> -- curl -i -N \
|
||
-H "Connection: Upgrade" \
|
||
-H "Upgrade: websocket" \
|
||
-H "Sec-WebSocket-Key: x3JJHMbDL1EzLkh9GBhXDw==" \
|
||
-H "Sec-WebSocket-Version: 13" \
|
||
http://localhost:80/ws
|
||
```
|
||
|
||
### 6. 监控和日志
|
||
|
||
#### 查看实时日志
|
||
```bash
|
||
# 查看所有 Pod 的日志
|
||
kubectl logs -l app.kubernetes.io/name=cobalt-chart -f --all-containers=true
|
||
|
||
# 过滤 WebSocket 相关日志
|
||
kubectl logs -l app.kubernetes.io/name=cobalt-chart -f | grep -i websocket
|
||
```
|
||
|
||
#### 检查连接统计
|
||
在应用日志中查找：
|
||
- "WebSocket连接建立"
|
||
- "WebSocket信令服务器启动成功"
|
||
- 连接的客户端 IP 地址
|
||
|
||
### 7. GCP 特定配置
|
||
|
||
GCP 不需要特殊的防火墙端口配置，因为：
|
||
- WebSocket 使用标准 HTTP/HTTPS 端口 (80/443)
|
||
- GKE Ingress 自动处理协议升级
|
||
- 负载均衡器支持长连接和 WebSocket
|
||
|
||
如果仍有问题，检查：
|
||
1. VPC 防火墙规则是否阻止了连接
|
||
2. GKE 集群的网络策略
|
||
3. Pod 的安全上下文设置
|