dsh-plugin-remote-access

English | 中文

@xiaosenho/dsh-plugin-remote-access 是 DeepSeek Harness Web profile 的可安装组合包。它在设置面板添加“远程连接”，可按需开启局域网访问或通过 frpc 连接现有 frps 服务，并生成可复制的认证链接供电脑、平板和手机访问完整 Web UI。

安装

从 npm 安装：

dsh plugin --profile web add @xiaosenho/dsh-plugin-remote-access

从本地 checkout 安装：

dsh plugin --profile web add ./dsh-plugin-remote-access

从 Git 仓库安装时请固定提交：

dsh plugin --profile web add github:xiaosenho/dsh-plugin-remote-access#<commit>

Git 安装会运行本包的 prepare 构建。pnpm 首次会拒绝未授权的构建脚本；按 dsh 输出的提示，在 Web profile 的 pnpm-workspace.yaml 中授权后重新执行安装：

allowBuilds:
  '@xiaosenho/dsh-plugin-remote-access': true

此授权允许安装包在宿主机执行构建代码。仅安装可信来源并固定提交。发布到 npm 或使用包含 lib/ 的 tarball 时不需要 Git prepare 授权。

局域网连接

1. 启动 dsh --profile web，打开“设置 > 远程连接”。
2. 选择“局域网”，设置本地端口，然后保存并开启。
3. 复制下方链接，在同一局域网内的其他设备打开。

链接中的 token 是访问凭据。首次打开时，插件把 token 换成 HttpOnly、SameSite=Strict Cookie，然后从地址栏移除 token。关闭、重新开启或修改运行中的配置都会撤销旧链接。

隧道连接

宿主机必须能执行与服务器 frps 版本兼容的 frpc。可在设置面板手动填写绝对路径，或点击文件按钮通过系统原生选择器选择本地客户端。默认从 PATH 查找 frpc；Web profile 中的 frpcPath 继续作为部署级兜底值，其他运行限制也在此配置：

- id: remote-access
  config:
    listenPort: 3081
    frpcPath: /opt/homebrew/bin/frpc
    processGraceMs: 3000
    frpcStartupTimeoutMs: 500
    frpcOutputMaxBytes: 32768
    requestMaxBytes: 16384

在设置面板选择“隧道”并填写：

• frpc 客户端：本地可执行文件路径，可使用宿主机原生文件选择器或手动填写。
• 服务器地址：frps 控制地址或 IP。
• 服务器端口：frps.bindPort，通常为 7000。
• server.token：与服务端 [auth].token 相同的认证 token。
• 公网入口：选择“域名”或“IP + 端口”。
• 域名：选择 HTTP 或 HTTPS，并填写用户实际打开的 authority，例如 https://dsh.example.com。
• IP + 端口：填写 frps 公网 IP 与独占的 remotePort，例如 203.0.113.10:18080。

域名模式为 frpc 生成 HTTP 类型代理并设置 customDomains。公网 HTTP 可直接使用 frps.vhostHTTPPort。公网 HTTPS 应在服务器反向代理或负载均衡器终止 TLS，再转发到 frps 的 HTTP vhost；该插件不会把本地 Web UI 伪装成 TLS 源站。IP + 端口模式生成 frp TCP 代理并设置 remotePort，用户无需 DNS，直接打开 http://<公网 IP>:<公网端口>；frps 的 allowPorts 策略必须允许该端口。IP 直连仅支持 HTTP；HTTPS 请使用域名模式和受信任证书。

当普通 HTTP 源提供 crypto.getRandomValues() 但没有 crypto.randomUUID() 时，插件还会在浏览器侧安装兼容方法，使 Harness 工作区 RPC 可以在局域网 HTTP 页面使用，而无需修改 DeepSeek Harness 仓库。

安全模型

• 主 Web server 保持回环监听；插件另起认证代理，局域网模式监听所有网卡，隧道模式只监听回环。
• 未携带有效 Cookie 的 HTTP 和 WebSocket 请求都在认证代理处返回 401。
• server.token 保存在 Harness 设置的 secret 字段中，仅写入随机私有目录内权限为 0600 的临时 TOML，不进入命令行、浏览器响应或访问链接。
• 控制 API 只接受回环套接字、回环 Host 和同源浏览器请求。远程浏览器必须经过认证代理，由代理重写为回环上游请求。
• frpc 原生文件选择器只能从宿主机页面触发；已认证的远程浏览器可以手动编辑路径，但不能在宿主机桌面弹出文件对话框。
• 访问链接本身是 bearer credential。不要发到聊天群、工单或日志；怀疑泄露时关闭后重新开启服务。

开发

pnpm install
pnpm run typecheck
pnpm run test
pnpm run build

pnpm pack 生成可直接通过 dsh plugin --profile web add ./xiaosenho-dsh-plugin-remote-access-0.1.3.tgz 安装的预构建包。