3个版本 (破坏性更新)
0.5.1 | 2022年4月16日 |
---|---|
0.4.0 | 2021年11月2日 |
0.3.16 | 2021年9月23日 |
#1518 在 异步
33KB
701 代码行
Tokio TUN/TAP
使用tokio
在Rust中异步分配TUN/TAP设备。使用async-tun获取async-std
版本。
入门
- 使用
TunBuilder
创建tun设备并在循环中读取
#[tokio::main]
async fn main() -> Result<()> {
let tun = TunBuilder::new()
.name("") // if name is empty, then it is set by kernel.
.tap(false) // false (default): TUN, true: TAP.
.packet_info(false) // false: IFF_NO_PI, default is true.
.up() // or set it up manually using `sudo ip link set <tun-name> up`.
.try_build()?; // or `.try_build_mq(queues)` for multi-queue support.
println!("tun created, name: {}, fd: {}", tun.name(), tun.as_raw_fd());
let (mut reader, mut _writer) = tokio::io::split(tun);
let mut buf = [0u8; 1024];
loop {
let n = reader.read(&mut buf).await?;
println!("reading {} bytes: {:?}", n, &buf[..n]);
}
}
- 使用
sudo
运行代码
➜ sudo -E /path/to/cargo run
- 设置设备地址(地址和子网掩码也可以使用
TunBuilder
设置)
➜ sudo ip a add 10.0.0.1/24 dev <tun-name>
- Ping来读取数据包
➜ ping 10.0.0.2
- 显示设备并分析网络流量
➜ ip tuntap
➜ sudo tshark -i <tun-name>
支持的平台
- Linux
- FreeBSD
- Android
- OSX
- iOS
- Windows
示例
依赖项
~4–16MB
~154K SLoC