Rust： 获取 MAC 地址方法大全
在 Rust 中获取 MAC 地址（物理地址）需要依赖第三方库，因为标准库不提供此功能。以下是全面的解决方案：
📦 添加依赖
使用 mac_address 库：
[dependencies]
mac_address = "1.1.0"
🔧 基础方法
1. 获取所有网络接口的 MAC 地址
use mac_address::get_mac_addresses;fn main() {match get_mac_addresses() {Ok(interfaces) => {println!("所有网络接口的 MAC 地址:");for interface in interfaces {println!("接口: {}, MAC: {}", interface.name, interface.address);}}Err(e) => eprintln!("获取 MAC 地址失败: {}", e),}
}
2. 获取主网络接口的 MAC 地址
use mac_address::get_mac_address;fn main() {match get_mac_address() {Ok(Some(mac)) => println!("主 MAC 地址: {}", mac),Ok(None) => println!("未找到 MAC 地址"),Err(e) => eprintln!("获取 MAC 地址失败: {}", e),}
}
🌐 高级用法
1. 获取特定接口的 MAC 地址
use mac_address::mac_address_by_name;fn main() {let interface_name = "eth0"; // 替换为你的接口名match mac_address_by_name(interface_name) {Ok(Some(mac)) => println!("{} 的 MAC 地址: {}", interface_name, mac),Ok(None) => println!("未找到 {} 的 MAC 地址", interface_name),Err(e) => eprintln!("获取 MAC 地址失败: {}", e),}
}
2. 过滤虚拟接口
use mac_address::get_mac_addresses;fn get_physical_macs() -> Vec<mac_address::MacAddress> {get_mac_addresses().unwrap_or_default().into_iter().filter(|iface| {// 过滤掉虚拟接口!iface.name.starts_with("docker") &&!iface.name.starts_with("veth") &&!iface.name.starts_with("br-") &&!iface.name.starts_with("lo")}).map(|iface| iface.address).collect()
}fn main() {println!("物理接口的 MAC 地址:");for mac in get_physical_macs() {println!("- {}", mac);}
}
3. 格式化 MAC 地址
use mac_address::MacAddress;fn format_mac(mac: &MacAddress) -> String {mac.bytes().iter().map(|b| format!("{:02X}", b)).collect::<Vec<_>>().join(":")
}fn main() {if let Ok(Some(mac)) = get_mac_address() {println!("格式化 MAC 地址: {}", format_mac(&mac));}
}
🧪 跨平台兼容性处理
1. 处理不同平台的接口命名
use mac_address::get_mac_addresses;fn get_primary_mac() -> Option<mac_address::MacAddress> {let interfaces = get_mac_addresses().ok()?;// 不同平台的优先级let preferred_names = if cfg!(target_os = "windows") {vec!["Ethernet", "Wi-Fi"]} else if cfg!(target_os = "macos") {vec!["en0", "en1"]} else {vec!["eth0", "wlan0"]};for name in preferred_names {if let Some(iface) = interfaces.iter().find(|i| i.name.contains(name)) {return Some(iface.address.clone());}}// 返回第一个非虚拟接口interfaces.into_iter().find(|iface| !iface.name.starts_with("lo")).map(|iface| iface.address)
}
2. Windows 特定处理
#[cfg(windows)]
fn get_windows_mac() -> Option<mac_address::MacAddress> {use winreg::enums::*;use winreg::RegKey;let hklm = RegKey::predef(HKEY_LOCAL_MACHINE);let interfaces = hklm.open_subkey("SYSTEM\\CurrentControlSet\\Control\\Class\\{4d36e972-e325-11ce-bfc1-08002be10318}").ok()?;for subkey_name in interfaces.enum_keys().filter_map(|k| k.ok()) {if let Ok(subkey) = interfaces.open_subkey(subkey_name) {if let Ok(addr) = subkey.get_value::<String, _>("NetCfgInstanceId") {if let Ok(Some(mac)) = mac_address_by_name(&addr) {return Some(mac);}}}}None
}
🛡️ 错误处理与日志
1. 自定义错误类型
use thiserror::Error;#[derive(Error, Debug)]
enum MacError {#[error("MAC 地址获取失败")]RetrievalError(#[from] mac_address::MacAddressError),#[error("未找到 MAC 地址")]NotFound,#[error("无效的 MAC 地址")]InvalidFormat,
}fn get_safe_mac() -> Result<String, MacError> {let mac = get_mac_address()?.ok_or(MacError::NotFound)?;if mac.bytes().iter().all(|&b| b == 0) {return Err(MacError::InvalidFormat);}Ok(format_mac(&mac))
}
2. 带重试的 MAC 获取
use std::thread;
use std::time::Duration;fn get_mac_with_retry(max_retries: u8) -> Option<mac_address::MacAddress> {for attempt in 0..=max_retries {match get_mac_address() {Ok(Some(mac)) => return Some(mac),Ok(None) => log::warn!("未找到 MAC 地址 (尝试 {}/{})", attempt + 1, max_retries),Err(e) => log::error!("获取失败: {} (尝试 {}/{})", e, attempt + 1, max_retries),}if attempt < max_retries {thread::sleep(Duration::from_secs(1));}}None
}
📊 MAC 地址实用函数
1. 验证 MAC 地址格式
fn is_valid_mac(mac: &str) -> bool {let parts: Vec<&str> = mac.split(':').collect();parts.len() == 6 && parts.iter().all(|p| p.len() == 2 && p.chars().all(|c| c.is_ascii_hexdigit()))
}fn main() {println!("AA:BB:CC:DD:EE:FF 是否有效? {}", is_valid_mac("AA:BB:CC:DD:EE:FF"));println!("无效MAC是否有效? {}", is_valid_mac("GG:HH:II:JJ:KK:LL"));
}
2. MAC 地址转换
fn mac_to_bytes(mac: &str) -> Option<[u8; 6]> {let parts: Vec<&str> = mac.split(':').collect();if parts.len() != 6 {return None;}let mut bytes = [0u8; 6];for (i, part) in parts.iter().enumerate() {bytes[i] = u8::from_str_radix(part, 16).ok()?;}Some(bytes)
}fn bytes_to_mac(bytes: &[u8; 6]) -> String {bytes.iter().map(|b| format!("{:02X}", b)).collect::<Vec<_>>().join(":")
}
📝 完整示例：系统信息工具
use mac_address::{get_mac_address, get_mac_addresses};
use sysinfo::{System, SystemExt};fn main() {let mut sys = System::new_all();sys.refresh_all();println!("系统信息:");println!("操作系统: {}", sys.name().unwrap_or_default());println!("内核版本: {}", sys.kernel_version().unwrap_or_default());println!("主机名: {}", sys.host_name().unwrap_or_default());match get_mac_address() {Ok(Some(mac)) => {println!("主 MAC 地址: {}", mac);}_ => println!("无法获取 MAC 地址"),}println!("\n所有网络接口:");for interface in sys.networks().iter() {println!("接口: {}", interface.0);println!(" IP地址: {:?}", interface.1.addresses);println!(" 接收数据: {} MB", interface.1.total_received() / 1024 / 1024);println!(" 发送数据: {} MB", interface.1.total_transmitted() / 1024 / 1024);if let Ok(Some(mac)) = mac_address_by_name(interface.0) {println!(" MAC地址: {}", mac);}}
}
⚠️ 注意事项
-
权限要求：
- Linux/macOS：需要 root 权限或 CAP_NET_ADMIN 能力
- Windows：普通用户权限通常足够
-
虚拟接口：
- 虚拟接口（如 Docker、VPN）也会有 MAC 地址
- 可能需要过滤掉非物理接口
-
隐私考虑：
- MAC 地址是敏感信息
- 遵守 GDPR 等隐私法规
- 必要时进行哈希处理
-
平台差异：
- macOS 的
en0通常是主接口 - Linux 的
eth0是常见物理接口 - Windows 的接口名可能包含 GUID
- macOS 的
💡 最佳实践
-
明确接口名称：
// 优先选择已知物理接口 let physical_interfaces = &["eth0", "en0", "wlan0"];for name in physical_interfaces {if let Ok(Some(mac)) = mac_address_by_name(name) {return Some(mac);} } -
错误处理：
- 处理可能的
None结果 - 记录无法获取 MAC 的原因
- 提供备用方案（如生成随机设备 ID）
- 处理可能的
-
格式化一致性：
// 统一使用大写带冒号格式 let formatted = mac.to_string().to_uppercase();
通过以上方法，您可以在 Rust 应用中可靠地获取 MAC 地址。根据目标平台和具体需求选择最合适的实现方案。