返回目录

deepseek-harness-relay

精选清单收录维护状态: 活跃

sorsama/deepseek-harness-relay

远程访问中继:TLS、二维码/口令设备配对、密码登录与按设备吊销,安全地远程访问本机 DSH。

前往 GitHub项目主页
$ dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

17

星标

6

Fork

TypeScript

语言

MIT

许可证

2026-08-21

创建于

2026-11-09

最近推送

MIT 许可的 TypeScript 插件,给一个完全不用改动的回环 DeepSeek Harness 套上 HTTPS、密码登录与二维码 / 8 位配对码设备配对,并提供 mDNS 发现、按设备吊销和两台电脑之间的一键关联。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-16

许可证

MIT

01它能帮你完成什么?

  • 不用把 Harness 暴露给整个 Wi-Fi,也能用手机或另一台电脑访问它

    中继端口上的 TLS、密码校验与设备配对,而 Harness 始终留在 127.0.0.1 上——中继挂掉时 Harness 只是不可达,而不是被暴露

    在笔记本或台式机上跑 Harness Web 配置、希望手机或平板能用上(或经端口转发从外网访问)、又不想把 Harness 绑到 0.0.0.0 的人

  • 一台一台地配对设备,之后随时单独掐断其中任意一台

    `/relay/devices` 里带名字、持有独立 token 的设备,可单独吊销的能力,以及会轮换签名密钥的「全部退出登录」按钮

    把同一个中继分给手机、平板和第二台电脑使用、希望每台都能单独吊销的人

  • 把两台电脑关联起来,任意一台都能一键打开另一台的 Harness

    两侧 Computers 页面都会列出这条关联,**Open** 会给当前浏览器签发一次性登录,直接落到另一台电脑的 Harness 而无需重输密码

    同时有台式机和笔记本、两台都装了 dsh-relay,并且用浏览器而不是桌面应用的人

02如何接入 DeepSeek Harness?

前置条件

  • 带 Web 配置的 DeepSeek Harness —— 中继是该配置的插件,桌面应用运行的是同一个配置
  • Harness 仍留在回环地址:删掉 `~/.dsh/profiles/web/cordis.patch.yml` 里把它绑到 `0.0.0.0` 的那一行,因为中继不会在一个已经开放到网络上的 Harness 前面启动
  • `dsh` 在 PATH 上,否则每条命令都改用 `npx @deepseek-ai/dsh ...`
  • 与 Harness 匹配的中继版本 —— Harness 0.1.7-rc.2 到 0.2.x 用 0.3

安装步骤

  1. 01

    在 Harness 里:侧边栏 **Plugins** → **Add plugin** → 粘贴 `https://github.com/sorsama/deepseek-harness-relay` → **Install**

  2. 02

    pnpm 询问 git 包的构建脚本时选择 **Allow these scripts and retry**;构建完成后选择 **Enable now**

  3. 03

    终端方式:`dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`;桌面应用改为 `dsh plugin --profile desktop add https://github.com/sorsama/deepseek-harness-relay`

    $ dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

  4. 04

    也可以装已构建好的包:`dsh plugin --profile web add dsh-relay` —— 同一份代码并带 `lib/`,不执行任何构建脚本

    $ dsh plugin --profile web add dsh-relay

  5. 05

    在运行 Harness 的那台机器上打开 `https://127.0.0.1:3443/relay/password` 设置第一个密码,再到 `https://127.0.0.1:3443/relay/pair` 用二维码或 8 位配对码配对手机

验证接入成功

  • `https://127.0.0.1:3443/relay/health` 在中继启动后会有响应
  • Harness 启动时会打印中继地址;桌面应用在启用插件后需要退出重开
  • 配对的手机会带着你给的名字出现在 `/relay/devices` 下

03DSH 适配与能力边界

DSH 适配原生运行时

Harness Web 配置的原生 DSH 插件 —— 用 `dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay` 安装后,它在 :3443 上自建监听,并往 Harness 界面加入 **Relay** 操作、一组 `/relay/*` 页面和 **Plugins → dsh-relay → Configure** 设置页

  • TLS 终止与密码登录

    来自网络上手机或浏览器的 HTTPS 请求→只有密码(或已配对设备的凭据)通过后才建立会话;错误次数过多会临时锁定该地址

    Harness 留在回环地址上,中继作为它旁边的第二个监听端口运行
  • 二维码 / 8 位配对码设备配对

    扫码,或在手机上输入 8 位配对码,再给设备起个名字→`/relay/devices` 下带名字、持有独立 token 的设备

    配对后的设备会记录在 `/relay/devices`,可以单独吊销
  • mDNS 发现(`_dsh._tcp`)

    中继在 `_dsh._tcp` 上广播,App 不必扫描网段就能找到它

  • Harness 界面内的 Relay 页面

    原样的 Harness 界面,外加角落的 **Relay** 链接与侧边栏底部的 **Relay** 操作

    按 **Relay** 会让当前应用原地切换到中继的配对、设备与密码页面,仍在同一个窗口里
  • Computers:两台电脑之间的一键关联

    另一台电脑的地址、配对码与证书指纹→两侧 Computers 页面都列出这条关联,**Open** 用一次性登录把当前浏览器送到另一台 Harness

    关联会同时记录在两台电脑上,任意一侧 **Unlink** 都能结束它

04适合谁?何时不该用?

