libpnet

构建状态：

讨论和支持

• 在 IRC 上的实时聊天 - #libpnet on irc.libera.chat
• GitHub 讨论区

libpnet 提供了一个跨平台的 API，用于使用 Rust 实现底层网络。

有四个关键组件

• packet 模块，允许安全地构建和操作数据包；
• pnet_macros crate，为数据包模块提供基础设施；
• transport 模块，允许实现传输协议；
• datalink 模块，允许直接发送和接收数据链路数据包。

为什么？

有很多理由使用底层网络，使用 Rust 来做更是如此。以下是一些概述

开发传输协议

通常有两种方法来开发新的传输层协议：

• 使用脚本语言，如Python编写；
• 使用C语言编写。

前者非常适合尝试新想法和快速原型设计，但在实际应用中并不理想。虽然可以从这些实现中获得合理的性能，但它们的速度通常比C语言实现慢得多，并且不适合任何“重负荷”任务。

另一种选择是使用C语言编写——这将带来出色的性能，但也会带来一些其他问题：

• 内存安全性不足——这是基于C语言的网络栈中安全漏洞和其他错误的一个主要来源。忘记边界检查或在释放指针后使用指针实在太容易了。
• 线程安全性不足——你必须非常小心，确保使用正确的锁，并且使用正确。
• 缺乏高级抽象——Python等脚本语言的吸引力之一是其高级抽象，这使得API更简单，编程更容易。

使用libpnet和Rust，你可以兼得二者之优。高级抽象、内存和线程安全性，以及C语言的性能。

网络工具

许多网络工具，如ping和traceroute，依赖于能够操作网络和传输层头，这是使用标准网络堆栈（如由std::io::net提供的）所无法实现的。

数据链路层

在数据链路层直接工作是有用的，可以看到数据包是如何“在线上”的。这有很多用途，包括网络诊断、数据包捕获和流量整形。

文档

最新构建的API文档可以在这里找到：[https://docs.rs/pnet/](https://docs.rs/pnet/)

使用方法

要在项目中使用libpnet，请将以下内容添加到您的Cargo.toml中：

[dependencies.pnet]
version = "0.35.0"

libpnet应该与Rust的最新稳定版本兼容。

在运行测试套件时，有一些网络测试可能会失败——解决这个问题最简单的方法是以root或管理员用户运行cargo test。这通常可以避免，但会更复杂。

Windows

在Windows上构建有三个要求：

• 你必须使用使用MSVC工具链的Rust版本。
• 你必须已安装WinPcap或npcap（已测试WinPcap版本4.1.3）（如果使用npicap，请确保以“在WinPcap API兼容模式下安装Npcap”）
• 您必须将来自 WinPcap 开发者包 的 Packet.lib 放置在名为 lib 的目录中，在仓库根目录下。或者，您可以使用 %LIB%/$Env:LIB 环境变量中的任何位置。对于 64 位工具链，它在 WpdPack/Lib/x64/Packet.lib 中，对于 32 位工具链，它在 WpdPack/Lib/Packet.lib 中。