DeepSeek Harness 插件

AcidGr/dsh-web-lan-access

Star 数 ★ 1 分类 UI 增强 收录于 2026-08-14 npm dsh-web-lan-access

Web UI 局域网/远程访问：为纯 HTTP 非安全上下文注入 crypto.randomUUID polyfill，局域网/Tailscale IP 直连时前端不再崩溃。

安装

# npm 包（预构建）

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

# GitHub 源码（首次需按提示配置 allowBuilds 构建授权后重试）

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

GitHub 来源的插件在安装时会在你的机器上执行构建脚本。请只安装可信来源，并尽量锁定 commit（github:owner/repo#sha）。

README

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 抛错，会话和模型完全无法显示。

原理

宿主端插件使用 webserver 官方扩展点（webServer.tapIndex），在每次返回的 index.html 的 <head> 之后注入一段 polyfill（基于 crypto.getRandomValues 的 RFC 4122 v4 实现——该 API 在非安全上下文可用），位置在启动清单和 shell 入口之前。安全上下文下 polyfill 为空操作。

  • 不修改产品源码，完全可逆
  • 与版本无关（只转换下发的 index.html）
  • 跨平台（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'

使用

  1. 绑定所有网卡，让其他设备可连接：

    dsh --profile web --host 0.0.0.0 --port 3080

    绑定 0.0.0.0 后，harness 会自动把本机所有非内部 IPv4 加入 /api 信任围栏（resolveLanTrust）——局域网 IP 访问零额外配置。

  2. 域名/远程（如 Tailscale）——把你自己的入口加进 trustedHosts：

    - id: web-runtime
  config:
    trustedHosts:
      - <短名>            # 如 myhost —— 必须单独列出！
      - <名称>.tailXXXX.ts.net  # 完整域名
      - 100.x.x.x         # tailnet IP

    ⚠️ 围栏逐字比对 Host 头：MagicDNS 短名（http://myhost:3080）≠ 完整域名，短名必须单独列一行，否则所有 /api 请求返回 403（页面壳能开、会话/模型全无）。

验证

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

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

安全警告

绑定 0.0.0.0 后，同一网络内任何设备都能无鉴权操作该 agent（/api 只是来源围栏，不是登录）。公网 IP 的服务器等于向整个互联网开放。请只在可信网络使用；用防火墙限制网段（如 ufw allow from 192.168.0.0/16），或走 Tailscale / 带鉴权的反向代理。走 TLS 反代的话连这个 polyfill 都不需要。

回滚

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

许可证

MIT

内容来自项目 README（GitHub）↗

链接

GitHub 仓库 ↗ npm 包 ↗ 通过 dsh-market 安装 ↗

同类插件

查看整个分类 →