WebSocket 与容器化：Docker/Kubernetes 部署与运维指南

一、核心挑战与解决方案

1. 长连接处理
   WebSocket 的持久连接特性需特殊处理：

   • 会话保持：通过 sessionAffinity: ClientIP 实现粘性会话
   • 健康检查：配置 livenessProbe 检测 TCP 端口（例：port: 8080）

2. 水平扩展瓶颈
   解决状态共享问题：

   # Kubernetes StatefulSet 配置片段
   spec:
     serviceName: "ws-service"
     replicas: 3
     template:
       metadata:
         labels:
           app: websocket-server
   

二、Docker 部署实践

Dockerfile 示例：

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 8080
CMD ["node", "server.js"]  # WebSocket 服务入口

关键运维命令：

# 构建镜像
docker build -t ws-app:v1 .

# 运行容器（端口映射）
docker run -d -p 8080:8080 --name ws-container ws-app:v1

# 连接测试
docker exec -it ws-container wscat -c ws://localhost:8080

三、Kubernetes 部署架构

graph LR
A[Client] --> B[Ingress Nginx]
B --> C[Service LoadBalancer]
C --> D[Pod 1]
C --> E[Pod 2]
C --> F[Pod 3]

部署清单要点：

1. Service 配置：

   apiVersion: v1
   kind: Service
   metadata:
     name: ws-service
   spec:
     ports:
     - port: 80
       targetPort: 8080
     selector:
       app: websocket-server
     type: LoadBalancer
     sessionAffinity: ClientIP
   

2. Ingress 配置：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"
   spec:
     rules:
     - http:
         paths:
         - path: /ws
           pathType: Prefix
           backend:
             service:
               name: ws-service
               port:
                 number: 80
   

四、关键运维策略

1. 自动伸缩：

   # HPA 配置（基于连接数）
   kubectl autoscale deployment ws-deploy --min=3 --max=10 --cpu-percent=70
   

2. 日志收集：

   # 查看实时日志
   kubectl logs -f deployment/ws-deploy --tail 100
   

3. 零停机更新：

   strategy:
     rollingUpdate:
       maxSurge: 25%
       maxUnavailable: 0
   

五、监控指标设计

指标类型	监控工具	告警阈值
活跃连接数	Prometheus	> 5000/节点
消息吞吐量	Grafana	< 100msg/s
握手失败率	Elastic Stack	> 1%

优化公式：
连接容量规划需满足：
$$N_{\text{max}} = \frac{C_{\text{mem}} \times R_{\text{conn}}}{M_{\text{avg}}}$$
其中：

• $C_{\text{mem}}$ = 单节点可用内存
• $R_{\text{conn}}$ = 连接内存占比（建议 ≤60%）
• $M_{\text{avg}}$ = 单连接内存消耗

六、故障排查清单

1. 连接闪断：

   • 检查 Pod 重启次数：kubectl get pods -o wide
   • 验证网络策略：kubectl describe networkpolicy

2. 消息延迟：

   # 抓取节点网络流量
   kubectl debug node/<node-name> -it --image=nicolaka/netshoot
   tcpdump -i eth0 port 8080 -w ws.pcap
   

最佳实践：在 Kubernetes 1.20+ 中使用 TopologyAwareHints 优化流量路由，减少跨区通信延迟。