feat(desktop): PC↔PC 改用连接码,一串搞定,不再单独输 IP
此前发送方要分别念/输三样东西:IP、端口、6 位配对码。现在合成一串 可口述的连接码,**地址就编在码里**,所以拿到码即可直连——不需要广播、 不需要在同一网段,只要 IP 层路由可达即可(同一路由器下的不同 VLAN / 网段正属于这种情况)。 新增 connect_code.rs - 编码:version(3) | kind(3) | 默认端口位 | 地址 | [端口] | 24bit 秘密 | CRC-8 - 按网段压缩地址:192.168.a.b 只需 2 字节,10./172.16-31. 三字节, 其余四字节,IPv6 十六字节 - Crockford Base32(去掉易混的 I/L/O/U),分组显示 - 典型 192.168.a.b:39393 → **12 个字符**,如 4849-3WT1-3ZS0 - 输入容错:大小写、分隔符、空格随意;I/L 归一为 1、O 归一为 0 接收侧 - 6 位配对码 → 3 字节秘密;UI 为**每个网卡各生成一个连接码**, 对方在哪个网段就用哪一串(虚拟网卡排后面) - 新增 pairing::local_ipv4_addresses(),按「最可能被对方看到」排序 发送侧 - 三个输入框(设备列表 / 手动 IP / 配对码)合并为**一个连接码输入框** - 边打边校验:CRC 在连接之前就能发现输错,并实时显示「将连接 http://x.x.x.x:port」 - 广播搜索降级为可选的折叠项——同网段免输码是锦上添花,不再是主路径 一个被测试抓出来的真问题 最初单字符输错的拦截率只有 96%。原因是 12 个 Base32 字符携带 60 bit 而实际只用 56 bit,末尾 4 个填充位被解码器直接丢弃,改动最后一个字符 有 1/16 概率解出完全相同的字节,CRC 根本没机会发现。加上填充位必须为 0 的校验后拦截率 >99%。 必须说清的边界 连接码解决的是「找不到对方」和「输入太繁琐」,不能凭空制造可达性。 若两台机器在 IP 层互不可达(Wi-Fi 客户端隔离、各自在不同物理网络), 任何客户端侧协议都无法建立连接,只能换链路或引入第三方中转—— 后者与 QFT「不经过外网」的定位冲突,本版不做。 验证:cargo test 30/30,含连接码往返(全部地址类型)、容错输入、 单字符输错拦截率统计、以及走完整连接码链路的端到端传输 (编码 → 解码 → 换令牌 → 9MB 并发上传 → SHA-256 比对)。
This commit is contained in:
+34
-16
@@ -90,22 +90,6 @@ impl PairingPayload {
|
||||
}
|
||||
}
|
||||
|
||||
/// 6 位数字配对码,供 PC↔PC 使用。
|
||||
///
|
||||
/// 桌面端之间没有摄像头,二维码用不上,用户只能目视或口头传递这 6 位。
|
||||
/// 用拒绝采样避免取模偏置——虽然此处偏置只有约 1e-5,但没必要留下这种脏细节。
|
||||
pub fn new_pair_code() -> String {
|
||||
let mut bytes = [0u8; 4];
|
||||
loop {
|
||||
rand::rng().fill_bytes(&mut bytes);
|
||||
let value = u32::from_be_bytes(bytes);
|
||||
// 4_294_000_000 是 1_000_000 的整数倍中不超过 u32::MAX 的最大值
|
||||
if value < 4_294_000_000 {
|
||||
return format!("{:06}", value % 1_000_000);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
pub fn new_session_token() -> String {
|
||||
let mut bytes = [0u8; 16];
|
||||
rand::rng().fill_bytes(&mut bytes);
|
||||
@@ -181,6 +165,40 @@ fn new_direct_ap_credentials(pc_name: &str) -> (String, String) {
|
||||
(ssid, password[..16.min(password.len())].to_owned())
|
||||
}
|
||||
|
||||
/// 本机可用的私有 IPv4 地址,按「最可能是对方看得到的那一个」排序。
|
||||
///
|
||||
/// 连接码把地址编进码里,所以这里的排序直接决定了用户第一眼看到的那串码
|
||||
/// 是否好用。虚拟网卡(Docker/VPN/虚拟机桥接)会排到后面。
|
||||
pub fn local_ipv4_addresses() -> Vec<Ipv4Addr> {
|
||||
let mut ips = Vec::<Ipv4Addr>::new();
|
||||
if let Ok(addrs) = if_addrs::get_if_addrs() {
|
||||
for iface in addrs {
|
||||
let IpAddr::V4(ip) = iface.ip() else { continue };
|
||||
if ip.is_loopback() || ip.is_unspecified() || ip.is_link_local() {
|
||||
continue;
|
||||
}
|
||||
if !ip.is_private() {
|
||||
continue;
|
||||
}
|
||||
if !ips.contains(&ip) {
|
||||
ips.push(ip);
|
||||
}
|
||||
}
|
||||
}
|
||||
ips.sort_by_key(|ip| {
|
||||
let o = ip.octets();
|
||||
match (o[0], o[1]) {
|
||||
// Windows 的 ICS / Wi-Fi Direct 固定网段,最可能是 QFT 自己拉起来的
|
||||
(192, 168) if o[2] == 137 || o[2] == 49 => 0,
|
||||
(192, 168) => 1,
|
||||
(10, _) => 2,
|
||||
(172, 16..=31) => 3,
|
||||
_ => 4,
|
||||
}
|
||||
});
|
||||
ips
|
||||
}
|
||||
|
||||
pub fn local_ipv4_endpoints(port: u16) -> Vec<String> {
|
||||
let mut ips = Vec::<Ipv4Addr>::new();
|
||||
if let Ok(addrs) = if_addrs::get_if_addrs() {
|
||||
|
||||
Reference in New Issue
Block a user