crmdesk/deploy/docker/readme/readme.webrtc.md

WebRTC 音视频客服 / WebRTC（coturn + janus）

组合关键字 webrtc = coturn + janus 两个组件，也可单独使用。

使用示例

# WebRTC 中间件
./start.sh webrtc middleware

# WebRTC 全栈（含 bytedesk 应用）
./start.sh webrtc all

# 呼叫中心 + WebRTC + 可观测性
./start.sh call webrtc all obs

# 单独启动 coturn
./start.sh middleware coturn

# 停止（关键字保持一致）
./stop.sh webrtc down

组件说明

关键字	compose 文件（位于 compose/）	服务名	镜像	默认端口
coturn	compose/compose-coturn.yaml	bytedesk-coturn	coturn/coturn:4.6.3	13478(STUN/TURN)、15349(TLS)、49160-49200(UDP 中继)
janus	compose/compose-janus.yaml	bytedesk-janus	bytedesk/janus	18089(HTTP API)、18188(WebSocket)、17188(Admin)

TURN 凭据

.env 中配置（应用侧与 janus 共用）：

COTURN_REALM=bytedesk.local
COTURN_USER=bytedesk
COTURN_PASS=bytedesk123
JANUS_ADMIN_SECRET=janusoverlord

健康检查

# janus（HTTP API 需 POST 到 /janus，直接 GET 返回 404 属正常）
curl -sS -X POST -H 'Content-Type: application/json' \
  --data '{"janus":"ping","transaction":"check"}' \
  http://localhost:18089/janus

# coturn
docker exec coturn-bytedesk turnutils_stunclient -p 3478 127.0.0.1

说明

• janus 不再声明对 coturn 的 depends_on（一镜像一文件后避免跨文件依赖），均已配置健康检查与 restart: always 自愈
• 应用侧 WebRTC 配置（BYTEDESK_WEBRTC_JANUS_*）默认指向 bytedesk-janus / bytedesk-coturn 服务名，无需额外配置
• janus 配置挂载自 deploy/janus/etc/janus