fumble

fumble 是原始笨拙工具的氧化（基于 Rust）实现，旨在在 Windows 系统上模拟不利网络条件。利用 WinDivert 库的强大功能，fumble 可以截获实时网络数据包，并允许用户对这些数据包引入可控的延迟、丢弃、重复和修改。此工具对于调试网络相关错误、测试应用程序在恶劣网络条件下的健壮性以及评估不可靠网络环境中的性能非常有价值。

与前辈一样，fumble 提供了一种用户友好且交互式的方法来有意降低网络性能，从而更容易诊断问题并提高依赖网络的程序的健壮性。无论是需要模拟不稳定连接的开发者还是进行应用程序压力测试的 QA 工程师，fumble 都提供了一种灵活且可靠的解决方案。

特性

数据包操作特性

• 数据包过滤：使用过滤表达式捕获特定数据包。
• 数据包丢弃：以指定概率丢弃数据包。
• 数据包延迟：引入延迟以模拟延迟。
• 数据包节流：暂时保留或丢弃数据包以模拟断断续续的网络节流。
• 数据包重排：通过应用随机延迟重新排列数据包以模拟乱序交付。
• 数据包篡改：通过更改、翻转或注入数据修改数据包有效载荷以模拟损坏的传输。
• 数据包重复：重复数据包以模拟数据包重复问题。
• 带宽限制：限制带宽以模拟受限的网络环境。

二进制特性

• 通用命令行界面使用方法：利用全面的命令行界面，灵活且详细地控制网络操作设置。轻松指定数据包筛选、丢弃、延迟、限速、重排序、篡改、复制和带宽限制的参数。
• 配置支持：通过配置文件轻松管理设置。创建、列出和使用配置文件来保存和加载您首选的设置，简化设置并确保在不同运行之间的一致行为。
• 文本用户界面（TUI）模式：为偏好交互式和视觉界面的用户提供文本用户界面（TUI）。TUI 提供了一种更用户友好的方式来实时配置和管理网络操作设置。

路线图

• TUI/CLI增强：增强文本用户界面（TUI），提供 fumble 应用网络流量和所有修改的图形可视化。
• 图形用户界面（GUI）：为不使用命令行的用户提供图形用户界面。

要求

重要： fumble 需要 WinDivert.dll 和 WinDivert64.sys 来正常工作。您可以从 官方 WinDivert 发布页面 下载它们。

安装

从源码安装

要构建 fumble，请确保您已安装 Rust 和 Cargo。
克隆仓库并使用 Cargo 构建项目

git clone https://github.com/bornacvitanic/fumble.git
cd fumble
cargo build --release

为确保正常功能，将 WinDivert.dll 和 WinDivert64.sys 放在 fumble 二进制文件同一目录中（通常是 ./target/debug 或 ./target/release）。或者，您可以将包含这些文件的目录添加到系统 PATH 环境变量中。

从 GitHub 发布版

您可以从 GitHub 发布版页面 下载预构建的二进制文件

1. 下载适合您平台的相关发布版。
2. 从发布版归档中提取文件。

发布版归档已包含 WinDivert.dll 和 WinDivert64.sys 文件的副本。

作为 CLI 从 crates.io 安装

要全局安装 fumble 作为命令行工具，使用以下命令

cargo install fumble

这将安装 fumble 二进制文件，使您能够全局使用 CLI 工具。安装后，请确保 WinDivert.dll 和 WinDivert64.sys 与 fumble 二进制文件在同一目录中（通常位于 Windows 的 C:\Users\username\.cargo\bin）。或者，您可以将包含这些文件的目录添加到系统 PATH 环境变量中。

将 fumble 作为库使用

要将 fumble 包含为 Rust 项目的依赖项，请将以下内容添加到您的 Cargo.toml

[dependencies]
fumble = "0.6.0"

运行 cargo build 以下载和编译软件包。
为确保正常功能，将 WinDivert.dll 和 WinDivert64.sys 放在 fumble 二进制文件同一目录中（通常是 ./target/debug 或 ./target/release）。或者，您可以将包含这些文件的目录添加到系统 PATH 环境变量中。

使用方法

使用所需选项运行 fumble 可执行文件

fumble --filter "inbound and tcp" --delay-duration 500 --drop-probability 0.1

TUI 模式

fumble 为那些希望有更多交互式体验的用户提供文本用户界面（TUI）模式。TUI 允许您在视觉界面中查看、配置和管理网络操作设置，便于动态调整设置。您可以通过配置或常规 CLI 命令初始化 TUI。

启动 TUI

要在文本用户界面（TUI）模式下启动 fumble，请使用以下命令：

fumble  -t

进入TUI后，您可以使用键盘浏览不同的设置。TUI提供实时反馈，允许您快速调整配置。

您可以从配置的单独命令或初始化TUI的默认值。您还可以指定一个初始过滤器。

fumble --filter "outbound and udp"  -t

fumble --filter "outbound and udp" --delay-duration 500  -t

fumble --filter "inbound and udp" --use-config config_name  -t

日志记录

该工具使用env_logger crate进行日志记录。默认情况下，显示信息消息。

启用详细日志

要查看更多详细日志，在运行fumble之前设置RUST_LOG环境变量。

贡献

欢迎贡献！请打开一个问题或提交一个拉取请求。

许可证

本项目受MIT许可证许可 - 有关详细信息，请参阅LICENSE文件。

致谢

• clap - 一个用于Rust的命令行参数解析器，它提供了一个简单且强大的API来定义复杂的CLI界面。
• windivert - WinDivert库的Rust绑定，用于网络数据包拦截和处理。
• rand - 一个用于生成随机数的Rust库，用于实现随机数据包丢弃和复制。
• ratatui - 一个Rust库，用于构建终端用户界面，强调简单性和易用性。
• tui-textarea - 一个用于在终端用户界面中管理文本输入的Rust crate。
• lazy_static - 一个Rust宏，用于定义计算懒惰的静态初始化变量。
• ctrlc - 一个用于处理Ctrl-C信号的Rust库，启用优雅的关闭和干净的线程终止。
• regex - 一个用于正则表达式的Rust库，用于字符串匹配操作。
• env_logger - 一个简单的Rust应用程序日志记录器，可以通过环境变量进行配置。
• log - 一个提供各种日志实现的通用接口的日志外观。
• serde - 用于配置文件的序列化和反序列化。
• toml - 用于解析和序列化TOML配置文件。
• dirs - 用于处理跨不同操作系统的配置目录。
• thiserror - 用于健壮的错误处理。

联系

• 电子邮件: [email protected]
• GitHub问题: GitHub问题页面