Async TUN/TAP

使用async-std在Rust中异步分配TUN/TAP设备。使用tokio-tun进行tokio版本。

入门

• 使用TunBuilder创建tun设备，并在循环中读取它

async fn async_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.
        .await?;

    println!("tun created, name: {}, fd: {}", tun.name(), tun.as_raw_fd());

    let mut reader = tun.reader();
    let mut buf = [0u8; 1024];
    loop {
        let n = reader.read(&mut buf).await?;
        println!("reading {} bytes: {:?}", n, &buf[..n]);
    }
}

fn main() -> Result<()> {
    task::block_on(async_main())
}

• 使用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：从多队列tun读取。