l7mp/stunnerd

WebRTC媒体网关（Kubernetes版）镜像文档

镜像概述

本镜像是专为Kubernetes环境设计的WebRTC媒体处理组件，作为媒体网关实现WebRTC媒体流的传输、转发和处理功能。其核心价值在于为Kubernetes集群中的实时音视频应用提供原生集成的媒体层支持，简化WebRTC协议在云原生环境下的部署与运维，保障低延迟、高可靠的实时媒体通信。

核心功能与特性

核心功能

• WebRTC协议支持：完整兼容WebRTC标准协议（包括ICE、STUN、TURN、SDP等），支持浏览器与服务器、服务器与服务器间的WebRTC媒体流交互。
• 媒体流转发：实现WebRTC媒体流的高效转发，支持点到点（P2P）及多点（MCU/SFU模式）媒体流分发。
• Kubernetes原生集成：适配Kubernetes容器化部署模式，支持通过Deployment、StatefulSet等资源实现容器化运行，与Kubernetes服务发现、配置管理（ConfigMap/Secret）无缝集成。

关键特性

• 云原生设计：支持Kubernetes环境下的容器化部署、自动扩缩容及服务发现。
• 低延迟传输：优化媒体流路径，减少转发延迟，满足实时音视频通信需求（通常<100ms）。
• 高可扩展性：支持水平扩展，可通过增加副本数应对媒体流并发量增长。
• 媒体处理能力：可选支持媒体流编解码、格式转换、混音/混流等媒体处理功能（具体取决于镜像版本）。
• 监控与可观测性：提供Prometheus指标暴露，支持集成Kubernetes监控体系（如Grafana）。

使用场景与适用范围

典型使用场景

• 实时音视频通信应用：视频会议、在线教育、远程***等需要低延迟互动的场景。
• 直播与互动直播：支持主播与观众间的实时音视频互动，或多主播联合直播。
• IoT设备视频流：物联网设备（如摄像头、无人机）的实时视频流采集与传输。
• 实时协作工具：集成到协作平台中，提供屏幕共享、实时标注等媒体交互能力。

适用范围

• 基于Kubernetes构建的云原生应用环境。
• 需要WebRTC协议支持的实时音视频通信系统。
• 对媒体流传输低延迟、高可用性有要求的业务场景。
• 需弹性扩展以应对流量波动的音视频服务。

使用方法与配置说明

前提条件

• Kubernetes集群（版本1.18+）。
• 集群内已部署网络插件（如Calico、Flannel），支持Pod间网络通信。
• 如需对外暴露服务，需配置Ingress或NodePort服务。

Kubernetes部署示例

1. Deployment配置

创建webrtc-media-gateway-deployment.yaml：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: webrtc-media-gateway
  namespace: media-system
spec:
  replicas: 3  # 根据并发需求调整副本数
  selector:
    matchLabels:
      app: webrtc-media-gateway
  template:
    metadata:
      labels:
        app: webrtc-media-gateway
    spec:
      containers:
      - name: webrtc-media-gateway
        image: [镜像名称]:[标签]  # 替换为实际镜像地址
        ports:
        - containerPort: 8080  # WebRTC信令端口
        - containerPort: 1935  # 媒体流传输端口（如适用）
        env:
        - name: RTC_PORT
          value: "8080"  # WebRTC服务端口
        - name: LOG_LEVEL
          value: "info"  # 日志级别：debug/info/warn/error
        - name: KUBE_SERVICE_NAME
          value: "webrtc-media-gateway"  # Kubernetes服务名称
        resources:
          requests:
            cpu: "1"
            memory: "1Gi"
          limits:
            cpu: "2"
            memory: "2Gi"

2. Service配置

创建webrtc-media-gateway-service.yaml：

yaml
apiVersion: v1
kind: Service
metadata:
  name: webrtc-media-gateway
  namespace: media-system
spec:
  selector:
    app: webrtc-media-gateway
  ports:
  - port: 8080
    targetPort: 8080
    name: rtc-signaling
  - port: 1935
    targetPort: 1935
    name: media-stream
  type: ClusterIP  # 如需外部访问，可改为NodePort或LoadBalancer

3. 部署命令

bash
kubectl apply -f webrtc-media-gateway-deployment.yaml
kubectl apply -f webrtc-media-gateway-service.yaml

关键配置参数说明

验证部署

部署完成后，可通过以下命令检查Pod状态：

bash
kubectl get pods -n media-system -l app=webrtc-media-gateway

查看日志：

bash
kubectl logs -n media-system [pod名称] -f

通过集群内其他服务访问媒体网关：

http://webrtc-media-gateway.media-system.svc.cluster.local:8080

扩展与维护

水平扩展

通过调整Deployment副本数实现水平扩展：

bash
kubectl scale deployment webrtc-media-gateway --replicas=5 -n media-system

升级镜像

bash
kubectl set image deployment/webrtc-media-gateway webrtc-media-gateway=[新镜像名称]:[新标签] -n media-system

注意事项

• 媒体流传输对网络带宽和延迟敏感，建议在Kubernetes节点间配置低延迟网络。
• 生产环境中建议配置资源限制（limits）以避免资源争抢。
• 如需跨集群媒体流传输，需额外配置跨集群网络方案（如***、专线）。