Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
docs: record browser NAT prediction preflight (#363)
AAAa741c3233d96
diff --git a/docs/research/nat-traversal.md b/docs/research/nat-traversal.mdindex 558df022..7edf4fd4 100644--- a/docs/research/nat-traversal.md+++ b/docs/research/nat-traversal.md@@ -27,6 +27,36 @@ configured, Chromium emitted one deduplicated srflx candidate. No raw address orport was retained. This proves endpoint reachability and candidatededuplication; it does not classify the NAT or prove another direct path.+## Browser Prediction Preflight++A 2026-09-01 Chrome 151 preflight repeated the combined self-hosted plus+Cloudflare STUN gathering in six fresh PeerConnections. Each STUN destination+produced an srflx candidate when tested alone, while every combined run exposed+only one deduplicated srflx endpoint. The only valid mapping result remained+`unknown`; individual reachability does not make a single combined candidate+positive evidence of EIM.++One ICE restart exposed a different srflx endpoint in that environment, and a+synthetic standards-shaped remote srflx candidate using a documentation address+was accepted by `addIceCandidate()`. The first observation proves only that a+new mapping can occur: WebRTC specifies new ICE credentials and a new gathering+phase, not a new socket or mapping on every implementation and network. The+second proves candidate syntax only; it does not prove that a predicted NAT+mapping receives an authenticated connectivity check. The probe retained no raw+address or port.++This preflight also leaves the proposed field mapper without an ordered port+delta. Candidate events expose response completion, while configured STUN order+does not specify the NAT allocation order. A Browser-only mapper may retain a+positive varies-by-destination observation and unordered port gaps, but cannot+label a signed `P + d` sequence without controlled external evidence. Trying+both signs consumes more checklist budget and still needs the same lab gate.++The full prediction gate therefore remains unrun. It requires a disposable+Linux runner with network namespaces and packet-filter authority, controlled+STUN destinations, and two real Browser ICE agents. The production host is not+that runner, and an unexecuted nftables script is not accepted evidence.+## Current DecisionDo not change the flagship STUN configuration in this phase. A second endpointdiff --git a/docs/todo.md b/docs/todo.mdindex be320189..d94e0d2d 100644--- a/docs/todo.md+++ b/docs/todo.md@@ -86,7 +86,10 @@ until their stated boundary is met.connection-scoped classifier with bounded false rejection. Do not hard-skipPeer candidates from a participant-wide NAT label or inject predicted portsinto production ICE without a new accepted decision and a measured gate. See- [Browser NAT traversal](./research/nat-traversal.md).+ [Browser NAT traversal](./research/nat-traversal.md). The Browser preflight+ proves only positive mapping variation and synthetic-candidate syntax; the+ next executable gate requires an isolated Linux namespace runner with two+ real Browser ICE agents.15. **Unresolved route-state ownership claims.** Reopen lower-revisionreauthentication, active SFU failure during an unrelated prepare, andmulti-child relay-evidence ownership only from an exact current-wire