182 lines
7.2 KiB
Rust
182 lines
7.2 KiB
Rust
//! 设备发现: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"));
|
||
}
|
||
}
|