Clumsy 网络故障模拟工具使用指南

注意事项：

• 必须保证 clumsy.exe、WinDivert.dll 和 WinDivert64.sys 在同一目录，否则软件会无法正常工作（会提示找不到驱动或捕获失败）。
• 运行 Clumsy 需要管理员权限，否则系统层级的网络拦截不会生效（你会看到提示'请以管理员身份运行'）。
• 如果你的系统是 32 位的，需要相应的 WinDivert.sys 文件，而不是 WinDivert64.sys（在下载时请选择 32 位的版本）。

2. 基本界面说明

双击【clumsy.exe】启动软件，界面如下：

上图是 Clumsy 的主页面截图，可以看到它的界面主要分为三个部分：Filtering（过滤器）、Functions（功能选项）和 NOTICE（提示说明区域）

2.1 Filtering: 过滤设置（过滤哪些流量）

作用：告诉 Clumsy 需要对那些数据进行干扰（模拟异常）。

组件：

输入框：可以输入过滤表达式，比如 udp and outbound、tcp port 8080、ip and not loopback。用于指定拦截哪些类型的流量。

Presets: 快捷选择预设过滤条件，比如 localhost ipv4 all（本地 IPv4 所有流量）。初学者建议使用预设选项。 所由预设条件如下：

Start 按钮： 开始拦截并应用模拟效果，等于'运行'。修改完设置后要点这个才会生效。启动后 Start 按钮变为 Stop 按钮，点击 Stop 按钮可以停止拦截。

启动状态按钮前方的绿色指示灯会闪烁，表示网络拦截正在生效。

2.2 Functions：功能模块（模拟哪些网络异常）

这是 Clumsy 的核心功能区域，控制你希望模拟哪种网络问题。每项都可以单独启用，也可以多个一起组合使用。 每一行功能结构基本一致：

• 复选框 ✅：是否启用该功能
• Inbound / Outbound：应用于'入站 / 出站'数据包
• 参数设置：延迟时间、丢包概率、限速值等

每项功能的右侧有多个可调参数，如：

• Delay(ms)： 延迟时间（如 Lag 使用）
• Chance(%)： 触发概率（如 Drop、Duplicate 等使用）
• Limit(KB/s)： 带宽限制数值（Bandwidth 使用）
• Drop Throttled： 是否丢弃超出节流限制的数据包。如果勾选，超出速率的数据包会被直接丢弃；否则只是延迟发送。可以指定一个时间窗口，例如默认是 30ms，表示每 30 毫秒 Clumsy 会判断是否节流。
• Count： 指定重复发送次数，Clumsy 将某个数据包复制指定份数发送。
• Redo Checksum： 勾选后会重新计算并修复篡改后的校验和（TCP/UDP/IP 协议都涉及校验），这样，修改后的数据包就能顺利'骗过'网络协议检查机制，被对端正常接收处理，如果不勾选篡改后的数据包可能会被接收方拒收。
• RST next packet： 点击后可立即终止一个 TCP 连接。

2.3 NOTICE：底部提示栏

这部分是对过滤设置的一些补充说明，尤其是捕获本机（localhost）流量时的限制。 截图内容意思为：当你测试的是回环地址（如 127.0.0.1），不能使用 Inbound 过滤条件。也就是说，如果你模拟本地服务器或自己机器的服务，只能用 outbound 来测试。

3. 实用场景示例

以下是推荐的几个实用场景示例

3.1 本地服务在网络差时是否仍能稳定响应？

背景：在本机运行了一个 Web 服务或后端接口（比如 127.0.0.1:8080），想验证当客户端网络变差时，服务是否能处理超时、重试等逻辑。 设置： Preset：localhost ipv4 tcp（拦截所有本机 IPv4 回环地址的数据流） Lag：500ms（500 毫秒延迟） Drop：10%（10% 的丢包率） Throttle：Timeframe: 30ms；Chance: 30%；Drop Throttled: 不勾选（模拟延迟但不丢包）

测试的目标：

• 前端或客户端是否能处理请求超时？
• 服务是否会异常崩溃？
• 用户体验是否合理（如等待页面、错误提示）？

3.2 测试弱网环境下的移动 App 接口调用

背景：App 应用正常运行没问题，担心用户在 4G 差或 Wi-Fi 卡顿时接口调用会失败。 设置： Preset：all ipv4 against specific 服务器 IP（拦截发往或来自'指定 IP 地址'的所有 IPv4 数据流） Lag：100~300ms（延迟） Drop：10%（10% 的丢包率） Throttle：Timeframe: 30ms；Chance: 30%；Drop Throttled: 不勾选（模拟延迟但不丢包） Out of order：10%（数据包乱序的概率）

测试的目标：

• SDK 是否支持断线重连、超时重试？
• 用户数据是否丢失？
• 异常提示是否准确？

3.3 测试 TCP 服务在断网或网络抖动下的健壮性

背景：程序需要长时间维持 TCP 连接（如长连接、心跳机制），想看突然断网或重连是否正常恢复。 设置： Preset：tcp ipv4 against 服务端口号（拦截所有走特定端口的 IPv4 数据） Set TCP RST：通过点击 [RST next packet] 立即断开 TCP 连接 Drop：10%（10% 的丢包率） Tamper：勾选 Redo Checksum，10%（篡改数据包，模拟数据解析异常情况）

测试的目标：

• 程序是否能自动重连？
• 会不会导致崩溃或数据丢失？
• UI 提示是否合理？

四、如何从 0 开始用 Clumsy 建立网络异常测试体系？

如果你所在的公司和我一样，过去并没有系统地做过网络异常模拟测试，那么你作为测试人员要推动这件事，可以参考下面这几个步骤，从无到有逐步落地：

第一步：明确测试目标，划定边界

