Skip to content

armgit / Piik

Public Imported from GitHub
0

Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

docs: record site-access flagship deployment (#101)

AAA39b3415d8e06
diff --git a/docs/deployment.md b/docs/deployment.md
index 629a85c6..a3a5a523 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -20,15 +20,18 @@ tracked coturn example remains `stun-only`; the shared host retains its older
authenticated-relay daemon configuration and firewall range. The application
does not pre-advertise TURN credentials to ordinary peers.
-Production currently runs exact `c27df2235ecc0be17816f642ca49028e30380a34`
+Production currently runs exact `5e4a3679076a9ea2fe7a41fadf4be65a439db450`
on the existing shared public IP, with local/public health 200 and SQLite v3
-integrity. The 912,999-byte artifact has SHA-256
-`1c7f06e2608414f0a4facf8577c8b49a8fefb831e20826c0e23fa0d1e85240d6`.
-The 2026-08-20T19:03:10Z UTC cutover held the deployment lock for 662 ms;
-local health returned 552 ms after service stop (543 ms after the symlink
+integrity. The 909,974-byte artifact has SHA-256
+`e484773c7dc381e657da18720e842c3ae90ad727320a650abcb1098428c74774`.
+The 2026-08-20T20:11:20Z UTC cutover held the deployment lock for 9,474 ms;
+local health returned 676 ms after service stop (529 ms after the symlink
switch). Screener, LiveKit, coturn, and nginx are active/running with
`NRestarts=0`. SQLite v3 contains five rooms including room `1`, with the
-service owner/mode preserved. Exact `cf149df2411798cd632cc92a562b0a35146e0c1b`
+service owner/mode and database hash preserved. `SITE_ACCESS_PASSWORD`,
+`/api/site-access`, and the nginx limiter replaced their retired Host-admission
+names in the same lock-held cutover; the old endpoint returns 404. Exact
+`c27df2235ecc0be17816f642ca49028e30380a34`
is the immediate rollback target.
The selected-edge UDP tuple is configured with TTL 120, but no real TURN/SFU
media canary was triggered; this remains a bounded configuration smoke, not
diff --git a/docs/project-memory.md b/docs/project-memory.md
index a179238a..32e2e101 100644
--- a/docs/project-memory.md
+++ b/docs/project-memory.md
@@ -43,10 +43,10 @@ Last updated: 2026-08-21
## Current Implementation
- The repository is one npm package using Node.js 24, React, TypeScript, Vite, native WebRTC, `ws`, Zod, Vitest, and separate coturn.
-- Production serves exact `c27df2235ecc0be17816f642ca49028e30380a34` at `https://share.bonfire.icu`. The immutable artifact is 912,999 bytes with SHA-256 `1c7f06e2608414f0a4facf8577c8b49a8fefb831e20826c0e23fa0d1e85240d6`; the 2026-08-20T19:03:10Z UTC cutover held the deployment lock for 662 ms and reached local health in 552 ms from stop (543 ms from symlink switch). Exact `cf149df2411798cd632cc92a562b0a35146e0c1b` is the immediate rollback release.
+- Production serves exact `5e4a3679076a9ea2fe7a41fadf4be65a439db450` at `https://share.bonfire.icu`. The immutable artifact is 909,974 bytes with SHA-256 `e484773c7dc381e657da18720e842c3ae90ad727320a650abcb1098428c74774`; the 2026-08-20T20:11:20Z UTC cutover held the deployment lock for 9,474 ms and reached local health in 676 ms from stop (529 ms from symlink switch). Exact `c27df2235ecc0be17816f642ca49028e30380a34` is the immediate rollback release.
- The current Screener, LiveKit, coturn, and nginx services are active/running with `NRestarts=0`; local and public health are 200. SQLite v3 is intact with five rooms including room `1`, and the DB owner/mode remain `screener:screener`/0600.
- Production ICE remains ordinary STUN-only. `PEER_ASSISTED_MEDIA=true` enables the controller for every normal room, and selected-edge TURN is now configured for the single UDP tuple with TTL 120; the coturn daemon and nginx/LiveKit/firewall/listener baselines were unchanged. No real TURN/SFU media canary or quality claim is implied.
-- The current source requires the independent site-access secret through `SITE_ACCESS_PASSWORD`. Its stateless cookie authorizes creation/Host and permits code-only Viewer attempts; valid private fragment grants remain direct. Public-watch accepts site access plus code, while private code-only entry additionally requires the room password. The atomic boundary and naming migration are not yet deployed; anonymous failures stay neutral, and there are no accounts/JWT/session rows.
+- Production requires the independent site-access secret through `SITE_ACCESS_PASSWORD`. Its stateless cookie authorizes creation/Host and permits code-only Viewer attempts; valid private fragment grants remain direct. Public-watch accepts site access plus code, while private code-only entry additionally requires the room password. The env, endpoint, cookie, and nginx limiter naming migrated atomically; anonymous failures stay neutral, and there are no accounts/JWT/session rows.
- Production uses nginx, Node.js 24.19.0, coturn 4.17.2, and LiveKit 1.13.5 on UDP 7882 (TCP fallback off). Ordinary peer ICE receives no TURN; the selected-edge tuple is configured only for the current controller edge, with no credential pre-advertised to ordinary peers. Coturn retains the old authenticated-relay ports. Services are healthy with zero restarts.
- ADR-0005 source rejects `PEER_ASSISTED_ROOM_IDS`; `PEER_ASSISTED_MEDIA=true` enables every room, while ordinary peer ICE stays STUN-only. A stale room-ID variable fails startup. `screener-v2` is the only deployed signaling literal; there is no v1 parser or translator.
- Chrome 151/LiveKit localhost A/B cut failure-to-active/render from 1.481/2.257 seconds to 0.200/0.320; 31 new frames and 25 ms sampling kept host edges at two. It is headless synthetic 720p30 and includes SDK/network prewarm, not public-network evidence.
diff --git a/docs/status.md b/docs/status.md
index 02eb7afd..82bd7e66 100644
--- a/docs/status.md
+++ b/docs/status.md
@@ -4,8 +4,8 @@ Last updated: 2026-08-21
## Phase
-`https://share.bonfire.icu` serves exact `c27df2235ecc0be17816f642ca49028e30380a34`; the 912,999-byte artifact SHA-256 is `1c7f06e2608414f0a4facf8577c8b49a8fefb831e20826c0e23fa0d1e85240d6`.
-The cutover held the lock 662 ms and returned local health 552 ms after stop. SQLite v3 has five rooms; Screener, LiveKit, coturn and nginx are healthy with zero restarts.
+`https://share.bonfire.icu` serves exact `5e4a3679076a9ea2fe7a41fadf4be65a439db450`; the 909,974-byte artifact SHA-256 is `e484773c7dc381e657da18720e842c3ae90ad727320a650abcb1098428c74774`.
+The cutover held the lock 9,474 ms and returned local health 676 ms after stop. SQLite v3 has five rooms; Screener, LiveKit, coturn and nginx are healthy with zero restarts.
Ordinary ICE is STUN-only; all rooms use the bounded peer/SFU-UDP controller and selected-edge UDP TTL 120. Room `1` is historical smoke and no real TURN/SFU media canary has run.
Web Host names/audio hint are deployed. Native H.264 and Windows x64 packaging are source-only; Web defaults VP8.
@@ -16,7 +16,7 @@ Flagship; parallel; min run/smoke/rollback; benchmark later. Active UI/config/lo
## Current Snapshot
- Capture precedes room creation; source/quality changes preserve peers and pause keeps audio/connections. Quality defaults to `maintain-resolution` with balanced/fluid options.
-- Production access is `screener-v2`: a valid private fragment grant enters directly; every code-only Viewer must first hold site access, after which public-watch accepts the code and private rooms still require their room password. The source fix and atomic `SITE_ACCESS_PASSWORD`/`/api/site-access`/site-access-cookie rename are not deployed; raw credentials are never stored.
+- Production access is `screener-v2`: a valid private fragment grant enters directly; every code-only Viewer must first hold site access, after which public-watch accepts the code and private rooms still require their room password. `SITE_ACCESS_PASSWORD`, `/api/site-access`, and the site-access cookie are deployed atomically; raw credentials are never stored.
- Web Hosts can set their local/session display name, and the current release advertises it through the existing presence wire. The name is not an account identity.
- Native v2 remains source-only (memory rooms, 300s reclaim); production does not run it.
- PR #44's STUN-only/SFU-UDP router and token-free fallback prewarm are process-enabled for all normal rooms: roots <=2, browser relay <=1, bounded failure. Room `1` is historical smoke; mobile/iPad viewers are leaves, healthy edges sticky, and HTTPS/WSS stays TLS/TCP.
@@ -35,7 +35,7 @@ Flagship; parallel; min run/smoke/rollback; benchmark later. Active UI/config/lo
- Access protocol/config/HTTP/storage/SQLite/signaling focused tests pass, including commit-first teardown and v1 rollback.
- Source adds selected Host ingress and peer last-mile for every enabled room; focused routing/config tests pass with Peer ICE STUN-only.
- Host names, the window-audio hint, all-room routing, and all-room Host selected ingress are active; the stale restart assertion is historical only.
-- The `c27df22` gate preserved env/DB hashes, SQLite v3/five rooms/room `1`, services, and local/public health plus route/asset 200s. No TURN/SFU session ran.
+- The `5e4a367` gate preserved the SQLite hash, v3/five rooms/room `1`, selected-edge/SFU/ordinary-ICE settings, services, and local/public health plus route/asset 200s. Site access returned the unauthenticated status and the retired endpoint returned 404; no TURN/SFU session ran. Exact `c27df2235ecc0be17816f642ca49028e30380a34` is the rollback release.
## Unverified Boundaries