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 中实际打开过。
242 lines
8.7 KiB
Python
242 lines
8.7 KiB
Python
#!/usr/bin/env python3
|
|
"""按 windows/src/{sender,receiver}.rs 的线上语义实现的假电脑端。
|
|
|
|
存在的意义:Swift 客户端的线格式必须和 Rust 端逐字节一致,
|
|
而 Rust 端在这台机器上编译不了。这个 mock 把两端的契约固定下来,
|
|
任何一边改了 header 名、路径或 JSON 字段,集成测试都会红。
|
|
|
|
用法:
|
|
python3 MockPCServer.py --token <session> --serve <文件> --save-dir <目录> --port 0
|
|
启动后在 stdout 打印一行 `READY <port>`,供测试脚本读取。
|
|
"""
|
|
|
|
import argparse
|
|
import base64
|
|
import hashlib
|
|
import json
|
|
import os
|
|
import socket
|
|
import sys
|
|
import threading
|
|
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
|
|
|
|
STATE = {}
|
|
|
|
|
|
def b64url_decode(text):
|
|
padding = "=" * (-len(text) % 4)
|
|
return base64.urlsafe_b64decode(text + padding)
|
|
|
|
|
|
def b64url_encode(data):
|
|
return base64.urlsafe_b64encode(data).decode("ascii").rstrip("=")
|
|
|
|
|
|
class Handler(BaseHTTPRequestHandler):
|
|
protocol_version = "HTTP/1.1"
|
|
|
|
def log_message(self, *_args):
|
|
pass
|
|
|
|
# -------------------------------------------------- 工具
|
|
|
|
def _json(self, code, payload):
|
|
body = json.dumps(payload).encode("utf-8")
|
|
self.send_response(code)
|
|
self.send_header("Content-Type", "application/json")
|
|
self.send_header("Content-Length", str(len(body)))
|
|
self.send_header("Connection", "close")
|
|
self.end_headers()
|
|
self.wfile.write(body)
|
|
|
|
def _authorized(self):
|
|
if self.headers.get("X-QFT-Token") != STATE["token"]:
|
|
self.send_response(403)
|
|
self.send_header("Content-Length", "0")
|
|
self.send_header("Connection", "close")
|
|
self.end_headers()
|
|
return False
|
|
# 设备名必须是 base64url,解不出来说明客户端编码错了
|
|
device = self.headers.get("X-QFT-Device")
|
|
if device is not None:
|
|
b64url_decode(device).decode("utf-8")
|
|
return True
|
|
|
|
# -------------------------------------------------- GET
|
|
|
|
def do_GET(self):
|
|
if not self._authorized():
|
|
return
|
|
if self.path == "/qft/ping":
|
|
return self._json(200, {"ok": True, "protocol": 2, "parallel": True})
|
|
if self.path == "/qft/download":
|
|
return self._download()
|
|
return self._json(404, {"ok": False})
|
|
|
|
def _download(self):
|
|
path = STATE["serve"]
|
|
size = os.path.getsize(path)
|
|
offset = 0
|
|
header = self.headers.get("Range")
|
|
if header:
|
|
assert header.startswith("bytes="), "只支持 bytes= 形式的 Range"
|
|
assert header.endswith("-"), "sender.rs 只支持单段开区间 Range"
|
|
offset = int(header[len("bytes="):-1])
|
|
assert 0 <= offset < size, "Range 越界"
|
|
remaining = size - offset
|
|
|
|
self.send_response(206 if offset else 200)
|
|
self.send_header("Content-Type", "application/octet-stream")
|
|
self.send_header("Content-Length", str(remaining))
|
|
self.send_header("Accept-Ranges", "bytes")
|
|
if offset:
|
|
self.send_header("Content-Range", "bytes %d-%d/%d" % (offset, size - 1, size))
|
|
self.send_header("X-QFT-Filename", b64url_encode(os.path.basename(path).encode("utf-8")))
|
|
self.send_header("Connection", "close")
|
|
self.end_headers()
|
|
with open(path, "rb") as fh:
|
|
fh.seek(offset)
|
|
while True:
|
|
block = fh.read(256 * 1024)
|
|
if not block:
|
|
break
|
|
self.wfile.write(block)
|
|
|
|
# -------------------------------------------------- POST
|
|
|
|
def do_POST(self):
|
|
if not self._authorized():
|
|
return
|
|
if self.path == "/qft/upload/init":
|
|
return self._upload_init()
|
|
if self.path.startswith("/qft/upload/chunk/"):
|
|
return self._upload_chunk()
|
|
if self.path.startswith("/qft/upload/finish/"):
|
|
return self._upload_finish()
|
|
return self._json(404, {"ok": False})
|
|
|
|
def _upload_init(self):
|
|
name = b64url_decode(self.headers["X-QFT-Filename"]).decode("utf-8")
|
|
size = int(self.headers["X-QFT-Size"])
|
|
chunk_size = int(self.headers.get("X-QFT-Chunk-Size", 8 * 1024 * 1024))
|
|
chunk_size = max(1024 * 1024, min(16 * 1024 * 1024, chunk_size))
|
|
total = 0 if size == 0 else (size + chunk_size - 1) // chunk_size
|
|
|
|
upload_id = base64.urlsafe_b64encode(os.urandom(9)).decode("ascii").rstrip("=")
|
|
part = os.path.join(STATE["save_dir"], "%s.%s.qftpart" % (name, upload_id))
|
|
with open(part, "wb") as fh:
|
|
fh.truncate(size)
|
|
STATE["uploads"][upload_id] = {
|
|
"name": name, "size": size, "chunk_size": chunk_size,
|
|
"total": total, "part": part, "received": [False] * total,
|
|
"lock": threading.Lock(),
|
|
}
|
|
return self._json(200, {"ok": True, "upload_id": upload_id,
|
|
"chunk_size": chunk_size, "total_chunks": total})
|
|
|
|
def _upload_chunk(self):
|
|
suffix = self.path[len("/qft/upload/chunk/"):]
|
|
upload_id, _, index_text = suffix.partition("/")
|
|
index = int(index_text)
|
|
session = STATE["uploads"].get(upload_id)
|
|
if session is None:
|
|
return self._json(500, {"ok": False, "error": "unknown upload"})
|
|
|
|
length = int(self.headers["Content-Length"])
|
|
offset = index * session["chunk_size"]
|
|
expected = min(session["chunk_size"], session["size"] - offset)
|
|
assert length == expected, "chunk 长度不匹配:%d != %d" % (length, expected)
|
|
|
|
body = b""
|
|
while len(body) < length:
|
|
block = self.rfile.read(length - len(body))
|
|
if not block:
|
|
break
|
|
body += block
|
|
assert len(body) == length, "chunk 体不完整"
|
|
|
|
with session["lock"]:
|
|
if session["received"][index]:
|
|
return self._json(200, {"ok": True, "duplicate": True})
|
|
with open(session["part"], "r+b") as fh:
|
|
fh.seek(offset)
|
|
fh.write(body)
|
|
session["received"][index] = True
|
|
return self._json(200, {"ok": True})
|
|
|
|
def _upload_finish(self):
|
|
upload_id = self.path[len("/qft/upload/finish/"):]
|
|
session = STATE["uploads"].get(upload_id)
|
|
if session is None:
|
|
return self._json(500, {"ok": False, "error": "unknown upload"})
|
|
missing = session["received"].count(False)
|
|
if missing:
|
|
return self._json(409, {"ok": False, "missing": missing})
|
|
|
|
digest = hashlib.sha256()
|
|
with open(session["part"], "rb") as fh:
|
|
while True:
|
|
block = fh.read(1024 * 1024)
|
|
if not block:
|
|
break
|
|
digest.update(block)
|
|
final = os.path.join(STATE["save_dir"], session["name"])
|
|
os.replace(session["part"], final)
|
|
del STATE["uploads"][upload_id]
|
|
return self._json(200, {"ok": True, "sha256": digest.hexdigest(), "size": session["size"]})
|
|
|
|
|
|
def udp_responder(token, http_port, stop):
|
|
"""QFTDISC2:<token> → QFTHERE2:<token>:<port>,对应 sender.rs 的发现线程。"""
|
|
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
|
|
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
|
|
try:
|
|
sock.bind(("0.0.0.0", 39392))
|
|
except OSError:
|
|
return
|
|
sock.settimeout(0.25)
|
|
expected = ("QFTDISC2:%s" % token).encode("ascii")
|
|
reply = ("QFTHERE2:%s:%d" % (token, http_port)).encode("ascii")
|
|
while not stop.is_set():
|
|
try:
|
|
data, peer = sock.recvfrom(512)
|
|
except socket.timeout:
|
|
continue
|
|
except OSError:
|
|
break
|
|
if data == expected:
|
|
sock.sendto(reply, peer)
|
|
sock.close()
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser()
|
|
parser.add_argument("--token", required=True)
|
|
parser.add_argument("--serve", required=True, help="供 /qft/download 下发的文件")
|
|
parser.add_argument("--save-dir", required=True, help="接收上传的目录")
|
|
parser.add_argument("--port", type=int, default=0)
|
|
parser.add_argument("--udp", action="store_true", help="同时启动 UDP 发现应答")
|
|
args = parser.parse_args()
|
|
|
|
STATE.update(token=args.token, serve=args.serve, save_dir=args.save_dir, uploads={})
|
|
os.makedirs(args.save_dir, exist_ok=True)
|
|
|
|
server = ThreadingHTTPServer(("127.0.0.1", args.port), Handler)
|
|
port = server.server_address[1]
|
|
|
|
stop = threading.Event()
|
|
if args.udp:
|
|
threading.Thread(target=udp_responder, args=(args.token, port, stop), daemon=True).start()
|
|
|
|
print("READY %d" % port, flush=True)
|
|
try:
|
|
server.serve_forever()
|
|
except KeyboardInterrupt:
|
|
pass
|
|
finally:
|
|
stop.set()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|