概要

フル名
docker.io/poorunga/websocket_echo
Registry
docker.io
名前空間
poorunga
リポジトリ
websocket_echo
キャッシュ Tag 数
2
最終同期
07/06/2026, 05:24 PM

概要

轻量 WebSocket Echo 演示服务镜像,连接后回显客户端消息,用于网关、负载均衡与 K8s Ingress WebSocket 连通性冒烟测试。

詳細

poorunga/websocket_echo 提供最小 WebSocket 服务端,客户端发送文本即原样返回,常用于验证 Nginx/Ingress proxy-read-timeout、sticky session 与 TLS 终结是否正确转发 Upgrade 头。与完整业务 WS 应用相比无状态、无鉴权,仅适合测试与演示。生产环境勿直接暴露公网;Kubernetes 中可作为 Deployment 配合 Ingress 做探活,测试完毕即下线。

快速启动

docker run -d --name ws-echo \
  -p 8080:8080 \
  docker.io/poorunga/websocket_echo:latest

推荐实践

docker run -d --name ws-echo \
  --restart unless-stopped \
  -p 8080:8080 \
  -e PORT=8080 \
  docker.io/poorunga/websocket_echo:1.0.0

核心参数说明

  • -p 8080:8080 — WebSocket HTTP 升级端口
  • -e PORT — 监听端口,默认 8080
  • --restart unless-stopped — 测试环境持续可用
  • 固定 tag — 协议行为 pin
  • 无状态 — 可随意扩副本做 LB 测试
  • 定位 — 连通性探针,非业务服务

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: websocket-echo
spec:
  replicas: 2
  selector:
    matchLabels:
      app: websocket-echo
  template:
    metadata:
      labels:
        app: websocket-echo
    spec:
      containers:
        - name: echo
          image: docker.io/poorunga/websocket_echo:1.0.0
          ports:
            - containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
  name: websocket-echo
spec:
  selector:
    app: websocket-echo
  ports:
    - port: 8080
      targetPort: 8080

Ingress 须启用 websocket 注解与足够超时;仅用于内网冒烟,勿承载生产流量。

Tagアーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/poorunga/websocket_echo
:latest
linux/amd64linux/arm64
2021/12/24 16:067.9 MBsha256:bfb670522ed1
docker.io/poorunga/websocket_echo
:0.1
linux/amd64linux/arm64
2021/12/24 16:067.9 MBsha256:bfb670522ed1