dsh-public-origin

dsh-public-origin

让 DeepSeek Harness 的第三方插件在「公网域名 + 反向代理」部署下正常工作。

DSH Web 部署在 VPS 上、通过 https://your.domain 访问时，一些插件会失效：设置页的 iframe 指向 127.0.0.1 被浏览器拒绝，管理操作报错，诊断接口返回 403。这些现象的原因相同：插件假定浏览器从回环地址访问 GUI，有的检查 Origin 是否为 127.0.0.1:<port>，有的检查 Host 是否为回环地址或 IP。换成公网域名并经过反代后，这两种检查都会失败。

本插件统一处理这类问题，不修改任何第三方插件的文件。

处理的情况

dshmarket 已经接入 DSH 自身的请求门禁，不需要处理。

安全边界

插件先判断请求是本机直连还是经过反向代理：

• 本机直连：socket 对端地址属于 127/8 或 ::1，并且请求不带任何 X-Forwarded-For / X-Forwarded-Proto / X-Forwarded-Host / X-Real-IP / Forwarded / CF-Connecting-IP 头。这类请求原样交给原插件，由它自己的规则决定，行为和没装本插件时完全一样。

• 其他请求：先经过 DSH 自身的 connection.requestRejection，也就是 /api 使用的同一套检查：

  • --trusted-host 白名单
  • 跨站请求标记（Sec-Fetch-Site）和 Origin 同源校验
  • DSH 签名的浏览器登录 Cookie

  未登录返回 401，Host 或 Origin 不可信返回 403。只有通过检查的请求才会被改写为回环身份。

判断时不看 Host。Host 由客户端控制，不能作为「来自本机」的依据。

DSH 门禁通过后，回环适配会删除上述转发头，再调用原 handler；这兼容 skill-explorer 0.4.8 新增的代理请求拒绝规则。检查必须先于改写，不允许用改写后的头判断是否登录。

新版 bili 的 { origin: null, relay: true } 响应保留原协议；旧版 origin 则仍改为当前公网 origin。/__bili 始终先经过 DSH/已安装 TG 插件的 Connection 门禁，不因本机直连跳过。插件不修改 bili 配置，也不要求开启 security.adminRelay：关闭时使用已有回环代理，开启时保护并复用原生 relay。路由由 webServer.match 包装/补位，新旧 bili 均可在本插件之前或之后加载，不再抢占相同注册项。

附带效果：bili 原本未登录也能读取的 /bili/origin，在公网访问时也要求先登录。

本插件自建的回环代理连续 5 分钟没有网络活动时会中止；这是空闲超时，不是总执行时限。该分支在上游响应中途断开时关闭下游，浏览器断开时也取消上游连接。复用 bili 原生 relay 时，超时、正文限制和断连处理由 bili 自己实现；0.1.204 使用 120 秒请求时限、8 MiB 请求体上限，不套用本插件的五分钟空闲策略。更新等有副作用的操作均不会由本插件自动重试，遇到连接中断应先确认操作实际结果。

v0.2.1 修复的认证绕过

v0.1.0 用 Host 是否为回环地址来决定是否跳过登录检查。如果反向代理原样转发客户端的 Host（例如 nginx 的 proxy_set_header Host $host），公网访问者只要发送 Host: 127.0.0.1，就能不登录直接：

• 读写 /api/dsh-skill-explorer/*（可以创建技能文件，内容会进入模型上下文）
• 读取 /dsh-better-reasoning-effort/headers-config 等诊断数据
• 从 /bili/origin 读到 bili 的回环地址

使用 v0.1.0 的部署请升级到 v0.2.1 或更高版本。

v0.1.0 只认回环 Host 还带来一个副作用：本机用 IP 地址访问时，reasoning-effort 的路由从 200 变成了 403。这个问题在 v0.2.1 中也一并恢复。

前提

• DSH 以 --trusted-host <你的域名> 启动，这也是 DSH 本身在反代后正常工作的前提。
• DSH 只监听回环地址（如 --host 127.0.0.1），公网只能经反向代理访问。
• 反向代理必须设置转发头，至少设置 X-Forwarded-For 或 X-Real-IP 中的一个，并设置 X-Forwarded-Proto。插件靠这些头识别经过反代的请求。nginx 不会自动添加它们；如果都没设置，公网请求会被当作本机直连而跳过本插件的登录检查；若代理还转发客户端可控的 Host，下游插件可能发生认证绕过。不能把省略转发头仅视为功能失效。X-Forwarded-Proto 还用来生成 bili 页面的 https:// 地址。
• 建议把 Host 固定为公网域名（$server_name），不要原样转发客户端的 Host（$host），作为纵深防御。

nginx 示例：

location / {
    proxy_pass http://127.0.0.1:3080;
    proxy_http_version 1.1;
    proxy_set_header Host $server_name;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto https;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_buffering off;
}

$server_name 在这个 server 块中就是公网域名，和浏览器发出的 Host 相同，所以 DSH 登录 Cookie 绑定的地址不变，已有登录不受影响。前提是 server 块里只有一个 server_name，且它就是浏览器访问的域名。

安装

dsh plugin --profile web add github:JJDonald/dsh-public-origin

或者克隆后从本地路径安装：

git clone https://github.com/JJDonald/dsh-public-origin.git
cd dsh-public-origin
dsh plugin --profile web add "file:$(pwd)"

安装后重启 DSH Web 实例。代码在 lib/ 中，无需构建。

配置

可以在 profile 的 cordis.patch.yml 中覆盖：

- id: public-origin
  config:
    localize:
      - /dsh-better-reasoning-effort
      - /api/dsh-skill-explorer

localize 是需要处理的「只认回环 Host」的路由前缀列表，上面是默认值。以后遇到同类插件，把它的路由前缀加进来即可。bili 的处理是固定启用的，不受这个列表影响。

卸载

公网部署注意：如果已开启 bili 的 security.adminRelay，卸载本插件会移除其 DSH/TG 门禁包装，但 bili 自己的 /__bili 路由仍存在，重启也不会自动保护它。卸载前先关闭原生 relay，或先为该路由落实等效认证。不要在原生 relay 开启且没有其它认证的情况下直接卸载。

dsh plugin --profile web remove dsh-public-origin

然后重启 DSH Web。

兼容性

• 包版本 0.2.1，包含 DSH 0.2.1-rc.2 与新版 bili 的适配。历史部署验证：DSH 0.2.0-rc.2，搭配 billion-context 0.1.192/0.1.194、dsh-better-reasoning-effort 0.5.2、dsh-client-ui-skill-explorer 0.4.6。
• 新适配目标：DSH 0.2.1-rc.2、billion-context 0.1.204、dsh-better-reasoning-effort 0.5.4、skill-explorer 0.4.8。已通过本地定向验证；已登录浏览器完整验收仍需在实际部署后进行。
• Node.js ≥22。
• 插件依赖 DSH 内部的 webServer.match 和 connection.requestRejection，以及 bili 的 /bili/origin 路由。上游改动这些接口后可能需要适配。
• 非官方插件。

许可

MIT