Kamailio WebSocket连接问题分析与解决方案

问题背景

在Kamailio 5.8.2及以上版本中，当作为WebRTC到SIP(UDP)网关使用时，出现了WebSocket连接无法正常工作的问题。具体表现为当尝试通过已建立的WSS(WebSocket Secure)连接发送SIP消息时，系统会报错"TCP/TLS connection for WebSocket could not be found"，导致消息转发失败。

问题现象

在Kamailio 5.8.1版本中运行正常的WebRTC网关功能，在升级到5.8.2或5.8.3后出现以下错误日志：

WARNING: webrtc:tm [../../core/forward.h:204]: msg_send_buffer(): TCP/TLS connection for WebSocket could not be found
WARNING: webrtc:tm [t_fwd.c:1586]: t_send_branch(): sending request on branch 0 failed

技术分析

根本原因

这个问题源于Kamailio 5.8.2版本中引入的一个TCP连接匹配机制的改进。新版本对TCP连接的匹配变得更加严格，特别是在处理WebSocket连接时：

1. 当tcp_connection_match=1时，系统会同时匹配本地端口和远程端口
2. 对于WSS(WebSocket Secure)连接，系统未能正确识别对应的TLS socket
3. 连接匹配逻辑在处理WebSocket协议类型时存在缺陷

影响范围

该问题影响所有使用Kamailio作为WebRTC网关，并且满足以下条件的场景：

• 使用5.8.2或更高版本
• 配置了tcp_connection_match=1
• 需要通过已建立的WebSocket连接转发SIP消息

解决方案

临时解决方案

在确认问题根源前，可以暂时通过以下配置调整解决问题：

tcp_connection_match=0  # 禁用严格的TCP连接匹配

永久解决方案

Kamailio开发团队已经修复了这个问题，解决方案包括：

1. 修复了TCP连接匹配逻辑中对WebSocket协议的处理
2. 确保WSS协议能正确匹配到TLS socket
3. 修复了相关代码中的潜在崩溃问题

建议用户升级到包含修复的Kamailio版本（6.0.0-dev2或更高）。

配置建议

对于WebRTC网关场景，建议采用以下TCP相关配置：

tcp_send_timeout=3
tcp_connect_timeout=10
tcp_connection_lifetime=3605
tcp_rd_buf_size=32768
tcp_max_connections=2048
tcp_connection_match=1  # 修复后可以安全启用
tcp_reuse_port=yes
tcp_keepalive=yes
tcp_keepcnt=3
tcp_keepidle=30
tcp_keepintvl=10
tcp_async=yes
tcp_crlf_ping=no
tcp_accept_no_cl=yes

技术细节

WebSocket与TLS的关系

在Kamailio中处理WebSocket连接时需要注意：

• WSS(WebSocket Secure)实际上是WebSocket over TLS
• 但协议标识上使用"ws"和"wss"而非"tcp"和"tls"
• 修复确保协议类型能正确映射到对应的传输层

连接匹配机制

修复后的连接匹配机制：

1. 首先检查协议类型是否匹配
2. 对于WebSocket连接，会检查底层传输协议(TCP/TLS)
3. 严格匹配源/目的IP和端口（当tcp_connection_match=1时）
4. 确保连接状态有效

总结

Kamailio 5.8.2版本引入的TCP连接匹配改进虽然提升了连接管理的精确度，但也带来了WebSocket连接处理的问题。开发团队迅速响应并修复了这个问题，现在用户可以安全地使用最新版本作为WebRTC网关。对于关键业务系统，建议在升级前进行全面测试，并关注官方更新日志以获取最新修复信息。