术语

为了后文阅读方便，这里列出本页面中反复使用的一些术语。

• 回送数据包(Loopback packets): 从本机 (可以简单理解为 127.0.0.1) 发送到本机的数据包。通常在调试程序的时候为了配置简单，很多情况下就是简单的把服务器和客户端都架设在一台机器上，回送数据包在这种情况下就很常见。
• 输入数据包(Inbound packets): 当前计算机接收到的数据包。其来源可能是网络上的其他机器，也可能就是本机。
• 输出数据包(Outbound packets): 从当前计算机发送出去的数据包。
• 数据包过滤(Filtering): 大部分情况你只对所有的数据包的一个子集感兴趣。在 clumsy 里你可以提供一个 filter 来指定你感兴趣的数据包发送至/发送于某个 IP，包裹协议，以及一些其他的标准。
• 数据包捕获(Capturing packets): 根据之前设定的 filter, clumsy 会拦截下这些符合标准的数据包。在你的程序发出数据包之后，或者再接受到数据包之前，clumsy 会拦截下这些包裹进行处理，进行指定的处理来达到模拟劣化网络环境的效果。
• 重新注入数据包(Reinjecting packets): 在数据包被拦截下来后，他们还是需要被重新发送给目标的端口，这样应用程序才能接收到它们并继续工作。这个步骤科学的讲就叫做重新注入 (reinjecting) 数据包。

限制

！这部分内容非常重要，请务必不要略过。

目前的实现中有一些难以绕过的限制和问题，列表如下：

1. 回送的输入数据包(Loopback inbound packets)无法被重新注入。
   仔细想想你就会发现我们没有很好的方法来区分一个回送数据包到底是被发出还是被接收到，因为它们的目标和来源 IP 地址都是本机。事实上 clumsy 底层的 WinDivert，以及其基于的 Windows Filtering Platform 把所有的回送数据包统统认为是输出 (Outbound) 数据包。这里需要记住的是，当你在本机上处理回送数据包的时候，你不能把 "inbound" 设置在 filter 条件中，最简单的方法就是在条件中简单的加上 "outbound"。另一件容易出问题的事情是，你本机的 IP 不仅仅只有 127.0.0.1 一个，还有类似路由器分配给你机器的 IP 也是属于你的本机 IP。
2. 回送数据包会被处理两次。
   因为所有的回送数据包都被认为是输出数据包，clumsy 会重复处理它们两次。一次是在发出的时候，一次是在接受到的时候。一个简单的例子是简单的把 filter 设置为 outbound，然后在 clumsy 中设置 500ms 的延迟并开启，之后在命令行里 ping localhost。这时你会发现延迟是 1000ms。当然你可以仔细的设置 filter 条件通过设置端口来只捕捉一部分的回送数据包，但是这样会比较麻烦。最简单的做法就是记住这个问题，然后设置参数的时候做相应的计算。
3. 输入数据包的重新注入有些问题。
   根据上面的描述，回送的输入包裹无法被重新注入。问题是现在有些来自包裹虽然其地址不是本机的 IP，其偶尔也会被认为是输入包裹。这种情况如果被捕捉到是无法进行重新注入的。这个问题仅仅影响非回送数据包，所以如果你仅仅是在本机上调试服务器和客户端那么是不会有这个问题的。未来版本的目标是准确的重现这个问题并进行修复。
4. 无法根据进程来进行数据包过滤。
   全系统级的数据包捕获虽然被列在了功能里，实际上是在当前的实现下，没法找到一个合适且稳定的方法来进行根据进程的数据包捕获。

如何使用

首先请根据你系统的版本(32位或64位)下载 clumsy 最新版本。注意如果你安装的是64位的系统那么一定要下载64位的 clumsy。另一件重要的事实 clumsy 需要管理员权限才能正常工作。双击打开 clumsy 的话会弹出 UAC 对话框。如果没有的话请右键点击 clumsy.exe 选择"以管理员身份运行"。如果一切正常，你应该能看到如下图的界面：

根据上图中的数字图标顺序：

