🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
市场 / 管理·7 次阅读·多端远程访问 插件页

远程访问 DSH 的四种连接方式,为什么先试局域网

把工作电脑上的 Harness 搬到另一台设备上接着用,第一反应通常是「开个端口映射」。方向从第一步就偏了:ds-harness-remote 的 Host 只建立出站连接,不监听公网端口,也不需要公网 IP 与端口转发;它让客户端与 Host 协商出一条端到端加密通道,再把请求转成对本地 Harness 原生 API 的调用。

把工作电脑上的 Harness 搬到另一台设备上接着用,第一反应通常是「开个端口映射」。方向从第一步就偏了:ds-harness-remote 的 Host 只建立出站连接,不监听公网端口,也不需要公网 IP 与端口转发;它让客户端与 Host 协商出一条端到端加密通道,再把请求转成对本地 Harness 原生 API 的调用。它不传画面,也不开放通用工具 RPC 与桌面控制——换掉的是设备,不是桌面。

站内收录的 liguobao/ds-harness-remote 当前 2,137 星、综合分 70.5,验证档位为已验证(L4 · 真实安装,数据截至 2026-09-27,dsh 0.2.0-rc.2),npm 周下载 2,328(npm 全网,含 CI 与镜像,不是本站安装数),版本 0.6.3,许可 MIT。这些数字只说明它装得上,不说明你的网络能直连。

出站连接决定了排查的起点

Host 只主动向外出连,所以在它上面找不到监听 0.0.0.0 的端口是正常的。业务流量固定使用 Noise_IK_25519_ChaChaPoly_SHA256,在客户端加密、只有被选中的 Host 能解密。

服务端也不是什么都看不到:它能读到设备归属、在线状态、连接时间与 connectionId 这类控制元数据,读不到 Prompt、对话内容、工具输出、工作区路径与文件预览内容。准确说法是「只中继密文,但看得到连接层元数据」。

读到这里,如果对你有帮助
不解锁内容

四层选路:LAN → P2P → TURN → Relay

四层依次协商,前一层不通才试下一层,承载同一份 Noise 密文。

Client ──① LAN ──────► Host                 同网段直连,数据不出局域网
       ──② P2P ──────► Host                 NAT 打洞,协商后点对点
       ──③ TURN ─────► coturn ──► Host      中继,占用中继带宽
       ──④ Relay ────► WSS ─────► Host      加密 WebSocket 兜底
第一层 LAN:条件最苛刻,收益最大

现象:同办公室同 Wi-Fi 下几乎瞬时,切到 4G 立刻变慢。原因:要求两端在可互通网段,这条路上除协调指令外,数据不经过服务器。解决:把同网段当第一优先级;跨 VLAN、AP 隔离、访客网络互访限制都会让它失效,失效只是继续往下协商。

第二层 P2P:省掉中继,依赖打洞成功

现象:跨网络也能连,延迟明显低于中继。原因:依赖 NAT 穿透,两端 NAT 类型配合得好就点对点直连。解决:无需额外配置,连不上就让它降级,别用端口映射去帮它打洞。

第三层 TURN:可用,但要自己准备 coturn

现象:默认托管偶尔走中继,自建 Server 时这层不可用。原因:TURN 用开源 coturn,默认托管由官方提供,自建要自己架。解决:确认 coturn 在跑、凭据签发成功;不打算维护就接受 Relay 兜底。

第四层 Relay:加密 WebSocket 兜底

现象:限制 UDP 的网里仍能连上,延迟稳定偏高。原因:WebRTC 不可用或失败时降级到加密 WebSocket Relay,服务端只转发密文。解决:当保底而非故障,代价是流量过服务端、受带宽与地域影响。

两道校验:账号归属与设备身份

连接要同时通过同账号 membership 与本地固定的设备 identity key:前者回答「是不是这个账号的设备」,后者回答「是不是原来那台」。同账号设备连接无需逐次确认,但身份不能凭空生成;移除设备后凭证、membership 与已建立连接一起失效。这两道门校验的是账号与设备,不是「这个人是否可信」。

降级是单向的,不等于自动修好

四层依次探测,不是并行择优:连上了但很慢,通常落在 TURN 或 Relay;一直卡在 Relay,说明打洞与 UDP 都被挡,改 Host 配置没用。降级保证可用性,不保证性能。

加密保护的是传输,不是授权

端到端加密保证链路上第三方读不到内容,但不改变「谁能操作什么」:交互终端以 Host 用户身份运行、读 Host 本地的 terminal.enabled(默认开启),且独立于 Agent 审批;工作区选择器只列出文件夹并返回只读目录元数据;远端文件预览不能写入、删除、上传、执行。

四个常见的判断错误

坑一 · 按端口映射的思路排查连通性

现象:在 Host 上扫不到端口,判断服务没起来,转而去装 frp。原因:Host 不监听公网端口;端口映射走服务端 TCP 转发,流量必须过服务端,反而把带宽压在那里。解决:先确认 Host 在线、账号同一、客户端能否列出这台 Host,再看它落在哪一层。

坑二 · 以为自建 Server 等于官方同款

现象:按最小 Server 自建后某些托管能力缺失,怀疑配置漏了。原因:最小 Server 含 LAN/P2P/TURN 协调与加密 Relay,但暂不支持托管 Remote Web 的完整功能,TURN 还要自己部署 coturn。解决:先明确要「能连」还是「和官方一致」。

坑三 · 旧版 Harness 的 Host 连不上,先怀疑网络

现象:Host 始终不出现或出现后连不上,换网络、重启插件都无效。原因:已移除对 Harness 0.1.1-rc.2 ApiProxy 的兼容,仅提供 ApiProxy 或不支持能力发现的旧 Host 会被直接拒绝,不再降级。解决:核对 Host 侧版本,当前基线 dsh-v0.2.2-rc.1,0.2.1-rc.5 与 0.2.0 的 rc.2 / rc.1 继续兼容;低于这条线要升级。

坑四 · 把远程终端当成另一个审批窗口

现象:以为终端命令走审批,随手把 Remote 分享给协作方。原因:终端以 Host 用户身份运行、读本地 terminal.enabled,独立于 Agent 审批;Linux 一键安装配 systemd 服务,Host、Agent 工具与远程终端都带 root 权限。解决:按「能连上就等于能在这台机器执行命令」评估风险,只对可信账号开放。

总结

四层顺序本身就是排障顺序:先看同网段能否直连,再接受降级,最后才怀疑授权与版本。想对照同类插件的中文清单与安装形态见 DeepSeek Harness 插件榜单。

适合与不适合

适合:在外面接续工作电脑上的会话;多设备连同一台 Host;不开放公网端口就想访问本地工作区。

不适合:需要完整远程桌面;要求任何网络都保持直连延迟;要把 Host 分享给不完全信任的账号。

标签:ds-harness-remote、DeepSeek Harness、远程访问、端到端加密

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

60 秒视频版 · AI 辅助生成并人工校对
这篇内容有帮助吗
赞赏随意,不解锁任何内容,也不必留个人信息。
扫码用
查看 多端远程访问 插件详情
安装命令 · 中文 README · 兼容性报告
前往插件页 →
回到顶部