4d77ba6c91
三条链路: - 电脑 → iPhone:扫 QFTSEND2 码下载,流式落盘 + 增量 SHA-256, 支持 Range 断点续传 - iPhone → 电脑:扫 QFTPAIR2 码后 init/chunk/finish 并行分块上传 - iPhone ↔ iPhone:QFTP2P1 扫码握手,Network.framework 开启 includePeerToPeer(AirDrop 同款 BLE 发现 + AWDL 点对点 Wi-Fi), 两台设备不需要连同一个 Wi-Fi,也不需要路由器 P2P 用 TLS-PSK 握手:32 字节预共享密钥由发送端随机生成并写进二维码, 扫码这个动作本身完成带外密钥交换与双向认证,无需证书体系与配对弹窗。 未扫到码的第三方连上来过不了握手。 核心层刻意不 import UIKit,可直接以 macOS 为目标编译测试, 不需要 Xcode 也不需要模拟器,已接入主自检套件,72 项全部通过: - 端点白名单 11 种拒绝用例(域名、公网、172.32 边界、 非规范八位组、IPv6、带凭据/路径/query) - CoreTests/MockPCServer.py 严格复刻 receiver.rs / sender.rs 的线上语义 (路径、header 名、JSON 字段、Range 行为、chunk 长度校验), 构成 Swift 与 Rust 两端的线格式契约测试,任一端改协议即会失败 - 真实 TLS-PSK 握手下的 P2P 端到端传输,含错误密钥必须被拒 iOS 平台限制(已在 ios/README.md 说明): NEHotspotConfiguration 需要付费账号 entitlement,故不实现 Direct AP 流程,与电脑互传要求同一局域网;AWDL 是苹果私有链路,Windows 无法参与。 上传块固定 4 MiB 而非 Android 的 4/8/16 MiB,因为 iOS 上 worker 数 × 块大小即内存峰值。 未验证部分:本机只有 Command Line Tools,无 Xcode 与 iOS SDK, UI 层(SwiftUI/UIKit/AVFoundation)未经编译;.xcodeproj 已通过 plutil 解析与引用完整性校验(42 个对象无悬空引用), 但未在 Xcode 中实际打开过。
95 lines
3.7 KiB
Swift
95 lines
3.7 KiB
Swift
import Foundation
|
||
import Security
|
||
|
||
/// 隔空投送式点对点配对码。
|
||
///
|
||
/// 与 QFTPAIR2/QFTSEND2 的关键区别:那两个是「连到某个 IP」,
|
||
/// 这个是「连到某个 Bonjour 服务实例,并用二维码里的预共享密钥做 TLS 认证」。
|
||
/// 二维码在这里充当带外信道——和 AirDrop 用 BLE 交换身份是同一个作用,
|
||
/// 只是我们把身份交换搬到了用户可见的扫码动作上,不需要任何配对弹窗。
|
||
struct PeerPairing: Equatable {
|
||
static let prefix = "QFTP2P1:"
|
||
|
||
let version: Int
|
||
/// 32 字节预共享密钥。既是 TLS-PSK,也是服务实例的唯一凭据。
|
||
let key: Data
|
||
/// Bonjour 服务实例名,由发送端随机生成
|
||
let instance: String
|
||
let senderName: String
|
||
let fileName: String
|
||
let fileSize: UInt64
|
||
let sha256: String
|
||
|
||
static let serviceType = "_qft-p2p._tcp"
|
||
|
||
func encode() -> String {
|
||
let object: [String: Any] = [
|
||
"v": version,
|
||
"k": Base64URL.encode(key),
|
||
"i": instance,
|
||
"n": senderName,
|
||
"f": fileName,
|
||
"z": NSNumber(value: fileSize),
|
||
"h": sha256,
|
||
]
|
||
let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data()
|
||
return Self.prefix + Base64URL.encode(data)
|
||
}
|
||
|
||
static func isPeerText(_ text: String) -> Bool { text.hasPrefix(prefix) }
|
||
|
||
static func parse(_ text: String) -> PeerPairing? {
|
||
guard text.hasPrefix(prefix), text.count <= 4096 else { return nil }
|
||
guard let data = Base64URL.decode(String(text.dropFirst(prefix.count))),
|
||
data.count <= 2048,
|
||
let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] else {
|
||
return nil
|
||
}
|
||
guard (object["v"] as? Int) == 1 else { return nil }
|
||
guard let keyText = object["k"] as? String,
|
||
let key = Base64URL.decode(keyText), key.count == 32 else { return nil }
|
||
guard let instance = object["i"] as? String, isValidInstance(instance) else { return nil }
|
||
guard let fileName = (object["f"] as? String)?.trimmingCharacters(in: .whitespaces),
|
||
PairingProtocol.isValidFileName(fileName) else { return nil }
|
||
guard let size = object["z"] as? NSNumber, size.int64Value >= 0 else { return nil }
|
||
guard let hash = (object["h"] as? String)?.lowercased(),
|
||
PairingProtocol.isValidSHA256(hash) else { return nil }
|
||
|
||
return PeerPairing(
|
||
version: 1,
|
||
key: key,
|
||
instance: instance,
|
||
senderName: String(((object["n"] as? String) ?? "iPhone").prefix(80)),
|
||
fileName: fileName,
|
||
fileSize: UInt64(size.int64Value),
|
||
sha256: hash
|
||
)
|
||
}
|
||
|
||
/// Bonjour 实例名:只允许我们自己生成的字符集,避免把任意字符串
|
||
/// 交给 mDNS 解析。
|
||
static func isValidInstance(_ value: String) -> Bool {
|
||
guard (8...48).contains(value.count) else { return false }
|
||
for scalar in value.unicodeScalars {
|
||
switch scalar {
|
||
case "A"..."Z", "a"..."z", "0"..."9", "-": continue
|
||
default: return false
|
||
}
|
||
}
|
||
return true
|
||
}
|
||
|
||
static func newKey() -> Data {
|
||
var bytes = [UInt8](repeating: 0, count: 32)
|
||
_ = SecRandomCopyBytes(kSecRandomDefault, bytes.count, &bytes)
|
||
return Data(bytes)
|
||
}
|
||
|
||
static func newInstance() -> String {
|
||
let alphabet = Array("abcdefghijklmnopqrstuvwxyz0123456789")
|
||
var bytes = [UInt8](repeating: 0, count: 16)
|
||
_ = SecRandomCopyBytes(kSecRandomDefault, bytes.count, &bytes)
|
||
return "qft-" + String(bytes.map { alphabet[Int($0) % alphabet.count] })
|
||
}
|
||
}
|