#tun-tap #tokio #tun #tap #async-networking #async #packet

dndx-fork-tokio-tun

使用tokio异步分配TUN/TAP设备

3个版本 (破坏性更新)

0.5.1 2022年4月16日
0.4.0 2021年11月2日
0.3.16 2021年9月23日

#1518异步

MIT/Apache

33KB
701 代码行

Tokio TUN/TAP

Build crates.io Documentation examples

使用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

示例

  • read:将tun拆分为(读取器,写入器)对并从读取器读取数据包。
  • read-mq:使用tokio::select!从多队列tun读取。

依赖项

~4–16MB
~154K SLoC