sippylabs/webrtc_phone

Sippy WebRTC Phone

镜像概述和主要用途

这是一个集成Sippy RTPProxy和Sippy B2BUA与WebRTC兼容客户端的技术演示。它包含四个主要组件：

1. Sippy B2BUA
2. Sippy RTPProxy
3. SIP.js演示应用
4. Web服务器

核心功能和特性

容器启动RTPProxy和B2BUA，监听WSS端口9876/TCP，同时启动Web服务器监听HTTPS端口443/TCP。两者共享容器构建过程中生成的自签名TLS密钥，允许用户打开演示页面并通过WSS将浏览器连接到B2BUA。

HTTPS服务器的唯一作用是允许用户下载HTML/JS文件，在实际实时会话中无其他作用，因此该组件可独立部署。

通过WSS套接字发起的任何注册尝试都会通过SIP/UDP代理到由OUTBOUND_PROXY环境变量控制的外部SIP注册器。

当用户发起呼叫时，B2BUA/RTPProxy会建立两个RTP会话（一个加密，一个明文），并向由OUTBOUND_ROUTE环境变量控制的SIP目的地发起出站SIP呼叫。有关此参数格式，请参见Sippy B2BUA文档的https://github.com/sippy/b2bua/blob/master/documentation/documentation.md#call-routing%E9%83%A8%E5%88%86%E3%80%82

若未提供OUTBOUND_ROUTE，则会使用OUTBOUND_PROXY作为唯一尝试的路由。

使用场景和适用范围

适用于WebRTC与SIP协议互通的技术演示场景，供开发者测试和评估WebRTC客户端与SIP网络的连接能力，验证呼叫建立、媒体传输等功能。

使用方法和配置说明

Docker部署示例

拉取镜像

bash
docker pull sippylabs/webrtc_phone:latest

运行容器

bash
docker run -it --name webrtc_phone -P --network=host \
  -e OUTBOUND_PROXY="sip.mypbx.net" \
  -d sippylabs/webrtc_phone:latest

配置参数说明

• 环境变量：
  • OUTBOUND_PROXY：外部SIP注册器地址，用于代理注册尝试和作为默认呼叫路由（当未设置OUTBOUND_ROUTE时）
  • OUTBOUND_ROUTE：呼叫目的地路由，格式参见Sippy B2BUA的呼叫路由文档
  • RTPP_LOG_LEVEL：控制RTP日志级别，可选值：DBUG、INFO、WARN、ERR、CRIT（详细程度递减）
  • RTPP_NODEBUG：性能关键场景下设置为1以禁用调试信息
  • MIN_RTP_PORT：RTPProxy分配的UDP端口范围起始值
  • MAX_RTP_PORT：RTPProxy分配的UDP端口范围结束值（每个会话分配4个端口，范围至少为预期最大并发会话数×4）

日志与监控

容器会生成各种SIP/RTP/WSS日志，可通过docker logs命令查看。RTP日志量可通过RTPP_LOG_LEVEL环境变量控制，可选值按详细程度从高到低为：DBUG、INFO、WARN、ERR、CRIT。

性能优化

在当前配置下，单个容器最多可支持500个并发用户，充分利用5-6个核心。若用于性能关键场景，建议运行容器时设置RTPP_NODEBUG=1。

RTPProxy分配的UDP端口范围可通过MIN_RTP_PORT和MAX_RTP_PORT参数控制。每个会话分配4个端口，因此端口范围至少应为预期最大并发会话数的4倍。

注意事项与限制

• 在Firefox中连接WSS服务器会失败并显示错误1015。在Chrome和Microsoft Edge中，用户打开演示页面时接受安全警告后可正常工作，这是由于使用自签名证书导致的。
• 仅“Demo 1”和“Demo 2”可用。
• 由于RTP会话需要一定范围的UDP端口（默认2000个），建议使用host网络模式。

链接与参考资料

• https://github.com/sippy/rtpproxy/
• https://github.com/sippy/b2bua/
• https://github.com/onsip/SIP.js/
• https://github.com/sippy/webrtc_phone/