//! 设备发现:UDP beacon(MUSIC_REMOTE_PLAN §3.3,P0 主路径)。 //! //! 电脑每 3s 向 `255.255.255.255:26123` **与各网卡的定向广播地址**发 JSON 包; //! 手机被动监听 26123 收集。beacon 不含任何敏感信息(无 token、无配对码)。 //! //! 各网卡定向广播是必须的:本机常驻 VPN/虚拟网卡(mihomo 等),默认路由可能 //! 不在 LAN 网卡上,仅发 255.255.255.255 会从默认路由出去、手机收不到(§8 风险行 //! "多网卡/VPN 虚拟网卡"的对策)。地址枚举走 `GetAdaptersAddresses`。 use std::net::{Ipv4Addr, UdpSocket}; use std::sync::atomic::{AtomicBool, Ordering}; use std::sync::Arc; use std::thread::JoinHandle; use std::time::Duration; /// 手机监听的 beacon 端口(与 LFMusic `bind :26123` 对齐)。 pub const BEACON_PORT: u16 = 26123; /// beacon 广播周期(与对端文档 §5.1"每 3s 广播"对齐)。 const BEACON_INTERVAL: Duration = Duration::from_secs(3); /// beacon 负载(§3.3)。`addrs` 供手机在多地址场景按连通性优选(§8 对策)。 #[derive(Clone, serde::Serialize)] pub struct BeaconPayload { pub service: &'static str, #[serde(rename = "deviceId")] pub device_id: String, pub name: String, pub port: u16, #[serde(rename = "protoVer")] pub proto_ver: u32, /// 本机各网卡 IPv4(去重、去回环、去 169.254 链路本地) pub addrs: Vec, } /// 枚举本机可用的 IPv4 与对应定向广播地址(网段广播,prefix<32 才有)。 /// /// 失败时返回空(beacon 退化为只发 255.255.255.255,不阻断启动)。 #[cfg(windows)] pub fn ipv4_broadcast_pairs() -> Vec<(Ipv4Addr, Ipv4Addr)> { use windows::Win32::NetworkManagement::IpHelper::{ GAA_FLAG_INCLUDE_PREFIX, GAA_FLAG_SKIP_ANYCAST, GAA_FLAG_SKIP_DNS_SERVER, GAA_FLAG_SKIP_MULTICAST, GetAdaptersAddresses, IP_ADAPTER_ADDRESSES_LH, IP_ADAPTER_UNICAST_ADDRESS_LH, }; use windows::Win32::Networking::WinSock::{AF_INET, SOCKADDR_IN}; let mut out: Vec<(Ipv4Addr, Ipv4Addr)> = Vec::new(); unsafe { let mut size: u32 = 0; let flags = GAA_FLAG_INCLUDE_PREFIX | GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_DNS_SERVER; // 第一次调用只探长度(返回 ERROR_BUFFER_OVERFLOW = 111) let _ = GetAdaptersAddresses(AF_INET.0 as u32, flags, None, None, &mut size); if size == 0 { return out; } let mut buf = vec![0u8; size as usize]; let ptr = buf.as_mut_ptr() as *mut IP_ADAPTER_ADDRESSES_LH; let ret = GetAdaptersAddresses(AF_INET.0 as u32, flags, None, Some(ptr), &mut size); if ret != 0 { crate::logger::log_warn( "music-remote", &format!("GetAdaptersAddresses 失败: {ret}(beacon 退化为受限广播)"), ); return out; } let mut adapter = (*ptr).FirstUnicastAddress; while !adapter.is_null() { let ua: *mut IP_ADAPTER_UNICAST_ADDRESS_LH = adapter; let sa = (*ua).Address; let sockaddr = sa.lpSockaddr as *const SOCKADDR_IN; if !sockaddr.is_null() { let raw = u32::from_be((*sockaddr).sin_addr.S_un.S_addr); let ip = Ipv4Addr::from(raw); // 跳过回环与链路本地(APIPA) if !ip.is_loopback() && !ip.is_link_local() { let prefix = (*ua).OnLinkPrefixLength.min(32); if prefix == 0 { out.push((ip, Ipv4Addr::BROADCAST)); } else { let mask = u32::MAX << (32 - prefix); let bcast = Ipv4Addr::from(raw | !mask); if bcast != ip && !bcast.is_loopback() { out.push((ip, bcast)); } else { out.push((ip, Ipv4Addr::BROADCAST)); } } } } adapter = (*ua).Next; } } // 去重(多网卡同地址 / 多地址同广播) let mut seen = std::collections::HashSet::new(); out.retain(|p| seen.insert(*p)); out } #[cfg(not(windows))] pub fn ipv4_broadcast_pairs() -> Vec<(Ipv4Addr, Ipv4Addr)> { Vec::new() } /// 取一个适合放进二维码 payload 的本机 LAN IP(首个非链路本地 IPv4)。 pub fn primary_ipv4() -> Option { ipv4_broadcast_pairs() .into_iter() .map(|(ip, _)| ip) .find(|ip| !ip.is_loopback() && !ip.is_link_local()) } /// 启动 beacon 广播线程;`shutdown` 置 true 后最迟一个周期内退出。 pub fn spawn_beacon(payload: BeaconPayload, shutdown: Arc) -> JoinHandle<()> { std::thread::Builder::new() .name("remote-beacon".to_string()) .spawn(move || { let sock = match UdpSocket::bind("0.0.0.0:0") { Ok(s) => s, Err(e) => { crate::logger::log_error( "music-remote", &format!("beacon 套接字绑定失败: {e}"), ); return; } }; let _ = sock.set_broadcast(true); let json = serde_json::to_string(&payload).unwrap_or_default(); let bytes = json.as_bytes(); crate::logger::log_info( "music-remote", &format!( "beacon 已启动 → :{BEACON_PORT},addrs={:?},payload={json}", payload.addrs ), ); while !shutdown.load(Ordering::Relaxed) { // 受限广播(默认路由 NIC) let _ = sock.send_to(bytes, ("255.255.255.255", BEACON_PORT)); // 各网卡定向广播(VPN/多网卡场景的保底路径) for (_, bcast) in ipv4_broadcast_pairs() { let _ = sock.send_to(bytes, (bcast, BEACON_PORT)); } for _ in 0..(BEACON_INTERVAL.as_millis() / 100).max(1) { if shutdown.load(Ordering::Relaxed) { break; } std::thread::sleep(Duration::from_millis(100)); } } crate::logger::log_info("music-remote", "beacon 已停止"); }) .expect("创建 beacon 线程失败") } #[cfg(test)] mod tests { use super::*; #[test] fn payload_shape_matches_phone_expectation() { let p = BeaconPayload { service: "thing-music", device_id: "d1".into(), name: "Thing".into(), port: 26124, proto_ver: 1, addrs: vec!["192.168.1.5".into()], }; let json = serde_json::to_string(&p).unwrap(); // 手机端按 service 过滤、按 deviceId 去重(LFMusic §5.1) assert!(json.contains("\"service\":\"thing-music\"")); assert!(json.contains("\"deviceId\":\"d1\"")); assert!(json.contains("\"protoVer\":1")); assert!(json.contains("\"port\":26124")); } }