Minikube Kubernetes集群内无法访问MediaMTX WebRTC流

问题描述 #

在Minikube Kubernetes集群部署MediaMTX服务器，通过ConfigMap传入自定义配置文件加载RTSP流输入，使用kubectl port-forward将服务转发到本地后，无法在浏览器通过http://localhost:8889/mycamera访问对应的WebRTC流。

问题复现步骤 #

• 创建Minikube集群
• 部署MediaMTX的Deployment、Service及包含自定义mediamtx.yml的ConfigMap
• 配置文件中已添加RTSP流路径条目
• 应用所有资源，待Pod启动后执行端口转发

相关配置文件 #

MediaMTX Deployment配置 #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: mediamtx
  labels:
    app: mediamtx
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mediamtx
  template:
    metadata:
      labels:
        app: mediamtx
    spec:
      containers:
      - name: mediamtx
        image: bluenviron/mediamtx
        args: ["/mediamtx.yml"] # 显式指定配置文件路径
        volumeMounts:
        - name: config
          mountPath: /mediamtx.yml
          subPath: mediamtx.yml
        ports:
        - containerPort: 8554
        - containerPort: 1935
        - containerPort: 8888
        - containerPort: 8889
        - containerPort: 8890
        - containerPort: 8189
        env:
        - name: MTX_PROTOCOLS
          value: "tcp"
        - name: MTX_WEBRTCADDITIONALHOSTS
          value: "172.19.0.1"
      volumes:
      - name: config
        configMap:
          name: mediamtx-config
          defaultMode: 0644  # 确保配置文件可读取

MediaMTX Service配置 #

apiVersion: v1
kind: Service
metadata:
  name: mediamtx
spec:
  type: ClusterIP
  ports:
  - name: rtsp
    port: 8554
    targetPort: 8554
    protocol: TCP
  - name: rtmp
    port: 1935
    targetPort: 1935
    protocol: TCP
  - name: web
    port: 8888
    targetPort: 8888
    protocol: TCP
  - name: web-rtc
    port: 8889
    targetPort: 8889
    protocol: TCP
  - name: rtsp-udp
    port: 8890
    targetPort: 8890
    protocol: UDP
  - name: udp-extra
    port: 8189
    targetPort: 8189
    protocol: UDP
  selector:
    app: mediamtx

MediaMTX ConfigMap配置 #

apiVersion: v1
kind: ConfigMap
metadata:
  name: mediamtx-config
data:
  mediamtx.yml: |
    # 自定义MediaMTX配置
    # webrtcICEServers2:
    # - url: stun:stun2.1.google.com:19302
    paths:
      # 示例流路径
      mycamera:
        source: rtsp://admin:admin@192.168.101.215:554/unicaststream/1
      all_others:

排查与修复方案 #

1. 修正WebRTC额外主机配置 #

当前Deployment中MTX_WEBRTCADDITIONALHOSTS设置为Minikube内部节点IP172.19.0.1，但通过kubectl port-forward访问时，客户端使用的是localhost，需修改该环境变量：

env:
- name: MTX_WEBRTCADDITIONALHOSTS
  value: "localhost"

2. 启用STUN服务器 #

WebRTC在NAT环境（如Minikube内部）需要STUN服务器协助建立P2P连接，取消ConfigMap中STUN配置的注释：

webrtcICEServers2:
- url: stun:stun2.1.google.com:19302

3. 确认端口转发命令正确性 #

确保同时转发WebRTC信令端口（8889）和Web界面端口（8888），执行正确的端口转发命令：

# 转发Service端口
kubectl port-forward service/mediamtx 8889:8889 8888:8888
# 或直接转发Pod端口
kubectl port-forward pod/$(kubectl get pods -l app=mediamtx -o name | cut -d'/' -f2) 8889:8889 8888:8888

4. 验证RTSP源可达性 #

进入MediaMTX Pod内部，测试是否能访问指定的RTSP源：

kubectl exec -it $(kubectl get pods -l app=mediamtx -o name | cut -d'/' -f2) -- \
  curl -I rtsp://admin:admin@192.168.101.215:554/unicaststream/1

如果无法访问，需确认Minikube集群能路由到该RTSP源（可尝试使用minikube tunnel或调整集群网络模式为bridge）。

5. 检查MediaMTX运行日志 #

查看Pod日志，确认RTSP源加载状态和WebRTC连接请求情况：

kubectl logs $(kubectl get pods -l app=mediamtx -o name | cut -d'/' -f2) -f

若日志中出现RTSP连接失败或WebRTC ICE协商错误，针对性排查对应的网络或配置问题。

6. 修正浏览器访问路径 #

MediaMTX的WebRTC播放页面并非直接访问8889/mycamera，而是通过8888端口的Web界面访问：

1. 打开浏览器访问http://localhost:8888
2. 在页面中选择mycamera流路径，切换到WebRTC协议进行播放

内容的提问来源于stack exchange，提问作者Sharan phadke