在开始测试前，先明确你想解决的问题：

• 你的产品/系统是否依赖网络？在哪些环节？
• 哪些功能在网络波动时最容易出错？（例如：登录、设备连接、实时同步等）
• 你是希望做冒烟测试，还是做系统性的稳定性评估？

第二步：规划测试维度 & 使用 Clumsy 对应功能

根据常见网络异常，确定你的测试维度，常见如下：

每个维度建议至少设计 2~3 个强度等级：正常 / 较弱网 / 极端弱网。

第三步：编写测试用例

用常规测试用例的结构来编写即可，如下示例：

用例编号：NET_001 测试目标：验证订单支付流程在中度延迟（Lag 200ms）情况下是否可用 前置条件：用户已登录并选好商品 步骤：

1. 打开 Clumsy，启用 Lag，设置为 200ms，勾选 Inbound + Outbound；
2. 在 App/Web 中进行下单支付；
3. 观察是否超时、卡顿、订单是否成功；

预期结果：

• 页面无明显崩溃；
• 支付能正确完成或提示网络不稳定并重试；

可以先在几个关键路径和节点写好用例，后续再慢慢补充其它边角逻辑。

第四步：整理测试模板，团队共用

可以在团队内建立以下几个标准化内容：

1. 一个 Clumsy 参数设置参考表（不同场景用哪些参数）
2. 一套通用测试用例模板（如上）
3. 一个简单的使用录屏（怎么打开 Clumsy、怎么开始测试）
4. 一个'异常网络环境级别定义文档'（例如：轻度、中度、严重）

让团队成员都能快速上手，同时保障测试的一致性和可复现性。

第五步：总结 bug 和优化建议，形成闭环

• 在测试中记录下'哪些功能在什么网络条件下出问题'；
• 与开发协作优化，比如增加错误重试机制、延迟提示、降级处理等；
• 最终输出一份《网络异常场景测试报告》，推动产品优化升级，提高用户体验。

网络异常测试参数设置参考

以下是一些可用的网络异常测试的常用指标，可供参考：

五、常见问题 FAQ

Q1：Clumsy 是不是只能用在 Windows？

是的，Clumsy 目前仅支持 Windows 系统（依赖 WinDivert 驱动）。在 Linux 上可使用类似工具如 tc、netem、dummynet 等。

Q2：Clumsy 会影响本机所有程序的网络吗？

是的。Clumsy 会以全局方式 Hook 网络层（WinDivert 驱动），因此它对所有通过网卡走的 TCP/UDP 流量都生效。建议测试时只运行目标程序，避免干扰其他软件。

Q3：我用的是 WebSocket 协议，能用 Clumsy 测试吗？

完全可以。WebSocket 底层依赖 TCP 连接，所以 Clumsy 对 TCP 包的延迟、丢包等设置都会直接影响 WebSocket 的表现，非常适合做实时控制和视频流的异常测试。

Q4：如何判断 Clumsy 的设置是否生效？

建议使用 ping 命令，ping 想要测试的设备地址，查看其延迟和丢包率是否与设置的异常情况一致。

Q5：Clumsy 会修改系统网络设置吗？

不会。Clumsy 是一个基于 WinDivert 的临时网络拦截工具，只在运行时生效，不会永久更改系统网络配置或驱动。关闭 Clumsy 后，网络会立即恢复正常。

Q6：启动 Clumsy 后没有任何效果，怎么办？

请检查以下几点：

• 是否以管理员权限运行；
• 是否勾选了具体的干预项（如 Delay / Drop）；
• Preset（预设）是否选中了目标流量（如 IPv4 / TCP）；
• 应用是否确实产生了网络流量；
• 是否设置了太低的概率（如 Drop 10%，可能观察不到）；
• 本地防火墙是否拦截了 Clumsy / WinDivert。

Q7：我想验证两个移动设备之间的网络异常情况该如何操作？

Clumsy 只能干扰经过运行 Clumsy 的设备的网络消息，如果两个移动设备通讯的网络消息未经过运行 Clumsy 的设备则无法干扰。 这种情况我们可以在运行 Clumsy 的设备上开启一个移动热点，构建一个局域网，要测试的两台移动设备连接到这个局域网中进行通讯，此时运行 Clumsy 即可干扰这两个移动设备间的网络通讯。

六、扩展内容

1. Clumsy 的技术原理

Clumsy 本质上是一个基于 WinDivert 的 GUI 工具，它通过拦截、修改、重注入网络数据包来模拟网络异常。 它的核心原理可以简要概括为：

1. 使用 WinDivert 驱动拦截本机进出数据包；
2. 根据用户设置的规则（如延迟、丢包、乱序等）对数据包进行加工；
3. 将修改后的数据包重新注入网络栈，让上层应用接收到'异常'效果；
4. 不需要对目标应用或网络协议进行改动，直接作用于底层网络传输层。

架构图：

2. 什么是 WinDivert

WinDivert 是一个开源的 Windows 平台下的网络数据包捕获与修改工具库，它允许开发者在内核态与用户态之间拦截、修改和重注入网络数据包。 简单来说，它是一种驱动级别的网络'钩子'工具，可以用于构建诸如网络调试器、防火墙、VPN、网络模拟器（比如 Clumsy）等工具的底层组件。

官网：官网地址 文档：说明文档地址

3. 除了 Clumsy，还有哪些网络模拟工具？

1. NetEm（Linux）：适用于 Linux 平台的专业网络模拟器，支持延迟、抖动、丢包、限速。
2. WANem：基于虚拟机的网络环境模拟器，可以模拟复杂的广域网环境。
3. NetLimiter / NetBalancer：Windows 下的流量控制和限速工具。
4. Chaos Mesh / Istio：在云原生环境下做'网络熔断'测试的方案。