SSR + strict CSP for cached pages: let hydration data be inert so inline-script hashes are build-time constants (and streaming works under a hash-based CSP)
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 8/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- html, javascript, typescript
调研方向
This is a design proposal with no maintainer response yet, so decide scope with maintainers before coding. Start by reading the inline-script constants (REPLACE_SCRIPT, HEAD_SCRIPT, HydrationScript) and the renderToStream / renderToString entry points the issue names. Done means a failing test that shows which inline scripts change between renders, as the issue's first deliverable.
由索引模型根据 Issue 内容生成。
描述
Problem. We run a Solid 2 storefront (rc.13, @solidjs/vite-plugin start mode) behind a
shared CDN cache, with a CSP that has no 'unsafe-inline'. Three facts collide:
- A nonce is unusable on a cached page. The stored response publishes its CSP header and its
<script nonce>attributes together, to every later visitor, for the whole cache lifetime. The
published constant becomes the grant. SvelteKit forbids nonces on prerendered pages for the
same reason, and Next.js documents that nonces force dynamic rendering and disable static, ISR
and CDN caching. - Hashes are the remaining mechanism, but Solid's inline scripts cannot be hashed ahead of
time.- Every script that carries hydration data is per render: the seroval cross-reference header,
the stub batch, the resolutions,$df("k"), head ops,window.location=. - The constant runtimes (
REPLACE_SCRIPT,HEAD_SCRIPT, seroval's promise-resolver factory)
are concatenated into the same element as that data. - Only
HydrationScriptis a standalone constant.
So a host must render, re-read the finished body, and hash the scripts. That only works with
the async render mode, where the head is sent after the body.
- Every script that carries hydration data is per render: the seroval cross-reference header,
- Streaming is impossible under a hash-based CSP. The header is gone before the late scripts
exist.
A side effect we measured: in async mode, the order of the resolution chunks (and their $R ids)
follows the order in which async sources settle. Identical data with different API latency gives
different bytes (12 renders, 2 variants), so a body-digest ETag misses revalidations that should
be 304s.
Proposals, ranked.
- Inert hydration data plus constant executable code (opt-in, for example
renderToStream(…, { dataMode: 'json' })):- Write every serialized record as
<script type="application/json" data-hy>using the JSON
codec@solidjs/web/serializationalready ships (createJSONSerializer/
createJSONDataTable). - Keep all executable bytes constant per build: the runtime in its own
<script>, or an
external module, and a fixed pump such as<script>_$HY.p()</script>after each flush. - Make the late redirect a
<meta http-equiv="refresh">or a data record. - Two details to handle: the decoder must stamp
p.s/p.von settled promises, as
PROMISE_SUCCESSdoes today, since hydration reads them synchronously; and seroval's
cross-JSON already resolves out-of-order promise nodes by id.
Result: CSP hashes are build-time constants (a static header, no body re-parse), and streaming
SSR works under a strict, hash-only CSP. The cost from our measurement is about 5% larger
payloads after compression and slower decode (0.7 vs 0.1 ms for a 120-product payload on a
laptop).
- Write every serialized record as
- Interim, small: the renderer records the SHA-256 of every inline script it writes and
exposes the set on the settled result (or the request event), for hosts that render in async
mode or withrenderToString. Authored<script>in JSX stays the app's job, since the
compiler bakes it into the template. - Determinism: in async mode, emit resolutions in a stable order (for example, by
serialization key at flush) rather than in settle order, so identical data gives identical
bytes.
Prior art.
- SvelteKit:
csp.mode: 'hash' | 'nonce' | 'auto'. The framework adds hashes or nonces for
the inline scripts and styles it generates.autouses hashes for prerendered pages and nonces
for dynamic ones, and "using nonces with prerendered pages is insecure and therefore forbidden". - Astro 6:
security.cspcomputes SHA-256 hashes of the page's scripts and styles and emits
them in a<meta http-equiv>policy. - Next.js: nonces only for inline scripts, which require dynamic rendering. Experimental SRI
covers external files only. - React Router / Remix and Qwik: nonce props only.
- SolidStart v2 already moved server-function payloads to seroval's JSON mode by default
(solid-start#2042, after #1825).
What we would contribute.
- A failing test for each claim above: the per-render inventory, and the settle-order variance.
- A prototype of (1) behind an option: the serializer switch, the pump and the decoder wrapper
that stampss/v. - Size and decode benchmarks on a real catalogue page.
- The docs section on running Solid behind a shared cache with a strict CSP.
We are happy to start with (2) or (3) if (1) is too large for 2.0.
- 主要语言
- TypeScript
- 星标
- 36.1k
- 派生
- 1.1k
- 平均合并
- 10 小时 41 分钟
- 30 天内合并 PR
- 363
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
solidjs/solid 的其他 Issue
-
难度 3/5 半天 新手友好度 55/100
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 30/100
维护者通常 1 天内回复
-
难度 3/5 半天 新手友好度 45/100
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 35/100
维护者通常 1 天内回复
-
signals: a landing reveals a held write its stale reader re-derives onto a new flight (U-5, D-9)未关闭
难度 5/5 一周以上 新手友好度 12/100
维护者通常 1 天内回复
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 72/100
wormhole-foundation/wormhole#5062 ·
维护者通常 1 天内回复
-
internal os specific
难度 2/5 1-3 小时 新手友好度 65/100
frostney/GocciaScript#1688 ·
维护者通常 1 天内回复
-
integration:hermes
难度 2/5 1-3 小时 新手友好度 70/100
vectorize-io/hindsight#5592 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 72/100
vercel/streamdown#673 · 1 个 reaction ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 74/100
apache/rocketmq-dashboard#6712 ·
维护者通常 3 天内回复