概览

dsh-web-lan-access

LAN / remote access support for the DeepSeek Harness Web UI: self-contained 0.0.0.0 binding, remote Host settings, automatic /api trust-fence widening, and an insecure-origin randomUUID polyfill.

README / ZH

插件文档

dsh-web-lan-access

English | 简体中文

DeepSeek Harness Web UI 的局域网/远程访问支持插件。

问题

Web UI 在启动关键路径上调用 crypto.randomUUID()（RPC id 生成、消息 id、草稿附件）。该 Web API 只在安全上下文存在（HTTPS，或 http://localhost / http://127.0.0.1）。当界面通过纯 HTTP 从非回环地址（局域网 IP、Tailscale IP、主机名）提供服务时，crypto.randomUUID 是 undefined，所有 RPC 抛错，会话和模型完全无法显示。

当前 DSH 客户端还会根据浏览器主机名选择宿主设置：即使浏览器认证成功，非回环页面仍只分配内存设置。因此，在其他功能正常的 trusted-host 部署中，模型和插件设置页仍不可用。

原理

宿主端插件使用 webserver 官方扩展点（webServer.tapIndex），在每次返回的 index.html 的 <head> 之后、启动清单和 shell 入口之前注入一段 bootstrap。它会：

提供普通 HTTP transport 并携带 DSH 的 ownsHost 部署信号，让受信任远程页面可以使用通过认证的宿主设置；
用 crypto.getRandomValues（非安全上下文仍可用）补充 RFC 4122 v4 crypto.randomUUID。

如果其他 shell 已提供 transport，bootstrap 不会替换它；安全上下文下 UUID polyfill 为空操作。

不修改产品源码，完全可逆
使用 DSH 现有的 index-tap 和客户端 transport 扩展点
跨平台（Linux / macOS / Windows / Android）

安装

方式一：bundle 安装（推荐）

从 npm 安装：

dsh plugin --profile web add dsh-web-lan-access

（不走 npm / 本地开发时，可用仓库地址：

dsh plugin --profile web add github:AcidGr/dsh-web-lan-access

）

重启 dsh web，浏览器硬刷新。

方式二：手动安装（无 pnpm / 离线）

PROFILE="$DSH_HOME/profiles/web"                 # 按实际修改 DSH_HOME 和 profile 名
mkdir -p "$PROFILE/plugins" "$PROFILE/node_modules/@dsh-profile"
cp -r dsh-web-lan-access "$PROFILE/plugins/lan-access"
ln -sfn ../../plugins/lan-access "$PROFILE/node_modules/@dsh-profile/lan-access"
# 在 $PROFILE/cordis.patch.yml 追加：
#   - insert:
#       - id: lan-access
#         name: '@dsh-profile/lan-access'

使用

插件是自包含的：它的 bundle patch 直接把 webserver 的绑定 host 设为 0.0.0.0（新版 harness 出于安全硬性拒绝命令行 --host 0.0.0.0，但 webserver 配置仍接受该值——所以无需改源码、无需 --host 参数；--port 参数照常可用）。它同时会自动扩大 /api 信任围栏。

安装插件后正常启动即可（不带 --host）：
```
dsh --profile web --port 3080
```
bundle patch 会从本机当前所有非内部 IPv4（局域网 192.168.x、Tailscale 100.x、VPN 接口）重新推导 /api 信任围栏，并合并 resolveLanTrust 已有的结果。只要远程接口在 dsh web 启动时已就绪（Tailscale 通常开机自启、先于它），局域网 / Tailscale IP 访问零额外配置：打开 http://<服务器IP>:3080 或 http://<tailscaleIP>:3080 即可正常加载会话和模型。

如果你不想让插件接管绑定（例如想保持 127.0.0.1 + 端口转发），把 webserver 行覆盖从组合里去掉，改用 socat / rinetd / Tailscale serve 从 127.0.0.1:3080 转发端口，并把转发入口地址手动加入 trustedHosts。
MagicDNS 主机名（如 xxx.tailXXXX.ts.net）——围栏只能自动发现 IP 字面量，无法发现主机名，所以如果你想像按 IP 那样用名字访问，需手动声明。改 web-runtime 行：它的 trustedHosts 是喂给围栏计算的输入（resolveLanTrust 会合并它们），你的条目叠加在自动发现的 IP 之上，是追加语义：
```
- id: web-runtime
  config:
    trustedHosts:
      - <短名>            # 如 myhost —— 必须单独列出！
      - <名称>.tailXXXX.ts.net  # 完整域名
```
或者不改文件，直接用可重复的 CLI 参数（同一条注入路径）：dsh --profile web --trusted-host myhost --trusted-host myhost.tailXXXX.ts.net。两种方式二选一——静态列表会替换该行的默认表达式，不会再与 --trusted-host 合并。

⚠️ 围栏逐字比对 Host 头：MagicDNS 短名（http://myhost:3080）≠ 完整域名，短名必须单独列一行，否则所有 /api 请求返回 403（页面壳能开、会话/模型全无）。Tailscale / 局域网 IP 字面量无需在此列出——已自动覆盖。

⚠️ 不要把这段改指向 connection 行：patch 层按应用顺序做整个 key 替换（各 bundle 层先应用、本文件的层最后应用），直接往 connection.config.trustedHosts 写普通数组会静默替换掉 bundle 的动态围栏表达式——名字能访问了，但自动推导的局域网/Tailscale IP 信任就没了。确实需要动 connection 时，请照抄插件 bundle 补丁里的完整拼接表达式再追加自己的字面量，不要写纯列表。

宿主所有权范围

该 transport 信号会启用 DSH 当前归入“拥有宿主”的全部客户端界面，并非只启用模型页。其中包括宿主持久化设置，以及打开生成文件等宿主原生操作。仅应在已认证的远程浏览器确实用于操作 agent 主机时使用本插件。DSH 的 Host/Origin 围栏和浏览器认证仍然生效；此信号改变的是客户端能力投影，不是请求认证。

旧版 harness 如果仍在服务端把特权方法限制为仅回环，这些方法仍会返回 403。客户端 bootstrap 不会削弱服务端围栏。

验证

curl http://127.0.0.1:3080/ | grep lan-access-polyfill   # 必须有输出

再从另一台设备打开 http://<服务器IP>:3080——会话和模型应正常加载。

安全警告

绑定 0.0.0.0 会把 DSH 认证入口暴露到所有可达接口。trustedHosts 是 Origin/Host 围栏而非身份认证；当前 DSH 构建会另外认证浏览器。请只在可信网络使用；用防火墙限制网段（如 ufw allow from 192.168.0.0/16），或走 Tailscale / 带鉴权的反向代理。TLS 反代可免除 UUID polyfill，但远程宿主设置 bootstrap 仍然需要。

回滚

bundle 安装：dsh plugin --profile web remove dsh-web-lan-access
手动安装：删掉 cordis.patch.yml 里的 lan-access insert 块；可选：启动时去掉 --host 0.0.0.0

许可证

MIT

dsh-web-lan-access