如何让网络连接在切换网络时不再中断：usrsctp 多宿主 SCTP 协议栈完整指南

如何让网络连接在切换网络时不再中断：usrsctp 多宿主 SCTP 协议栈完整指南

【免费下载链接】usrsctpA portable SCTP userland stack项目地址: https://gitcode.com/gh_mirrors/us/usrsctp

当设备从 Wi-Fi 切到蜂窝网络、或者服务器主网卡掉线时，一条 TCP 连接通常会直接中断——但 SCTP 可以例外。usrsctp 是一个跨平台的用户空间（userland）SCTP 协议栈，支持 Linux、FreeBSD、OpenBSD、macOS 和 Windows，它能让同一条连接同时挂载多条网络路径，某条路径故障时自动切换，还可以在连接存续期间动态增删地址。本文带你搞懂它的多宿主（Multi-homing）能力是怎么实现的、如何十分钟跑通，以及新手最容易踩的几个坑。

场景：你的连接为什么总在换网时"掉线" 🔌

想象一个随身设备：用户在地铁里从 Wi-Fi 切到 4G，IP 地址变了，传统传输层连接就断了，应用只能重新握手、重传状态。服务器端也一样，双线机房里一根专线抖动，所有业务跟着抖。

SCTP 协议在设计上就没把"一条连接 = 一个地址"当作前提。一个Association（关联）可以同时拥有多个端点，协议栈内部维护多条路径（Path），某条路径探测失败后会立刻把数据切到健康路径上，应用层完全无感。usrsctp 的价值在于：它把这套能力做成了一个不依赖操作系统内核、可以直接编译进你自己进程的 C 库。

什么是用户空间协议栈：一张表看懂 usrsctp 🧩

所谓用户空间协议栈，是指协议逻辑（分段重传、拥塞控制、路径管理）不跑在内核里，而是跑在你的应用进程里。网络 I/O 由你提供回调，协议栈负责其余一切。

代价是网络收发由你的代码驱动，但这恰恰带来了可移植性和可控性——协议栈版本、行为参数全部由你掌控，这正是 usrsctplib/netinet/ 目录下各模块（输入处理、输出调度、定时器、地址重配置）可以独立演进的原因。

技术深潜：多宿主在 usrsctp 里是如何落地的 🔍

多个地址，一条连接。核心是三个 API 的配合：usrsctp_bindx()一次性把多个本地地址绑到套接字（标志位SCTP_BINDX_ADD_ADDR），usrsctp_connectx()用多个对端地址发起连接，usrsctp_getpaddrs()/usrsctp_getladdrs()随时查询两端地址列表。下面这段代码就是"双地址建连"的完整骨架：

struct socket *so = usrsctp_socket(AF_INET, SOCK_STREAM, IPPROTO_SCTP, recv_cb, send_cb, 1024, NULL); usrsctp_bindx(so, (struct sockaddr *)laddrs, 2, SCTP_BINDX_ADD_ADDR); sctp_assoc_t id; usrsctp_connectx(so, (struct sockaddr *)paddrs, 2, &id);

故障检测靠重传计数，不靠猜。每条路径有独立的重传计数器，参数sctp_path_rtx_max_default默认 5——某条路径连续重传 5 次失败即被标记失效，数据流自动转移到健康路径；心跳机制则负责发现"对端整台机器都走了"这种更严重的情况。

连接建立后还能改地址。协议标准里的 ADD-IP（动态地址重配置）在 usrsctplib/netinet/sctp_asconf.c 中实现：任一端在运行期新增或删除地址，对端协议栈会自动同步，连接本身不断。usrsctp 的sctp_auto_asconf默认为开启状态（值 1），收到对端地址变更请求时直接生效，省去应用层处理；若你担心地址变更被中间人伪造，sctp_auth_enable默认也是开启的，可以对重配置报文做认证。

一个反直觉的细节：CMT 默认是关的。多路径不只是"备胎"，还能同时跑——这就是 CMT（Concurrent Multi-homing，多路径并发传输），由sctp_cmt_on_off控制。它默认关闭是有意的：并发发送让两条路径共享一个拥塞窗口，调度策略稍微激进就容易在瓶颈链路上互相踩踏，所以协议栈选择了保守默认。想要带宽聚合时再手动打开，并配合sctp_cmt_use_dac、sctp_buffer_splitting调优，收益才可控。

上手路径：10 分钟构建并运行多宿主示例 ⏱️

构建走标准 CMake，不需要任何内核模块：

git clone https://gitcode.com/gh_mirrors/us/usrsctp cd usrsctp && cmake -B build . && cmake --build build

构建完成后，build/programs/目录下有一整套示例程序：echo_server/client演示经典 socket 语义，echo_server_upcall/client_upcall演示upcall（上行回调）模式——先注册收包回调，之后所有协议事件都通过回调推给你的代码，没有系统调用阻塞，更适合嵌进游戏、音视频这类自带事件循环的应用。先起服务端，再跑客户端发一段文本，就能观察到完整的建连、收发、拆连流程。

想验证多宿主？给示例程序同时绑定两个本地地址（如两块网卡或回环 + 本地地址），再抓包观察 INIT 报文中携带的多个地址——这就是多宿主握手在协议层的真实样子。

实战场景：这三个方向值得动手 🌐

• 移动设备漫游：Wi-Fi 和蜂窝双栈同时建连，切网瞬间不掉线，配合 ADD-IP 在 IP 变化后保持关联存活。
• 多线服务器：双线/多线机房把各运营商出口都注册进关联，单线抖动毫秒级转移，线路全断才断连。
• 容器与云迁移：Pod 重建、IP 漂移后通过地址重配置让老连接"搬家"，而不是让上层应用重连。

避坑指南：上手前必须知道的 3 件事 ⚠️

1. 看不到带宽聚合是正常现象。sctp_cmt_on_off默认关闭，默认行为是"一条主路径 + 其他路径热备"。要聚合带宽必须显式开启并调参，否则会被误判为"多宿主没生效"。
2. socket 模式和 upcall 模式二选一。两种模式对应不同的初始化与收发路径（usrsctp_set_upcall()只属于后者），混用会出现"连上了但收不到数据"的诡异现象。
3. 跨 NAT 记得 UDP 封装。公网 NAT 设备普遍不处理 4 号端口的 SCTP 报文，usrsctp 支持把 SCTP 封装进 UDP（默认端口 9899）再发出，跨网部署时务必启用。

行动收尾：从一条不断流的连接开始 🎯

回到开头的问题——网络切换不再等于连接中断。usrsctp 把 SCTP 的多宿主、故障转移和动态地址重配置封装成了任意平台上都能编译的单一 C 库，没有内核依赖，没有黑盒。下一步建议：克隆仓库，按上面的 CMake 命令构建，跑通echo_server和client，然后给它们绑上第二个地址，亲眼看看故障转移发生的那一刻。

延伸阅读：仓库根目录的 Manual.md 提供了全部 API 与配置参数的完整说明，programs/目录下的示例代码是理解 upcall 模式的最好教材。

【免费下载链接】usrsctpA portable SCTP userland stack项目地址: https://gitcode.com/gh_mirrors/us/usrsctp