#data-link #networking #packet #layer #cross-platform #low-level

nex-datalink

提供跨平台数据链路层网络。nex项目的一部分。

10个重大版本发布

0.18.0 2024年7月7日
0.14.0 2024年6月9日
0.7.0 2024年2月25日

#2157 in 网络编程

Download history 17/week @ 2024-04-18 146/week @ 2024-04-25 8/week @ 2024-05-02 3/week @ 2024-05-09 231/week @ 2024-05-16 118/week @ 2024-05-23 182/week @ 2024-05-30 467/week @ 2024-06-06 82/week @ 2024-06-13 62/week @ 2024-06-20 23/week @ 2024-06-27 169/week @ 2024-07-04 57/week @ 2024-07-11 100/week @ 2024-07-18 33/week @ 2024-07-25 8/week @ 2024-08-01

每月下载 217 次
6 个crates中使用(通过 nex

MIT 协议

81KB
1.5K SLoC

nex

Rust跨平台底层网络库

Crates.io Documentation License

概述

nex 是一个Rust库,提供跨平台底层网络功能。
它包括一系列模块,每个模块都有特定的重点

  • datalink: 数据链路层网络。
  • packet: 低级数据包解析和构建。
  • packet-builder: 高级数据包构建。
  • socket: 与套接字相关的功能。

即将推出的功能

该项目计划通过以下功能增强nex

  • 更多协议支持:扩展协议支持,包括更多的网络协议和标准。
  • 性能改进:持续进行性能提升,以实现更快的网络操作。

使用方法

要使用 nex,请将其添加到您的 Cargo.toml 文件中的依赖项。

[dependencies]
nex = "0.18"

使用特定子crates

您还可以通过单独导入来直接使用特定的子crates。

  • nex-datalink
  • nex-packet
  • nex-packet-builder
  • nex-socket

如果您想专注于网络接口,可以使用 netdev

权限

nex-datalink 使用原始套接字,根据您的系统配置可能需要提升权限。
如有必要,以管理员权限执行。

针对Windows用户

请注意,为了在Windows上使用 nex-datalink 发送和接收原始数据包,需要 Npcap

  1. 安装Npcap,确保在安装过程中选中“在WinPcap API兼容模式下安装Npcap”。

  2. 下载Npcap SDK。将SDK的 /Lib/x64(或 /Lib)文件夹添加到您的LIB环境变量中。

针对macOS用户

在macOS上,为了使用nex-datalink发送和接收原始数据包,管理对伯克利数据包过滤器(BPF)设备的访问是必要的。您可以使用chmod-bpf自动管理BPF设备的权限。当然,您也可以使用sudo临时授予必要的权限。

可选功能的构建时间要求

nex-socket的可选tls-aws-lc功能使用aws-lc-rs作为加密提供者。请注意,这将对构建时工具要求产生一些影响,例如需要在所有平台上使用cmake,在Windows上使用nasm。
您可以通过指定tls功能,使用ring作为加密提供者(无需额外依赖)。

致谢

这个库受到了pnet的极大启发,这推动了我进入Rust开发之旅。
我感谢所有参与pnet的人,他们为Rust的网络开发做出了开创性的努力和重大贡献。

此外,还要感谢所有为nex所依赖的项目做出贡献和维护的人,你们的宝贵工作和支持是无价的。

依赖项

~0.1-9MB
~75K SLoC