适合

  • 在笔记本或台式机上跑 Harness Web 配置、希望手机或平板能用上(或经端口转发从外网访问)、又不想把 Harness 绑到 0.0.0.0 的人
  • 把同一个中继分给手机、平板和第二台电脑使用、希望每台都能单独吊销的人
  • 同时有台式机和笔记本、两台都装了 dsh-relay,并且用浏览器而不是桌面应用的人

不适合

  • 中继只在 Harness 留在回环地址时成立:如果发现 Harness 已经在网络地址上监听,它会拒绝启动;同时它把回环当作你本人,所以在 `127.0.0.1:3443` 前面再套一层回环代理(Tailscale Funnel / Serve、nginx、Caddy)就完全不会要求密码。
  • 桌面应用里绝不要从 Harness 自己的端口加一条指向中继源的跳转:应用窗口无法完成到中继自签名证书的跳转,而这个失败对应用是致命的。桌面应用也完全无法加载远程 Harness。
  • Harness 与中继的版本必须匹配:README 把 Harness 0.1.7-rc.2 到 0.2.x 对应到 dsh-relay 0.3,版本范围不符时 Harness 会拒绝加载该插件。
  • 0.8.0 之前的 DSH Mobile 完全不发送凭据,中继只能靠记住手机的网络地址放行——README 明确说这不是真正的认证。另外那条纯 HTTP 监听(`DSH_RELAY_PLAIN_PORT`)没有登录与配对页面,也永远访问不到 Harness 的设置与凭据。

05兼容性、维护与安全提示

  • 中继只在 Harness 留在回环地址时成立:如果发现 Harness 已经在网络地址上监听,它会拒绝启动;同时它把回环当作你本人,所以在 `127.0.0.1:3443` 前面再套一层回环代理(Tailscale Funnel / Serve、nginx、Caddy)就完全不会要求密码。
  • 桌面应用里绝不要从 Harness 自己的端口加一条指向中继源的跳转:应用窗口无法完成到中继自签名证书的跳转,而这个失败对应用是致命的。桌面应用也完全无法加载远程 Harness。
  • Harness 与中继的版本必须匹配:README 把 Harness 0.1.7-rc.2 到 0.2.x 对应到 dsh-relay 0.3,版本范围不符时 Harness 会拒绝加载该插件。
  • 0.8.0 之前的 DSH Mobile 完全不发送凭据,中继只能靠记住手机的网络地址放行——README 明确说这不是真正的认证。另外那条纯 HTTP 监听(`DSH_RELAY_PLAIN_PORT`)没有登录与配对页面,也永远访问不到 Harness 的设置与凭据。
2026-08-212026-11-09v0.4.0

MIT · 最新发布 v0.4.0(2026-11-09)· 活跃维护,README 在 Harness 0.1.7-rc.2 到 0.2.x 上实测

06常见问题

怎么把 dsh-relay 装进 DeepSeek Harness?

在侧边栏打开 **Plugins**,选 **Add plugin**,粘贴 `https://github.com/sorsama/deepseek-harness-relay` 后点 **Install**。首次安装会在临时副本里构建插件,所以 pnpm 询问时要选 **Allow these scripts and retry**,完成后选 **Enable now**。终端里同一个地址也能用:`dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`(桌面应用换成 `--profile desktop`);想要已构建好的包则用 `dsh plugin --profile web add dsh-relay`,它不执行构建脚本。

它对应哪个 Harness 版本?

README 的表格把 Harness 0.1.7-rc.2 到 0.2.x 对应到 dsh-relay 0.3(在 0.2.1-rc.3、0.2.0-rc.2 与 0.1.7-rc.2 上实测过)。版本不匹配时 Harness 会拒绝加载,并告诉你它需要哪个范围:0.3 依赖 Harness 0.1.7 才有的设置系统,而 0.2 会让 0.1.7 及以后的 Web 应用卡住。

还没设密码时,网络里的人会不会先占用中继?

不会。密码还不存在时,这个页面只能从运行 Harness 的那台机器打开。而那台机器本身也不需要密码:中继把回环当作你本人,因为能坐到那个键盘前的人本来就有 shell。

配对后的设备能做什么,怎么切断?

每台配对设备有自己的 token,会出现在 `/relay/devices` 里,可以单独吊销。配对码一次性使用、五分钟后失效,而且只能在运行 Harness 的那台机器上生成。**全部退出登录** 按钮会轮换签名密钥,一次性把所有浏览器与设备踢下线。

能放在 Tailscale、nginx 或 Caddy 后面吗?

不要。这些代理都从回环连进来,而中继把回环当作你本人,因此不会向任何人索要密码。要暴露到公网,README 的建议是:只转发中继的端口、绝不转发 Harness 的端口;用真实证书;设置 `compat.addressGrants: false` 与 `privilegedMethods: loopback-only`。也不要在 Harness 自己的端口上加指向中继源的跳转:桌面应用窗口无法完成到中继自签名证书的跳转,而这个失败对应用是致命的。

08数据与来源

  • 作者声明github.com62d7315bce02…

    dsh-relay is a plugin for the harness's web profile.

  • 作者声明github.com62d7315bce02…

    dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay

  • 作者声明github.com62d7315bce02…

    A settings page at **Plugins → dsh-relay → Configure** on the machine running the harness. Changes apply when you press…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。