Files
Thing/src-tauri/src/music/remote/discovery.rs
T
2026-09-28 00:21:12 +08:00

182 lines
7.2 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 设备发现: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<String>,
}
/// 枚举本机可用的 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<Ipv4Addr> {
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<AtomicBool>) -> 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"));
}
}