1. Filter。详细的 filter 语法在下一部分有仔细的讲解。但是简单的讲它跟你常见的编程语言中的 if 中的条件写法几乎一样。数据包将根据这个标准被拦截。
2. 预设 Filte。 这里提供了一系列内置的预设 Filter 供你使用。你可以通过参考他们来写你自己需要的 Filter，也可以把你发现常用的 filter 写到 clumsy.exe 所在文件夹下的 config.txt 中。
3. 开始/结束 按钮。点击此按钮 clumsy 就会开始捕捉数据包。在某些情况下，比如提供的 filter 语法有问题 clumsy 无法正常开始工作。请参考底部的提示进行操作。如果一切正常按钮上的文字会变为 "Stop"，按下就会停止捕捉包裹，系统网络会恢复正常。按钮左边有一个小图标，每当数据包被捕获的时候它会变绿，当包裹重新注入失败的时候它会变红色。这时你应该考虑是否遇到了上面限制中提到的问题。另外需要提到的是开启和结束可以随时进行并实时生效。
4. 功能控制。勾选功能对应的选框来开启对应的功能。每个功能左边也有一个小图标，其起作用的时候就会变绿。在数据包捕获开启的状态下，你可以实时开启/关闭任何功能，它们都会即时生效。
5. 参数控制。对每个功能，都附有对应的参数控制控件让你进行详细的配置。其中最常见的有：
   • Inbound/Outbound: 是否处理输入/输出数据包。这里在 filter 的控制之外额外提供一个选择的机会，并且也可以在实时生效。
   • Chance: 功能生效的概率。显然你需要把它们设置在一个合理的范围内才不会让网络在可以接受的范围内劣化。
6. 状态。显示 clumsy 当前状态的帮助信息。

clumsy 提供的功能应该很容易理解，你可以在首页的介绍中获得简单的描述，或者你也可以直接试试看。如果你一下子没想起来有什么地方可以用的上，你可以把 filter 设置为 "inbound and outbound" 然后打开你最喜欢的浏览器访问任意网站，看看 clumsy 效果如何。.

Filter 语法

这里 filter 中提供的语句会被直接作为参数提供给 WinDivert。语法在 WinDivert 的文档中有详细的描述。如果你写过一点程序你会发现这个语法跟你放在 if 里面的判断表达式非常类似。你可以用 and, or, not 和 括号 来表达简单的逻辑规则。类似 =, !=, ‹, › 的操作符也可以被使用。下面是 filter 中可以使用的变量的列表(直接拷贝自 WinDivert 的文档)。你也可以通过以预设的 filter 作为例子参考。

常见问题

无法开始，错误代码 "3"
在命令行中输入以下两行并执行：

            sc stop WinDivert1.0
            sc delete WinDivert1.0 
            

在下一版本中这个问题应该会被修正。

clumsy 开始运行后使得网络变慢。
当你输入了 filter 点击 '开始' 后，clumsy 就已经开始截获包裹。这个一定会有一定的效率损失。但好消息是 clumsy 本身就是为了模拟网络状况糟糕的软件所以这个问题不是很严重。 另一方面，你应该精确的设置 filter 的内容，让它尽可能准确的捕捉你感兴趣的数据包。

延迟比在 Lag 里设置的要严重很多。
这个问题的重点在于，clumsy 里面的设置并不是准确的可以用来做测速的值。其作用更倾向于作为参数控制软件的行为。 另一个需要理解的是，这里的延迟是作用于每一个网络包裹的。比如建立一个 TCP 连接需要至少 3 个包裹。那么如果 clumsy 引入了 20ms 的延迟，对于每一个 TCP 连接则至少引入了 3*20=60ms 的延迟。如果是要载入一个网页的话，有部分 HTTP 请求必须是要按顺序完成后页面才能开始渲染。假如要完成 1, 2, 3 这三个请求，那么 clumsy 在这里至少引入了 3*60=180ms 的延迟。 所以说如果 clumsy 让网络变的很慢的话也不用太担心。

在 Windows Server 2008 上报错。
安装这个系统补丁可以解决这个问题。 参见这个 issue。

---