Docker集成PJSIP：呼叫与请求超时问题问询

问题背景 #

基于PJSIP开发的VoIP应用在本地运行完全正常，但用Docker（基础镜像python:3.9.16-slim-buster）打包后，虽然应用能正常启动，但所有呼叫、SIP请求均出现超时。

问题根源 #

Docker默认的bridge网络模式下，容器拥有独立网络栈，而SIP（尤其是UDP传输的SIP）对网络配置要求较高，超时问题通常来自以下几点：

• 动态协商的媒体端口未做映射，导致流量无法进出容器
• PJSIP默认绑定到容器内部的127.0.0.1，外部无法访问
• 端口映射不完整，漏掉了信令或媒体端口

解决步骤 #

1. 快速测试：使用host网络模式（适合开发/测试场景） #

直接让容器共享宿主机的网络栈，跳过端口映射问题：

docker run --network=host 你的镜像名称

注意：此模式下容器与宿主机共用端口，需避免端口冲突。

2. bridge模式下的正确配置（生产环境推荐） #

如果必须使用默认的bridge模式，需完成以下两步配置：

（1）映射完整端口

启动容器时，映射SIP信令端口（默认5060，UDP/TCP）和固定范围的媒体端口（建议10000-20000）：

docker run -p 5060:5060/udp -p 5060:5060/tcp -p 10000-20000:10000-20000/udp 你的镜像名称

（2）修改PJSIP代码配置

• 绑定到0.0.0.0允许外部访问
• 指定媒体端口范围与Docker映射一致

import pjsua2 as pj

# 初始化Endpoint
ep = pj.Endpoint()
ep.libCreate()
ep_cfg = pj.EpConfig()

# 配置SIP传输绑定地址
tp_cfg = pj.TransportConfig()
tp_cfg.port = 5060
tp_cfg.bindAddress = "0.0.0.0"  # 关键：绑定到所有可访问地址
ep.transportCreate(pj.PJSIP_TRANSPORT_UDP, tp_cfg)

# 指定媒体端口范围，与Docker映射的范围匹配
ep_cfg.medConfig.portRangeStart = 10000
ep_cfg.medConfig.portRangeEnd = 20000

ep.libInit(ep_cfg)

3. 检查宿主机防火墙规则 #

确保宿主机防火墙允许相关端口的流量通过：

# 放行SIP信令端口
iptables -A INPUT -p udp --dport 5060 -j ACCEPT
iptables -A INPUT -p tcp --dport 5060 -j ACCEPT
# 放行媒体端口范围
iptables -A INPUT -p udp --dport 10000:20000 -j ACCEPT

4. Dockerfile优化（可选） #

你的Dockerfile已完成PJSIP编译，可添加以下配置减小镜像体积并确保库路径正确：

# 在python-pjsip阶段末尾添加
RUN apt-get purge -y build-essential make gcc g++ swig && \
    apt-get autoremove -y && \
    rm -rf /var/lib/apt/lists/* /root/pjproject-$VERSION_PJSIP

# 确保PJSIP库能被系统找到
ENV LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

验证方法 #

1. 进入容器执行netstat -tulpn，确认PJSIP绑定的是0.0.0.0:5060而非127.0.0.1
2. 在宿主机执行nc -u localhost 5060发送测试数据，检查容器是否能接收
3. 使用SIP客户端（如Linphone）向宿主机IP发起呼叫，验证连接是否正常

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