Skip to content

[PR] Answer /favicon.ico locally; panel declares an empty icon (#3536) | favicon.ico 探针本地自答,面板声明空图标(不再转发上游) - #3555

Closed
ranxianglei wants to merge 1 commit into
masterfrom
2026-10-17_fix-3536-favicon-fallthrough
Closed

ranxianglei wants to merge 1 commit into
masterfrom
2026-10-17_fix-3536-favicon-fallthrough

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

Closes #3536

问题

dsh 桌面版设置面板 iframe 加载时,浏览器对代理 origin 根发起 GET /favicon.ico。该路径不命中任何管理面路由,落入默认 relay,被重写 host 后转发到配置的上游 → 白耗一次上游请求 + 日志 403 噪音 + 上游 host 暴露进面板网络面板。

修法(双管齐下,两处都小)

  1. src/web/page.ts:面板 HTML head 加 <link rel="icon" href="data:,"> —— 从源头阻止浏览器发起 favicon 探针(embed 壳与独立标签页都覆盖)。
  2. src/server/admin.ts:handleAdminRoute 新增 GET /favicon.ico(含 query 形式)→ 本地 204 No Content 自答,作为兜底(先打根再重定向的时序、直接访问 origin 等场景仍可能发出探针)。204 不含任何信息,非 loopback 访问也安全(比现状「转发到上游」暴露面更小)。

明确不动:relay 的通用 fallthrough 语义——未识别路径照转是 bili 既定设计(CLIENTS.md 有载),只把这一个明确的静态资源路径钉在本地。

回归测试(tests/issue3536-favicon-local.test.ts,2/2 过)

  • 单测:renderPage 输出(embed/非 embed)含空图标声明且在 head 内;
  • 集成:真 proxy + mock 上游(模拟 Anthropic 403)——GET /favicon.ico 与 /favicon.ico?v=1 均本地 204、上游命中数 0;/__bili/?embed=1 实发 HTML 带图标声明;
  • 负向控制:GET /definitely/not/an/admin/path 仍被 relay 到 mock 上游(403 透传、命中恰好 1 次)——钉住「只有 favicon 被钉本地」,防止将来泛化成「未知路径一律本地自答」破坏 relay 设计。

行为变更披露

旧:GET /favicon.ico 落 relay 转发到配置上游(上游视角多一次无意义请求,常见结果 403)。
新:GET /favicon.ico(任意 query)→ 本地 204,不再产生任何上游请求。其他所有未识别路径行为不变(负向控制测试钉住)。

验证

  • npm run typecheck 干净;
  • 定向套件全绿:issue3536-favicon-local(2)、admin-probe + web-i18n + web-storage-banner + web-update-banner(19)、dsh-settings-ui(14);
  • 全量回归交 CI。

@github-actions

github-actions Bot commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-17_fix-3536-favicon-fallthrough (8f89ab4)

Option A — Install this exact build (recommended)

npm install -g billion-context@0.0.4221-pr.3555.6d085db

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Option B — Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr3555.tgz
npm install -g package

Install instructions are refreshed on each push.

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重: 不重复。 全仓(含 closed)按 favicon / 探针 / admin fallthrough 检索,相关条目只有本 PR 针对的原始 issue #3536;无其他 open/closed issue 或 PR 处理「favicon.ico 本地自答」。本 PR 即 #3536 的修复载体,无并列工作。

开始审核:拉取分支 2026-10-17_fix-3536-favicon-fallthrough(head 86b3815)对照当前 master 逐段读 diff、过回归面与测试有效性,结论随后按八问回复。

@ranxianglei
ranxianglei force-pushed the 2026-10-17_fix-3536-favicon-fallthrough branch from 86b3815 to 8f89ab4 Compare October 17, 2026 12:21
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

Review 结论:可合(等 rebase 后新 head 的 CI 绿)

已把分支 rebase 到当前 master(b10c52576,含两条 admin 区新提交 b2ce32ca0 dsh-app://app 信任门、df561d8c8 embed CORS)并推回分支——rebase 零冲突,新 head 8f89ab47e,CI 正在重跑。本地在 rebase 后的 head 上验证:typecheck 干净;定向套件 35/35 全绿(issue3536-favicon-local 2、admin-probe、web-i18n、web-storage-banner、web-update-banner、dsh-settings-ui)。另做了回归测试有效性实测:把新测试文件拷到修复前 master 上跑,2/2 红——测试确实复现原 bug,不是恒真断言。

结构化八问

  1. 是什么问题:dsh 桌面版设置面板 iframe 加载时,浏览器自动对代理 origin 根发 GET /favicon.ico;这个路径不命中任何管理面路由,落进默认 relay 被转发到配置的上游——白耗一次上游请求、日志多一行 403 噪音、上游 host 暴露进面板的网络面板。
  2. 什么原因导致的:两层叠加——①relay 的 fallthrough 语义(CLIENTS.md 有载的既定设计:未识别路径照转上游,零配置隧道靠它工作);②面板 HTML 没声明图标,浏览器按惯例向 origin 根发起 favicon 探针。两者相遇才产生这次无意义转发。
  3. 影响范围与严重程度:仅打开 dsh 桌面设置面板的用户,每次面板加载触发一次;体验瑕疵级——无功能损坏,代价是一次上游请求 + 日志噪音 + 网络面板里看到上游 host。
  4. 怎么修复的:双管齐下,分工明确——治本侧:renderPage 的 head 加 <link rel="icon" href="data:,">,让守规矩的浏览器根本不发探针(embed 壳与独立标签页都覆盖);兜底侧:handleAdminRoute 对 GET /favicon.ico(任意 query)本地答 204,覆盖「先打根再重定向」时序、直接访问 origin 等仍会发探针的场景。明确不碰 relay 通用 fallthrough。
  5. 是否有回归问题:无。逐项清点过既有行为——
    • 其余管理面路由:纯新增一个 if,插在 / 根处理之后、/__bili/health 之前,与各精确匹配路径无重叠,全部不动;
    • relay fallthrough:负向控制测试钉住——未知路径 GET /definitely/not/an/admin/path 仍被转发(mock 上游恰好命中 1 次、403 透传),防止将来泛化成「未知路径一律本地自答」;
    • 面板 HTML:head 多一个 tag。已核实 src/web/page.ts 是仓库唯一 HTML 发射点(src 全域 grep doctype 仅此一处),tests/ 无任何 pin 住 head 字符串的 golden(grep rel="icon"/data:, 零存量命中),相关 web-* 套件全绿;
    • 安全面:/favicon.ico 不是管理面路径,本来就不套 loopback/信任源/反隧道门;204 无 body 无 header,非 loopback 访问也不泄任何信息,暴露面严格小于现状(现状是转发上游);
    • 高危模式逐项过:无语义漂移(GET-only、query 剥除后精确匹配)、无 fail-fast 变吞错、无阈值/时序/输出格式变化。
    • 一个小观察(不拦):HEAD /favicon.ico 与大写变体 /FAVICON.ICO 仍走 relay——浏览器 favicon 探针只会用 GET /favicon.ico,不值得为它扩大钉死面。
  6. 是否破坏缓存:不涉及——静态本地应答,不碰会话状态、重试、游标、去重键。
  7. 是否改了设计方向:没有。刻意收窄:只把这一个有实证的静态资源路径钉在本地,relay「未识别路径照转」的设计保持原样,PR 里也写明了这条边界。
  8. 是否引入了新的配置:没有。不改配置面、不碰 kernel/、不碰 pi-subagents/、版本号未动。

行为变更披露核对

PR 披露完整且准确:旧 = GET /favicon.ico 落 relay 转上游(常见结果 403);新 = 任意 query 一律本地 204,不再产生上游请求;其他未识别路径不变(负向控制钉住)。符合交付规范第 4 条。

判定:方向正确(治本+兜底分层清晰)、测试有牙(红绿双向验证过)、diff 干净(3 文件 +176/-1,每行都与目的相关)、行为变更已披露。mergeable=true,等 rebase 后 head 8f89ab47e 的 CI 跑绿即可合并(合并请人工操作)。

@ranxianglei

Copy link
Copy Markdown
Owner Author

(ai: zhipuai-lb/glm-5.3)

已并入合并列车 #4572(master 合并,merge commit 保留原作者署名)。本 PR 关单收尾;回滚点为 #4572 单提交 revert。

@ranxianglei ranxianglei changed the title [PR] favicon.ico 探针本地自答,面板声明空图标(不再转发上游) | Answer /favicon.ico locally; panel declares an empty icon (#3536) [PR] Answer /favicon.ico locally; panel declares an empty icon (#3536) | favicon.ico 探针本地自答,面板声明空图标(不再转发上游) Oct 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant