Skip to content

feat: support a public panel origin for remote / reverse-proxied deployments | feat: 远程/反代场景下面板不可用(headless 宿主 + 远程浏览器时 iframe 指向 127.0.0.1) #3373

Closed

Description

@cmdCQ

Description *

现象 / Symptom

宿主机是 headless Linux 服务器(dsh web,plugin native 模式),浏览器在另一台电脑上经 https://dsh.somtfly.com 访问 dsh。打开 设置 → bili 设置 → billion-context 压缩代理,面板内容区是浏览器错误页:

连接失败 — Firefox 无法连接到 127.0.0.1:18787 的服务器

复现步骤 / Steps to reproduce

  1. 宿主 dsh --profile web --host 127.0.0.1 --port 8790,插件 0.1.197,ensureProxyRunning 正常拉起代理,/root/.local/state/billion-context/proxy-origin 里 origin = http://127.0.0.1:18787。
  2. 用一个远程浏览器打开 dsh Web UI(例如经 nginx 反代到 https://dsh.somtfly.com)。
  3. 打开 设置 → bili 设置。面板 iframe.src 是 http://127.0.0.1:18787/__bili/?embed=1&...,而浏览器所在机器上并没有 127.0.0.1:18787 → 连接失败。

服务器上没有浏览器,也没有对外开放的 18787。

根因 / Root cause

链路本身是设计好的「客户端问宿主、宿主回答 origin」:

  • 客户端 dist/agent/dsh-native-client.js:ORIGIN_PATH = "/bili/origin";初始 state 取 readOrigin()(宿主注入的 globalThis.__BILI__?.origin),随后 probeOrigin() 轮询 /bili/origin 并用返回值覆盖,最终 iframe.src = ${origin}/__bili/?embed=1&lang=…${theme}#/${page}``。
  • 宿主 dist/agent/dsh-native.js:注册精确路由 /bili/origin,返回 {origin: currentOrigin() ?? null};currentOrigin() 取 register.base,而 register.base = handle.origin 来自 ensureProxyRunning({host: LAUNCHER_DEFAULT_HOST, port: 0, …}) —— 永远是回环地址。

所以远程浏览器永远拿到 http://127.0.0.1:<port>。

更关键的是第二道闸门:/__bili/ 管理端点只接受回环身份。实测(经 socat 把回环代理暴露到 172.18.0.1:18787):

Host Origin 结果
127.0.0.1:18787 无 200
172.18.0.1:18787 无 403
dsh.somtfly.com 无 403
127.0.0.1:18787 https://dsh.somtfly.com 403
127.0.0.1:18787 http://127.0.0.1:18787 200

403 响应体:{"error":"management request origin does not match the local bili UI"}。Referer 与 X-Forwarded-For 不参与判断。

#1538 已把闸门放宽成「回环主机名、端口不限」(为防 DNS rebinding),但公共域名无法通过,且没有任何配置项可以声明一个对外 origin。我 grep 了 dist/index.js、dist/agent/dsh-native.js 与 CONFIGURATION.zh-CN.md,publicOrigin / panelOrigin / originOverride / externalOrigin / publicUrl 之类开关不存在(webOrigin 只出现在 dist/index.js:4105,与面板无关);文档 CONFIGURATION.zh-CN.md:386 也明确写「/__bili/ 管理端点也仍仅限本机」。

为什么不建议用 BILLION_CONTEXT_PROXY 绕过

设 BILLION_CONTEXT_PROXY=https://dsh.somtfly.com 看起来正好,但它不是「只改显示地址」:

planNativeDsh(env){
  if(env.BILLION_CONTEXT_PLUGIN==="0"||env.BILI_NATIVE_DSH==="0") return {mode:"off"};
  if(env.BILI_PROVIDER_REWRITES!==void 0) return {mode:"off"};
  const attachOrigin = nativeAttachOrigin(env) ?? proxyEnvOrigin(env);
  if(attachOrigin!==void 0) return {mode:"attach",attachOrigin};
  return {mode:"spawn"}
}

插件的代理拓扑会从 spawn(自己拉起代理)切成 attach(附着到已有实例);而 https://dsh.somtfly.com 并不是代理,verifyAttachAndRecover 判定不健康后会 delete process.env.BILLION_CONTEXT_PROXY 回落 spawn。对正在压缩的模型通道来说这是有风险的拓扑变动,不该作为面板显示的开关。

影响 / Impact

凡是「宿主 headless + 浏览器在别的机器」——而这恰好是 dsh web 最常见的部署形态——设置里的 bili 页完全不可用:看不到总览/会话/配置/日志,也无法确认压缩是否生效。插件本身其实工作正常,只是面板地址错了。

期望 / Proposal

希望有一个显式、只影响面板的配置,例如:

  1. native.panelOrigin(或 env BILI_PANEL_ORIGIN):只改 /bili/origin 的返回值,不触碰代理拓扑;
  2. 以及一个显式选择加入的受信反代白名单 native.trustedProxyOrigins: ["https://dsh.somtfly.com"],让来自该 Origin 的 /__bili/ 请求通过闸门——默认仍仅回环,安全边界不变。

若短期不打算做,至少请在 CONFIGURATION.zh-CN.md 的 host 一节写明「远程浏览器要看面板需自行反代并改写 Host/Origin」。现在那段读起来像是「host=0.0.0.0 就能远程用面板」。

我现在的临时绕过(供其他用户参考)

与 dsh 同源的 nginx 站点里:

location = /bili/origin {
  default_type application/json;
  add_header Cache-Control "no-store" always;
  return 200 '{"origin":"https://dsh.somtfly.com"}';
}
location ^~ /__bili {
  auth_basic "billion-context";
  auth_basic_user_file /etc/nginx/dsh-bili/htpasswd;   # 避免把管理面板公开
  proxy_pass http://172.18.0.1:18787;
  proxy_set_header Host 127.0.0.1:18787;               # 过 Origin 闸门
  proxy_set_header Origin http://127.0.0.1:18787;
  proxy_set_header X-Real-IP 127.0.0.1;
  proxy_set_header X-Forwarded-For 127.0.0.1;
  proxy_set_header X-Forwarded-Proto https;
  proxy_buffering off;
  proxy_read_timeout 3600s;
  proxy_send_timeout 3600s;
}

再加一个 socat 桥把回环代理暴露给 nginx 容器(172.18.0.1:18787 → 127.0.0.1:18787)。面板能正常打开(/__bili/ 200,/bili/origin 返回同源地址),但这等于在客户端字符串层面伪造 Host/Origin,依赖内部实现细节,很脆。

安全考量

理解这条闸门有其道理(参见 #3343 同族的越权讨论),所以上面的提议都要求显式开启;建议开启时配合 token/口令,默认行为保持不变。


English summary

The dsh embed panel is unusable when the browser is not on the same machine as the host: /bili/origin always reports the spawned proxy's loopback origin (ensureProxyRunning uses LAUNCHER_DEFAULT_HOST + port 0), so the panel iframe points at http://127.0.0.1:<port>. Rewriting /bili/origin alone is not enough either, because the /__bili/ admin surface only accepts a loopback Host/Origin ({"error":"management request origin does not match the local bili UI"}; cf. #1536 / #1538) and there is no config knob for a public origin (CONFIGURATION.zh-CN.md:386 states the admin endpoints stay loopback-only). BILLION_CONTEXT_PROXY is not a safe workaround — planNativeDsh() switches the plugin from spawn to attach mode, i.e. it changes proxy topology rather than just the displayed origin.

Request: an explicit, panel-only native.panelOrigin (or BILI_PANEL_ORIGIN), plus an opt-in trusted-proxy origin allowlist for /__bili/; otherwise at minimum honest documentation.

bili version *

0.1.197

Usage mode *

Plugin native(dsh 插件内核模式,宿主 dsh web)

Client and version *

  • 宿主:@deepseek-ai/dsh 0.2.0-rc.2(dsh --profile web,headless Linux 服务器)
  • 浏览器:Firefox(远程机器,经 nginx 反代到 https://dsh.somtfly.com)

Activity

  1. ranxianglei commented on Oct 16, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

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

    查重:不重复。 检索了 open+closed 的 issue/PR,没有「远程/反代场景下面板 origin + 受信反代放行」的既有项。相邻但不同:#3343/#3350/#3349 同属「管理面授权」域,但方向相反——它们正在收紧回环校验(marker divert 不得伪造回环身份越权),本 issue 想放宽(受信反代放行 /__bili/);#2452/#3117 是面板 UI/加载问题,不涉 origin 与闸门;#1538 是本 issue 引用的既有闸门行为(Host 放宽到回环名、端口不限),不是重复。

    我先独立核对了你的根因,代码层面成立(对应 master):

    • /bili/origin 永远回环:spawn 模式 ensureProxyRunning({host: LAUNCHER_DEFAULT_HOST="127.0.0.1", port: 0})(src/agent/dsh-native.ts:453)→ register.base → currentOrigin()(dsh-native.ts:205-208)→ /bili/origin 返回 {origin: currentOrigin() ?? null}(dsh-native.ts:1005)。远程浏览器拿到的永远是 http://127.0.0.1:<port>。
    • /__bili/ 闸门两道都拦公共域名:源地址必须回环(src/server/admin.ts:161 isLoopbackAddress(req.socket.remoteAddress)),且 Host/Origin 必须是回环名(admin.ts:73-94 isTrustedAdminOrigin + :169)。你那张 socat 实测表与代码逐格对得上。
    • 你判断 BILLION_CONTEXT_PROXY 会切 spawn→attach 拓扑、不该当面板开关——也对(planNativeDsh,dsh-native.ts:167-173)。

    这是一条 feature request,且落在 owner 拍板区(新增配置字段 + 触及安全闸门),所以我把判断和方案摆出来等你定,不擅自动手。按八问:

    1. 是什么问题:headless 宿主 + 远程浏览器的 dsh web,设置里 bili 面板完全打不开——iframe 指到本机才有的 127.0.0.1,且 /__bili/ 闸门不放行公共域名。压缩本身正常,坏的只是面板这条可观测链路。
    2. 什么原因:两层叠加——(a) /bili/origin 只报回环 origin(上面那条链);(b) /__bili/ 只认回环源地址+回环 Host/Origin,没有任何对外 origin 的配置项。
    3. 影响范围与严重程度:所有「宿主 headless + 浏览器在别台机器」(恰是 dsh web 最常见形态)用户,bili 面板 tab 完全不可用——看不到总览/会话/配置/日志、无法确认压缩生效。触发面=该部署形态全量;严重度=特定条件下功能不可用,但仅限可观测面板,不影响压缩正确性。
    4. 怎么修(推荐思路):一个连贯的 feature,三件都在本 issue 内(同一症状,按同 issue 清单管理,不拆片):
    5. 回归风险:默认(两个新字段都不设)行为逐字不变——这是硬约束。② 唯一相关既有行为是本地浏览器开面板:不配即逐字不变,配了则本地也指向公共 URL(需你保证该 URL 本机可达,否则本地面板反而打不开)。③ 命中「fail-closed 边界改条件放行」的高危模式,但安全面几乎不扩:网络上的攻击者到不了回环、触发不了放宽的 Origin 检查;跨站 fetch 带 evil.com 的 Origin 仍被拒;顶多一个恶意站点能强制导航到面板(数据仍进操作者自己的屏幕、evil.com 读不到,与现状点链接看面板同级)。无缓存/游标影响。
    6. 是否破坏缓存:不涉及(面板路由/管理面闸门,不碰压缩会话、prefix cache、去重键、重试游标)。
    7. 是否改设计方向:不涉及转向,在现有「客户端问宿主、宿主答 origin」链路上加一个可选覆盖值 + 一条受信反代通道。
    8. 是否新增配置:是——这正是需要你 sign-off 的点(Configuration Surface Discipline,我不擅自造配置形状):
      • native.panelOrigin(string,默认空=维持回环)+ env BILI_PANEL_ORIGIN;
      • native.trustedProxyOrigins(string[],默认空=仅回环)+ env;
      • 两者都落在现有 native 块(config.ts 已有 native.attachLanePriority),不造新顶层形状。纯新增、向后兼容,不设即旧行为。

    方案对比

    方案 内容 远程浏览器能否打开面板 风险 新增配置 需你拍板
    A 仅文档 文档说真话 + nginx 配方 ❌(用户自反代能开,非一等公民) 极低 无 否
    B′ ①+② 文档 + native.panelOrigin ⚠️ 部分(单独不够,还差 ③ 那道闸) 低 panelOrigin 是(新配置)
    C 完整 ①+②+③ B′ + 受信反代放行(回环限定) ✅ 一等公民 中低(硬闸不动,只是对回环连接多认几个 Origin) +trustedProxyOrigins 是(安全 human-gated)

    我的明确建议:做 C(完整),三件事收进同一个 PR、都在 #3373 内。关键前提是我把 ③ 严格限定为「受信反代必须与 bili 同机、且经回环接入」(等价于你现在的 socat 桥,但由 bili 侧显式声明而非客户端伪造 Host/Origin)——这精确匹配 dsh web 的真实部署形态,安全面几乎不扩,也不跟本周收紧管理面的 #3343 家族顶牛。跨机/LB 反代不在本次范围(那需要动 :161 源地址那道硬闸,是更大的安全问题,真有需求再单独立项)。

    需要你拍板两件事:
    ① 上面 ②③ 这两个新配置字段(名字+形状)你点头吗?
    ② 「受信反代须同机且经回环接入」这个范围假设 OK 吗(跨机先不做)?

    你一句「可以」我就开 C 的 PR(PR 里带 config-surface 说明 + 定向测试:默认逐字不变、回环+受信 Origin 放行、跨站 evil.com 仍被拒、tunnel-marker 优先级保持),因为触及安全闸门,实现后交你审。

  2. changed the title [-]feat: 远程/反代场景下面板不可用(headless 宿主 + 远程浏览器时 iframe 指向 127.0.0.1)| feat: support a public panel origin for remote / reverse-proxied deployments[/-] [+]feat: support a public panel origin for remote / reverse-proxied deployments | feat: 远程/反代场景下面板不可用(headless 宿主 + 远程浏览器时 iframe 指向 127.0.0.1)[/+] on Oct 16, 2026
  3. ranxianglei commented on Oct 16, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

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

    #3424 已按本 issue 重复关闭(路径前缀网关场景:fnOS NAS 经 https://<域名>/app/dsh/ 剥前缀转发,bili 只听 127.0.0.1:18787,面板全空白)。其四层发现并入本线程清单:

    新的架构判断——两个场景共享同一个根治方案:宿主中转(relay)。 C5 说明前缀只有浏览器知道,所以「让远端浏览器直接摸到 bili」在任何前缀部署下都不可能成立;唯一闭环是 dsh web 服务注册一个 /__bili 前缀路由,把请求转发给 currentOrigin()(loopback),浏览器永远只跟入口同源说话。这个方案对裸域名场景(本 issue 原报告)同样成立,而且会把 @cmdCQ 现在的整套绕行配置塌缩掉:nginx 只需把所有流量都指到 dsh(本来就要),socat 桥、伪造 Host/Origin 头、trusted-proxy 白名单全部不再需要——bili 侧看到的中继跳仍然是 loopback,现有管理面门禁(含 #1538 DNS-rebinding 防护)原样通过、零改动。此前讨论的 native.panelOrigin 也随之失去存在必要(iframe 走同源 URL,不需要另一个展示 origin)。

    待拍板(二选一):

    • 选项 1:无条件中继。dsh-native 恒注册 kind:"prefix", path:"/__bili" → 转发 currentOrigin();客户端 iframe/embed 预检/外链按钮改走入口同源 URL。零配置,两种部署开箱即用。代价:bili 管理面(会话/日志/配置编辑/凭据写入)可达性从「宿主机器 loopback」扩大到「任何能到达 dsh web 服务的人」——若 dsh web 本身暴露公网且无认证,等于把管理面也暴露了。
    • 选项 2:开关中继(fail-closed)。同上,但挂在新的 native.relayPanel(bool,默认 false)之后;远程用户显式打开。默认安全面与现状完全一致,代价是多一个配置字段 + 文档。

    我的推荐:选项 2——与本仓近期收紧管理面方向的惯性一致(#3343 一族),公网裸奔 dsh web 的用户不应默认获得 bili 管理面;若你认为「能访问 dsh web ≡ 操作者本人」普遍成立,选 1 更简洁。两者都不影响下面的止血。

    止血 PR(无决策依赖,已在做):① 客户端探测路径相对页面 baseURI 解析(直连解析结果字节不变);② UI API root 从 location.pathname 的 /__bili 标记推导(根入口 = 空串 = 现状)。对所有当前正常工作的部署零行为变化,且无论上面选哪个都是必需组件。PR 稍后在本线程给出。

  4. ranxianglei commented on Oct 17, 2026

    @ranxianglei
    Owner

    这个配置放在 native.panelOrigin 吗?有更好的地方吗?

    是不是搞一个安全相关的顶层字段 其他没问题

  5. ranxianglei commented on Oct 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

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

    同意,撤掉 native.panelOrigin。核对了 config.ts:顶层 native 块其实是「native-hook attach 行为」(attachExternal / attachLanePriority / attachPolicy / attachUrl),面板 origin 和管理面安全都不该塞进去——你的直觉对。

    我的落点建议:两个旋钮功能上耦合(远程面板要同时用到,且都管的是 /__bili/ 管理面「从外面怎么够到」),所以收进同一个新顶层块,而不是把一个拆进 security、另一个另放。命名按它的对象(管理面)而非泛泛的 security 伞——更准,且现在没有现成的 security 块可挂。

    {
      "admin": {
        "publicOrigin": "https://dsh.somtfly.com",        // 可选;空=维持回环(现状)
        "trustedProxyOrigins": ["https://dsh.somtfly.com"] // 可选;[]=仅回环(现状)
      }
    }
    • file-only,不加 env:小众部署旋钮,尊重 env 面稀缺(彻底整治环境变了滥用,除非必要都走配置文件 #2030),跟 native.attachLanePriority 的 file-only 先例一致。
    • publicOrigin 只覆盖 dsh 面板那两处显示点(index-inject 启动快照 + /bili/origin 路由),不外溢到 proxy 拓扑 / register.base / reportDshSessionName 等服务端消费点。
    • trustedProxyOrigins 只对经回环到达的连接生效(源地址那道硬闸不动),且受信 origin 要求带匹配 Origin 头。默认两字段不设 = 行为逐字不变。

    完整分析(八问+方案表+回归风险)在我上一条已给,这里只是把落点定死。我这就按 admin.{publicOrigin, trustedProxyOrigins} 开 PR(触及管理面安全闸门,实现后交你审,不自动合)。若你想换块名/字段名(比如就叫 security.*),说一声我改。

  6. ranxianglei commented on Oct 17, 2026

    @ranxianglei
    Owner

    (ai: zhipuai-lb/glm-5.3)

    配置归属拍板建议

    1. panelOrigin 已死,不用安家。relay 方案下 iframe 走入口同源 URL,"显示 origin 覆盖"这个需求不存在了。真正要安家的只剩一个 knob:relay 开关。
    2. 不放 native.*。native 块现有 4 个字段(attachExternal / attachLanePriority / attachPolicy / attachUrl)全是 hook 的发现/附着行为,文档明写 "Native-hook attach behavior";relay 闸门是宿主侧消费(dsh web 路由注册),语义是"管理面信任边界从 loopback 扩到 dsh web 入口"——是 security posture 决策,不是 attach 机制。塞进去污染块语义,还把安全决策埋进机制块里不可审计。
    3. 同意搞安全顶层块:security.adminRelay(bool,默认 false,fail-closed,纯 file 无 env)。命名不用 "panel":中继转发的是整个 /__bili/ 管理面——含配置编辑、凭据写入,不只是"面板";叫 panel 会让人低估暴露面。这个块未来收同族 knob(trusted-proxy 白名单若非 relay 路线回归、面板口令),正好接上 [security] The incremental compression channel (marker divert) performs no loopback validation; a crafted request spoofing a 127.0.0.1 source address can perform unauthorized operations on any session management plane. | [security] 增量压缩通道(marker divert)不做回环校验,合成请求伪造 127.0.0.1 源地址可越权操作任意会话管理面 #3343 一族管理面收紧弧线,posture 类改动一处看齐。
    4. admin.ts 闸门零改动:中继跳在 bili 看来是本机非浏览器客户端(loopback 源地址 + loopback Host + 无 Origin 头——转发时剥掉浏览器带来的 Origin/Cookie/Referer 即可),fix: accept SSH-forwarded local port in admin origin gate (#1536) #1538 DNS-rebinding 防护原样成立。

    实现清单(已开工,PR 随后)

    安全注记(会写进文档):开启 relay 且 dsh web 自身无认证时,/__bili/ 管理面对所有能到达 dsh web 入口的人开放(含配置编辑与凭据写入)——默认 false 正是为此。

  7. ranxianglei commented on Oct 17, 2026

    @ranxianglei
    Owner

    (ai: zhipuai-lb/glm-5.3)

    已实现,PR 在 #3486:security.adminRelay(默认关、fail-closed、仅配置文件),dsh 侧注册 /__bili 前缀路由把整个管理面经宿主入口中继到回环代理。远程浏览器打开 bili 标签页全程与入口同源;/bili/origin 上报 {"relay":true} 后面板自动改用同源 URL。管理端门槛(#1538)零改动:中继跳到达代理时是本机非浏览器客户端(回环源地址 + 回环 Host、不携带浏览器的 Origin/Cookie/Referer),与现有检查早已放行的形状一致,因此无需 trustedProxyOrigins 之类的面。前缀网关(/app/dsh/…,#3424 的变体)也顺带修好:面板 API 根从页面路径推导,origin 探测会缓存命中的探测形式,不再对着错误 URL 无限重试(C1)。安全提示已写进文档:/__bili/ 是完整管理面(含改配置、写凭据),开启中继 = 凡能访问宿主 web 入口的人都能触及,先给入口加鉴权/反代。

  8. ranxianglei commented on Oct 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

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

    查重/撞车结论:这个 issue 上有两个 agent 同时开工。我先独立实现了一版(publicOrigin + trustedProxyOrigins,需要放宽 /__bili/ 安全门槛),但 #3486 已经先行落地并用了不同的「宿主中继」方案。按 loop guard(一个 issue 最多一个 PR)我以 #3486 为准,已把我那半截改动 revert(工作区干净,没推分支、没开第二个 PR),这边收工。下面是我对 #3486 的独立审核结论(我自己读 diff 判的,不是复述作者描述)。

    结构化八问(针对 #3486)

    1. 是什么问题:headless 宿主 + 浏览器在另一台机器/反代后面时,dsh 设置页里 bili 面板的 iframe 指向 http://127.0.0.1:<port>,远程机器连不上 → 面板打不开。feat: dsh web admin relay (security.adminRelay) — remote browsers open the bili panel (#3373) #3486 让宿主自己把 /__bili/ 管理面经它自己的入口同源中继到回环代理,远程浏览器全程走它已到达宿主的那个入口。
    2. 什么原因导致的:两条叠加——① /bili/origin 只上报回环 origin(currentOrigin()→register.base=127.0.0.1),iframe 照搬;② /__bili/ 管理门槛(fix: accept SSH-forwarded local port in admin origin gate (#1536) #1538)要求来源是本机(回环源地址 + 回环 Host/Origin),公网域名必被拒。于是远程浏览器既拿不到可用地址、直连又被门槛挡。
    3. 影响范围与严重程度:仅「headless 宿主 + 浏览器跨机器/反代」这一种部署形态;本地同源使用不受影响。该形态下是面板完全不可用(体验阻断,非数据/安全问题)。默认关,不波及任何现有部署。
    4. 怎么修复的:宿主注册 /__bili 前缀路由转发到回环代理;转发前丢掉 Host/Origin/Cookie/Referer,让到达代理的那一跳呈现为「本机非浏览器客户端」——正是现有门槛本就放行的形状,所以门槛一行不改、DNS-rebinding 保护原样保留。/bili/origin 改报 {relay:true},面板据此用同源 URL;面板 API 根从页面路径自推导(顺带修 /app/dsh/ 前缀网关)。单一开关 security.adminRelay,默认 false,fail-closed,仅配置文件。
    5. 是否有回归问题(逐项核过既有行为):默认关时新增的 /__bili 前缀路由只回 404(bili 自有命名空间,宿主本无此路径,不遮蔽任何既有宿主路由);index-inject 与 /bili/origin 在 relay 关时输出与现状逐字节一致;config 仅新增可选 security 块并把它加进 KNOWN_TOP_LEVEL_KEYS,不动既有解析;register 类型放宽向后兼容(无 write 时走 arrayBuffer 兜底)。未见回归。
    6. 是否破坏缓存:不涉及压缩缓存/重试/游标/去重键。唯一新状态是探测命中形式的进程内缓存(winProbeForm,C1 修复的一部分),只让探测不再对错误 URL 无限重试,属预期。
    7. 是否改了设计方向:相比我那版(要动安全门槛),feat: dsh web admin relay (security.adminRelay) — remote browsers open the bili panel (#3373) #3486 走宿主中继,不改门槛、暴露面收敛为单一布尔开关,风险更低、更贴合单写者契约——方向上优于我的方案,我放弃我这版。
    8. 是否引入新配置:是,顶层 security.adminRelay(boolean,默认 false,仅配置文件,无 env,彻底整治环境变了滥用,除非必要都走配置文件 #2030)。已在 CONFIGURATION.md 中英 + website seed 记录,并写明「开中继 = 凡能访问宿主入口者都能触及完整管理面(含改配置/写凭据),先给入口加鉴权/反代」。

    测试有效性

    核心机制被真断言钉住了:tests/dsh-admin-relay.test.ts 覆盖 fail-closed(关→404 而非 502)、未绑代理(503)、不可达(502),以及最关键的一条——桩代理实际收到的是 fetch 派生的回环 Host、且 Origin/Cookie/Referer 已被剥掉,直接验证了「门槛零改动」的安全主张。tests/dsh-settings-ui.test.ts 钉住了同源绑定 + 前缀网关 baseURI 回退(frame src = …/app/dsh/__bili/?embed=1…)。断言有牙,不是恒真。

    非阻塞观察(供作者/你定夺,我不擅自改别人的 PR 分支)

    • A(建议确认):前缀网关(/app/dsh/)服务端那一跳依赖 dsh 路由器把去前缀后的 req.url 交给插件路由;relay 单测用 fakeReq("/__bili/…") 假设了这点,客户端侧(baseURI 回退)有测,但带前缀的 req.url 经真实宿主路由这条路没验。主场景(nginx 在根路径反代)已完整覆盖;「顺带修好网关」这条建议补一个模拟带前缀 req.url 的用例、或跑一次真实网关 e2e 再依赖。
    • B(可选加固):转发是 fetch(${base}${url}),若 url 含原始 ../ 且宿主路由未做归一化,URL 归一会把目标推出 /__bili 之外。浏览器会自行归一化所以远程浏览器触发不了,但裸 HTTP 客户端可构造。建议转发前断言归一化后的目标仍以 /__bili 开头(~5 行,防御纵深)。
    • C(低概率):响应用 redirect:"manual",若代理某处返回绝对回环 Location,会原样转给远程浏览器导致跳转失败;JSON/embed 面基本不发重定向,概率低,留意即可。
    • D(cosmetic):src/web/client.ts:93 提示文案仍写死 "GET /__bili/stats"(网关下会显示无前缀路径),纯文案,顺手可改。

    判定

    建议以 #3486 为准推进(等 CI 绿 + 你合并;我不能替人合 PR)。A/B 两条若想收,我可以在 #3486 分支上补独立标注的小 commit,或你安排给原作者——听你的,不自作主张。

  9. ranxianglei commented on Oct 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

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

    补充:#3486 的 CI 已全绿(head e490dbe,30 pass / 14 skip,无红)。所以按我上面的判定,#3373 现在就差你合并这一步了(我不能替人合 PR)。

    A/B 两条加固(前缀网关服务端一跳的真实路由验证、转发前 /__bili 前缀断言)要不要收、由谁收,等你一句话——要的话我在 #3486 分支补独立标注的小 commit。否则维持现状即可,我这侧已收工。

  10. added 2 commits that reference this issue on Oct 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions