鉴权并入 Auth Broker：委派设备会话统一模型 + 四端迁移

后端（委托 Auth Broker，路径 A）： - 删自建鉴权（OIDC exchange / 自签会话 / step-up / shortcut / web_sessions / accounts），cdrop 不再存任何凭证；鉴权中间件改读边缘注入的 X-Auth-Subject/Scope/Meta/Name/Roles 头（dev 旁路保留）；Claims 加 Tier() / Guest() - internal/brokerclient：mint / revoke（带 X-Broker-App）/ refresh / ListSessions（R1 列举），直连内网、吊销幂等统一会话模型“委派设备会话”（Delegated Device Sessions）： - 每个客户端（浏览器 / 桌面 / 扫码设备）＝一条带 meta(device_id) + label 的 broker 机器会话；Broker 作设备会话唯一注册表（R1 按用户＋app 列举 + R2 按 (user,app,meta) 幂等铸造），cdrop 退化为薄覆盖层、不再自存权威会话表 - 新增代铸端点 POST /api/auth/device-session：凭边缘已验明的 X-Auth-Subject 委托 broker 铸 / 轮换设备会话（meta=device_id、按调用方 tier 防越权、sameOrigin CSRF、per-IP 限流）；R2 幂等保证同一 device_id 重登原地轮换、不堆重复设备 - 会话列表＝R1 权威 + 叠加 type（本地缓存）/ online（Hub presence，按设备名）/ current（meta 匹配本请求 X-Auth-Meta）+ 过滤 meta=""（device-authorize 引导会话残留）；devices 表降级为 type/presence 薄缓存（非会话权威），device_id 主键、upsert 按 user 限定 - 吊销按 device_id → 缓存优先 / R1 兜底解析 sid → broker 吊销 + X-Broker-App；扫码登录保留三密钥编排，collect 改委托 broker 铸 + 落缓存行 Web 前端： - 登录走 broker 全局 SSO 代跳（/api/auth/login 302）；bootstrap 经 /api/me 注入身份后代铸设备会话（稳定 device_id 存 localStorage、Web Locks 跨 tab 串行防重复铸造）；refresh 走 /api/auth/refresh - 设备管理按 device_id；改名＝同 device_id 重代铸（R2 原地轮换换 label、不产生重复行）；登录页反应式守卫修登录回环 - 去 OIDC PKCE / step-up（删 oauth.callback / stepUp）桌面客户端（Wails）： - loopback PKCE（RFC 8252）改指 broker 设备授权流（/device/authorize + /device/token）拿引导令牌，再代铸出带 meta 的托管设备会话——与浏览器同模型、同管理、同吊销；身份取自代铸响应（修“显示名显示为 UUID”）；refresh 保留显示名；稳定 device_id 入桌面配置 iOS 客户端（arch A，原生 SwiftUI + 离屏无头 WebView 引擎 + 原生↔JS 桥）： - 引擎 / 文件管理 / 设备管理 / 应用图标 / 本地化（此前实现，随本次落入版本库） - 鉴权＝引擎自刷（boot 注入 refresh_token）+ broker 轮换经 sessionRotated 回报原生更新 Keychain；去 cookie 同步；Session 加 refreshToken / deviceId 实时 / 健壮性： - presence 走 Hub union（设备表行 ∪ 表外实时连接，按名去重、live-only 标在线） - Hub 通道 close 一律在写锁内、非阻塞 send 一律在读锁内，消除 close-vs-send 闭通道 send panic（revoke 每次 Kick 后该路径变热）配置 / 删旧栈： - config 改 broker 接入（CDROP_BROKER_* / CDROP_PUBLIC_URL / 按档 TTL），prod 强校验 broker 配置 + PUBLIC_URL（CSRF Origin 守卫不失效） - 删 auth.go / selftoken.go / shortcut.go / jwks.go + 三表（web_sessions / accounts / shortcut_tokens）及验证链；.env.example / compose.snippet.yaml / Caddyfile.snippet 更新为 broker 模型（人机分流 + 公开端点放行 + X-Auth-Meta 透传） - 测试全重写：QR / 会话含 mock broker（R1 列举 + R2 幂等）；hub 加 close-vs-send 并发回归；config 加 prod 必填校验
2026-06-26 02:07:11 +08:00
parent c79b176b87
commit 10cf36ecee
104 changed files with 7533 additions and 5318 deletions
@@ -23,6 +23,11 @@ const CHANNEL_NAME = "cdrop-file";
 const CHUNK_SIZE = 64 * 1024;
 const HIGH_WATERMARK = 16 * 1024 * 1024;
 const LOW_WATERMARK = 4 * 1024 * 1024;
+// 发送端「读写解耦」：一次读 4 MiB 进内存，再从内存切 CHUNK_SIZE 子片 dc.send。原先
+// 每 64 KiB 都 await file.slice().arrayBuffer()，逐片异步文件读在 iOS Safari 上极慢（实测
+// 直连 P2P 仅 ~250 KB/s，远低于中继 3 MB/s）。块读把异步文件读次数降 ~64 倍，SCTP 消息
+// 大小与流控（HIGH/LOW watermark）完全不变，接收端无感。
+const READ_BLOCK_SIZE = 4 * 1024 * 1024;
 const ICE_CANDIDATE_POOL = 4;

 export interface FileMeta
@@ -498,49 +503,65 @@ class Session
        // "已交付字节"随接收端实际收程平滑爬升、lastProgressAt 保持新鲜，不误报"疑似卡住"。
        this.startSendProgressPoll();

+        // 发送块大小固定 64 KiB：实测放大到 256 KiB 在 iOS Safari 上反而把吞吐打到
+        // <100 KB/s（SCTP 大消息分片/重组代价），故维持 CHUNK_SIZE。读写解耦（块读）保留。
+        const sendChunk = CHUNK_SIZE;
+
        let offset = 0;
        while (offset < file.size)
        {
-            // 预测式检查：在 send 之前看"加了这一片之后会不会撞上 HIGH"。
-            // Chrome WebRTC 的 RTCDataChannel.send 在 bufferedAmount + size 超过
-            // kMaxQueuedSendDataBytes（16 MiB）时直接抛 OperationError；我们 HIGH
-            // 也设 16 MiB，原本的 `bufferedAmount > HIGH` 检查在 buffer = HIGH - 1
-            // 时不触发，下一片就会跨过硬上限挂掉。
-            if (dc.bufferedAmount + CHUNK_SIZE > HIGH_WATERMARK)
+            // 一次读一大块进内存（异步文件读从每 64 KiB 一次降到每 4 MiB 一次）。
+            const blockEnd = Math.min(offset + READ_BLOCK_SIZE, file.size);
+            const block = new Uint8Array(await file.slice(offset, blockEnd).arrayBuffer());
+
+            // 从内存块按 sendChunk 子片发送；流控（bufferedAmount/水位）逻辑不变。
+            let inBlock = 0;
+            while (inBlock < block.byteLength)
            {
-                await waitForBufferLow(dc, LOW_WATERMARK);
-            }
-            const slice = file.slice(offset, Math.min(offset + CHUNK_SIZE, file.size));
-            const buf = await slice.arrayBuffer();
-            try
-            {
-                dc.send(buf);
-            }
-            catch (e)
-            {
-                // 兜底：极端情况下 bufferedAmount 在 await 与 send 之间漂移，仍可能
-                // 撞到 OperationError。退一步等 buffer 抽干到 LOW 再重试一次；仍失
-                // 败说明通道本身有问题，让外层 .catch 走 markServerFail。
-                if (e instanceof DOMException && e.name === "OperationError")
+                // 预测式检查：在 send 之前看"加了这一片之后会不会撞上 HIGH"。
+                // Chrome WebRTC 的 RTCDataChannel.send 在 bufferedAmount + size 超过
+                // kMaxQueuedSendDataBytes（16 MiB）时直接抛 OperationError；我们 HIGH
+                // 也设 16 MiB，原本的 `bufferedAmount > HIGH` 检查在 buffer = HIGH - 1
+                // 时不触发，下一片就会跨过硬上限挂掉。
+                if (dc.bufferedAmount + sendChunk > HIGH_WATERMARK)
                {
-                    // eslint-disable-next-line no-console
-                    console.warn("p2p send queue full, backing off then retrying", {
-                        bufferedAmount: dc.bufferedAmount,
-                        readyState: dc.readyState,
-                        bytesSent: this.bytesSent,
-                    });
                    await waitForBufferLow(dc, LOW_WATERMARK);
-                    dc.send(buf);
                }
-                else
+                const end = Math.min(inBlock + sendChunk, block.byteLength);
+                // subarray 是零拷贝视图；dc.send 接受 ArrayBufferView，只发该视图字节范围。
+                const chunk = block.subarray(inBlock, end);
+                try
                {
-                    throw e;
+                    dc.send(chunk);
                }
+                catch (e)
+                {
+                    // 兜底：极端情况下 bufferedAmount 在 await 与 send 之间漂移，仍可能
+                    // 撞到 OperationError。退一步等 buffer 抽干到 LOW 再重试一次；仍失
+                    // 败说明通道本身有问题，让外层 .catch 走 markServerFail。
+                    if (e instanceof DOMException && e.name === "OperationError")
+                    {
+                        // eslint-disable-next-line no-console
+                        console.warn("p2p send queue full, backing off then retrying", {
+                            bufferedAmount: dc.bufferedAmount,
+                            readyState: dc.readyState,
+                            bytesSent: this.bytesSent,
+                        });
+                        await waitForBufferLow(dc, LOW_WATERMARK);
+                        dc.send(chunk);
+                    }
+                    else
+                    {
+                        throw e;
+                    }
+                }
+                const sent = end - inBlock;
+                inBlock += sent;
+                offset += sent;
+                this.bytesSent = offset;
+                if (!this.firstByteSent) { this.firstByteSent = true; this.setPhase("transferring"); }
+                this.emitProgress();
            }
-            offset += buf.byteLength;
-            this.bytesSent = offset;
-            if (!this.firstByteSent) { this.firstByteSent = true; this.setPhase("transferring"); }
-            this.emitProgress();
        }

        dc.send(JSON.stringify({ type: "done" }));