排查ws部署故障

api/src/core/api.js

@@ -310,13 +310,23 @@ export const runAPI = async (express, app, __dirname, isPrimary = true) => {
             streamInfo.range = req.headers['range'];
         }
 
-        return stream(res, streamInfo);    });
-
-    app.get('/', (_, res) => {
+        return stream(res, streamInfo);    });    app.get('/', (_, res) => {
         res.type('json');
         res.status(200).send(env.envFile ? getServerInfo() : serverInfo);
     })
 
+    app.get('/health', (_, res) => {
+        res.status(200).json({ status: 'healthy', timestamp: new Date().toISOString() });
+    })
+
+    app.get('/ws/health', (_, res) => {
+        res.status(200).json({ 
+            status: 'websocket_ready', 
+            timestamp: new Date().toISOString(),
+            path: '/ws'
+        });
+    })
+
     app.get('/favicon.ico', (req, res) => {
         res.status(404).end();
     })

api/src/core/signaling.js

@@ -9,6 +9,8 @@ export const setupSignalingServer = (httpServer) => {
 
     const sessions = new Map(); // sessionId -> { creator, joiner, createdAt }
 
+    console.log(`${Green('[✓]')} WebSocket信令服务器启动成功，监听路径: /ws`);
+
     // 清理过期会话
     setInterval(() => {
         const now = Date.now();
@@ -21,7 +23,8 @@ export const setupSignalingServer = (httpServer) => {
     }, 5 * 60 * 1000); // 每5分钟检查一次
 
     wss.on('connection', (ws, req) => {
-        console.log('WebSocket连接建立:', req.socket.remoteAddress);
+        const clientIP = req.headers['x-forwarded-for'] || req.headers['x-real-ip'] || req.socket.remoteAddress;
+        console.log('WebSocket连接建立:', clientIP, 'URL:', req.url);
         
         let sessionId = null;
         let userRole = null; // 'creator' | 'joiner'

cobalt-chart/values.yaml

@@ -41,9 +41,11 @@ service:
 ingress:
   enabled: true
   className: ""
-  annotations: {networking.gke.io/managed-certificates: "apifreesavevideo-tls"}
-    # kubernetes.io/ingress.class: nginx
-    # kubernetes.io/tls-acme: "true"
+  annotations: 
+    networking.gke.io/managed-certificates: "apifreesavevideo-tls"
+    # GKE WebSocket 支持
+    cloud.google.com/neg: '{"ingress": true}'
+    kubernetes.io/ingress.allow-http: "false"
   hosts:
     - host: api.freesavevideo.online
       paths:

docs/websocket-troubleshooting.md

@@ -0,0 +1,146 @@
+# 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 的安全上下文设置

web/src/lib/clipboard/clipboard-manager.ts

@@ -120,17 +120,19 @@ export class ClipboardManager {
                 }));
             }
         }, checkInterval);
-    }
-
-    // WebSocket management
+    }    // WebSocket management
     private getWebSocketURL(): string {
         if (typeof window === 'undefined') return 'ws://localhost:9000/ws';
         
         const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
         let host = window.location.host;
         
-        // For mobile access, use the actual IP instead of localhost
-        if (host.includes('localhost') || host.includes('127.0.0.1')) {
+        // 生产环境使用API域名进行WebSocket连接
+        if (window.location.hostname === 'freesavevideo.online') {
+            host = 'api.freesavevideo.online';
+        }
+        // 开发环境处理
+        else if (host.includes('localhost') || host.includes('127.0.0.1')) {
             host = '192.168.1.12:5173';
         }