GB28181-2016 协议视频流接入深度实战：Kamailio + ZLM + WVP

1. 业务背景与挑战

在大型安防项目中，核心业务平台（WVP）通常部署在企业内网的安全区域。而摄像头分布在公网各处，无法直接访问内网。为了实现接入，我们采用了**“内网业务 + 代理机边缘”**的架构。

核心挑战

1. NAT 穿越: 摄像头通常在私网内，需要 SIP 代理（Kamailio）识别其实际公网 IP 和端口。
2. 安全隔离: WVP 不暴露在公网，通过 Kamailio 进行信令中转。
3. 网络抖动: 公网环境下 UDP 丢包严重，需强制使用 RTP Over TCP 模式。
4. 端口映射: 代理机需开启 5060 (UDP) 及大量的媒体端口（TCP）。

---

2. 详细架构方案

2.1 网络拓扑图

graph LR
    subgraph "外部环境 (Public Network)"
        IPC[摄像头/NVR]
    end

    subgraph "代理机 (Proxy Machine - DMZ)"
        KAM[Kamailio: SIP Proxy]
        ZLM[ZLMediaKit: Media Server]
    end

    subgraph "应用机 (Internal Machine)"
        WVP[WVP-PRO: Business Logic]
        DB[(MySQL/Redis)]
    end

    IPC -- "SIP/UDP:5060" --> KAM
    IPC -- "RTP/TCP:30000-30500" --> ZLM
    KAM -- "SIP/UDP:5060" --> WVP
    WVP -- "API/HTTP" --> ZLM
    WVP -- "Data" --> DB

2.2 协议约定

• 信令: 全程使用 UDP，由 Kamailio 处理 rport 修复。
• 媒体: 强制 TCP 被动模式（摄像头作为 TCP 客户端，主动连接 ZLM 的监听端口）。

---

3. 核心信令流程图

3.1 注册与目录查询

这是设备接入的第一步，涉及鉴权与资源同步。

sequenceDiagram
    participant IPC as 摄像头
    participant KAM as Kamailio (代理)
    participant WVP as WVP (核心)

    IPC->>KAM: REGISTER (无鉴权)
    Note over KAM: 识别 source IP:port
    KAM->>WVP: REGISTER (转发)
    WVP-->>KAM: 401 Unauthorized (带 nonce)
    KAM-->>IPC: 401 Unauthorized
    
    IPC->>KAM: REGISTER (带 Response)
    KAM->>WVP: REGISTER (转发)
    WVP-->>KAM: 200 OK
    KAM-->>IPC: 200 OK
    
    Note over WVP: 注册成功，发起目录查询
    WVP->>KAM: MESSAGE (Catalog Query)
    KAM->>IPC: MESSAGE (Catalog Query)
    IPC-->>KAM: 200 OK
    IPC->>KAM: MESSAGE (DeviceList)
    KAM->>WVP: MESSAGE (DeviceList)
    WVP-->>KAM: 200 OK

3.2 TCP 点播流程 (INVITE)

这是获取视频流的关键步骤，重点在于 SDP 协商中的 TCP 标识。

sequenceDiagram
    participant User as 用户/前端
    participant WVP as WVP (核心)
    participant ZLM as ZLM (媒体)
    participant KAM as Kamailio (代理)
    participant IPC as 摄像头

    User->>WVP: 点击预览
    WVP->>ZLM: 请求分配端口 (TCP 模式)
    ZLM-->>WVP: 返回 30004 端口
    WVP->>KAM: INVITE (SDP: TCP/RTP/AVP, Port: 30004)
    KAM->>IPC: INVITE (转发)
    IPC-->>KAM: 200 OK (SDP)
    KAM->>WVP: 200 OK (转发)
    WVP->>KAM: ACK
    KAM->>IPC: ACK
    
    Note over IPC: 摄像头作为 TCP Client
    IPC->>ZLM: 建立 TCP 连接 (Port: 30004)
    IPC->>ZLM: 推送 RTP 媒体包
    ZLM->>WVP: 触发 Hook (流已产生)
    WVP-->>User: 播放地址 (HTTP-FLV/WebRTC)

---

4. 核心组件深度配置

4.1 WVP 主要业务逻辑说明

WVP 不仅仅是一个 SIP 栈，它承担了复杂的业务编排：

• 流状态管理: 通过 Redis 维护流的生存周期，超时未收到 ZLM 的 Hook 则自动释放端口。
• TCP/UDP 转换: WVP 必须在发送 INVITE 时，在 SDP 的 m 字段设置为 TCP/RTP/AVP 或 TCP/RTP/SAVP。
• 级联管理: 支持作为下级平台向上级（如海康、大华平台）进行级联。

4.2 Kamailio 详细配置 (kamailio.cfg)

Kamailio 的核心任务是“欺骗”双方，让它们认为自己在直连。

/* 核心：宣告公网 IP，否则 SDP 中的 IP 会是内网 IP */
listen=udp:172.16.0.10:5060 advertise 1.2.3.4:5060

/* 处理注册逻辑 */
route[REGISTRAR] {
    if (!is_method("REGISTER")) return;

    # 1. 记录客户端的真实公网 IP/Port
    force_rport(); 
    
    # 2. 如果来自内网 WVP，则转发给外网摄像头
    if (src_ip == "172.16.0.20") {
        $du = $ru; # 路由到 Contact 中的地址
    } else {
        # 3. 如果来自外网摄像头，转发给内网 WVP
        $du = "sip:172.16.0.20:5060";
    }
    t_relay();
}

/* 修复 Contact 头 */
onreply_route {
    if (is_method("INVITE") && status=="200") {
        fix_nated_contact();
    }
}

4.3 ZLMediaKit (ZLM) 配置 (config.ini)

ZLM 需要配置为被动模式接收 TCP 流。

[rtp]
# 端口映射必须覆盖此范围
port_range=30000-30500
# 开启 RTP Over TCP 接收
rtp_proxy_tcp=1
# 等待 TCP 连接超时时间 (秒)
timeoutSec=15

[rtp_proxy]
# 是否开启媒体代理
port=10000

常用 ZLM 管理命令:

• 查看流质量: curl http://zlm:80/index/api/getRtpInfo?secret=xxx&stream_id=xxx (可查看丢包率、帧率)。
• 查看 TCP 连接数: netstat -anp | grep 30000 | wc -l。

---

5. 运维与故障排查

5.1 抓包分析

• 信令抓包: tcpdump -i any port 5060 -X -s0
  • 检查 REGISTER 是否包含 rport。
  • 检查 INVITE 的 SDP 中 m=video 30004 TCP/RTP/AVP。
• 媒体抓包: tcpdump -i any portrange 30000-30500
  • 检查 TCP 三次握手是否成功。

5.2 常见问题

• 点播 488: 通常是 SDP 协商失败，检查摄像头是否支持 TCP 模式。
• 注册频繁掉线: 检查 Kamailio 的 location 过期时间是否短于摄像头的注册周期。
• 无流: 检查代理机防火墙是否开放了 TCP 30000-30500。

---

总结: 本架构通过 Kamailio 解决了信令层的 NAT 问题，通过 ZLM 的 TCP 模式解决了媒体层的网络质量问题，是目前最稳健的 GB28181 接入方案。