12 个重大版本更新

0.18.0 2024年7月7日
0.16.0 2024年7月7日
0.7.0 2024年2月25日

#21 in #data-link

Download history 22/week @ 2024-04-29 5/week @ 2024-05-06 201/week @ 2024-05-13 113/week @ 2024-05-20 310/week @ 2024-05-27 355/week @ 2024-06-03 273/week @ 2024-06-10 75/week @ 2024-06-17 73/week @ 2024-06-24 234/week @ 2024-07-01 291/week @ 2024-07-08 172/week @ 2024-07-15 141/week @ 2024-07-22 91/week @ 2024-07-29 66/week @ 2024-08-05 20/week @ 2024-08-12

339 每月下载量
13 个 crate (5 个直接使用) 使用

MIT 许可证

8KB

nex

Rust 的跨平台低级网络库

Crates.io Documentation License

概述

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

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

即将推出的功能

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

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

使用方法

要使用 nex,请在您的 Cargo.toml 中将其作为依赖项添加

[dependencies]
nex = "0.18"

使用特定的子 crate

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

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

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

权限

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

针对 Windows 用户

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

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

  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–7.5MB
~49K SLoC