当前位置：首页>Linux>nmrs v3.0:Rust在Linux上管Wi-Fi和VPN,终于不用再跟nmcli的字符串搏斗了

nmrs v3.0:Rust在Linux上管Wi-Fi和VPN,终于不用再跟nmcli的字符串搏斗了

2026-06-30 04:39:24

nmrs这个库出现已经有一阵了，2026年开春以来它迭代的节奏明显加速——v3.0.0刚在前两天砸下来，带来了VPN支持、Wi-Fi scoping、secret agent API这一大串重量级的更新。老实说，Linux上处理NetworkManager绑定这件事，这些年翻来覆去就是nmcli和nm-applet这两条路，前者是命令行里的瑞士军刀但脚本化体验割裂，后者是个拖着GTK3尾巴的老旧托盘程序。nmrs不一样——它是一套Rust async-first的NetworkManager D-Bus绑定，底核基于zbus，在提供完整Wi-Fi管理和VPN功能的同时，保持了类型安全和极低的资源消耗。这个组合，在Node.js或Python生态压根见不着。

这玩意儿到底是干嘛的。用一句话概括：nmrs是一个纯Rust实现的异步NetworkManager客户端库，附带一个Wayland兼容的GTK4图形界面版本叫nmrs-gui。它不调nmcli，不走nmcli那层成天冒Human-readable文本输出的壳，直接用D-Bus守护进程和NetworkManager通信。api层面的设计目标是让开发者能用Rust编写高性能、可靠且安全的网络管理工具，同时对桌面用户也提供一个现代化的图形化前端。对于开发来说，nmrs提供了从扫描无线网络、连接WPA加密热点到管理VPN（WireGuard和OpenVPN）的几乎全套接口；对于用户来说，nmrs-gui则在极低资源消耗基础上给出了一个能在Hyprland、Sway这些平铺窗口管理器下原生工作的网络面板。

上手之前先把依赖搞对。nmrs要求NetworkManager在Linux系统上跑着，D-Bus服务可用，同时Rust工具链版本至少1.94.0。cargo项目的依赖部分其实不复杂，但涉及feature层面有些可控的开关。Cargo.toml里大致这样：

[dependencies]tokio = { version = "1", features = ["full"] }nmrs = "3.0"

如果不想引入tokio全量特性，把runtime换成async-std或者smol也行，nmrs对异步运行时没有硬性要求，因为底层的zbus通过启动后台线程处理D-Bus通信，这种设计天然兼容不同的异步运行时，不需要手动管理executor。v3.0开始强化了VPN支持，如果你需要WireGuard和OpenVPN的能力，把nmrs默认开启的vpn feature保留就好；不碰VPN的话可以直接default-features = false来精减依赖树。

现在拉出两个核心操作的例子，顺便直接拆解流程。

扫描并列出可用Wi-Fi网络，这事用nmrs实现只需要几行。初始化NetworkManager实例之后，直接调list_networks(None)，后面接一个简单的for循环：

use nmrs::NetworkManager;#[tokio::main]async fn main() -> nmrs::Result<()> { let nm = NetworkManager::new().await?; let networks = nm.list_networks(None).await?; for net in networks { println!( "{} - Signal: {}%, Security: {:?}", net.ssid, net.strength.unwrap_or(0), net.security ); } Ok(())}

这个方法返回每个网络的SSID、信号强度百分比和安全类型。这里提一句，list_networks的参数用来限制扫描的接口名，传None表示在所有无线网卡上扫。

连接到WPA2/WPA3无线网络也是一个样板级的调用。先说明白，nmrs本身的WifiSecurity枚举封装了三种常见情况：开放网络（WifiSecurity::None）、WPA预共享密钥（WpaPsk）、企业认证（WpaEap）。下面这段用了预共享密钥：

use nmrs::{NetworkManager, WifiSecurity};#[tokio::main]async fn main() -> nmrs::Result<()> { let nm = NetworkManager::new().await?; nm.connect( "MyNetwork", None, WifiSecurity::WpaPsk { psk: "password123".into(), }, ) .await?; if let Some(ssid) = nm.current_ssid().await { println!("Connected to: {}", ssid); } Ok(())}

连接成功后通过current_ssid()取当前活跃的SSID。

要想把nmrs真正用顺，必须先吃透它的错误处理。nmrs的每个网络操作返回的都是特定错误变体，不能直接用那种笼统的Box直接吞掉。四个最常见的ConnectionError类型：AuthFailed（密码错误）、NotFound（SSID不符或不在范围）、Timeout（超时）、以及一个通配的Error分支。下面代码块展示了这四态分支的处理模板，基本拿来就能套在所有连接逻辑里：

use nmrs::{NetworkManager, WifiSecurity, ConnectionError};#[tokio::main]async fn main() -> nmrs::Result<()> { let nm = NetworkManager::new().await?; match nm .connect( "MyNetwork", None, WifiSecurity::WpaPsk { psk: "wrong_password".into(), }, ) .await { Ok(_) => println!("Connected successfully"), Err(ConnectionError::AuthFailed) => { eprintln!("Authentication failed - wrong password") } Err(ConnectionError::NotFound) => { eprintln!("Network not found or out of range") } Err(ConnectionError::Timeout) => { eprintln!("Connection timed out") } Err(e) => eprintln!("Error: {}", e), } Ok(())}