DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

demoliisher /

demoliisher/dsh-remote-over-tailnet

Verified

基于 Tailscale 的 DeepSeek Harness 远程访问插件,自带内嵌节点,不依赖系统安装的 Tailscale

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@3641ab39

Remote Over Tailnet

CI

项目全名 dsh-remote-over-tailnet,文档中简称 ROT。

ROT 是 DeepSeek Harness Desktop 的 Host 插件,主要面向 Windows 上的 DeepSeek Harness Desktop 用户:开启中继服务后,同一 tailnet 内的 DSH Remote 客户端可以继续操作本机正在运行的会话,逐字流式输出保持原样,电脑不需要公网 IP、端口映射或第三方网关。DSH Go 是其中一个安卓客户端,任何接入 DSH Remote 的程序都可以连接。

衍生自 MIT 项目 ds-harness-remote。ROT 去掉了对公共网关的依赖,改为在本机启动中继服务器,再由插件内嵌的 Tailscale 节点(编译成 WebAssembly 的 tsnet)把它接入 tailnet。客户端只需填写侧栏入口弹窗里的地址和账号密码。

前置条件

  • Windows 上的 DeepSeek Harness Desktop 0.2.2-rc.1 或兼容版本
  • 一个可用的 tailnet 账号;本机如何加入 tailnet 由插件自己完成,不需要安装系统 Tailscale
  • 客户端设备与电脑在同一个 tailnet,且已安装 Tailscale;客户端需支持 DSH Remote(例如安卓上的 DSH Go)

安装

把 ROT 装进要对外提供远程访问的那个 profile。DeepSeek Harness Desktop 启动的是 desktop profile,dsh web 命令行服务启动的是 web profile,两者互不相干。装完重启 DeepSeek Harness Desktop:

dsh plugin --profile desktop add dsh-remote-over-tailnet

也可以在插件页点「添加插件」(Add plugin)选中已经构建好的插件目录,这种方式适合自己构建的用户,构建步骤见开发、构建与本地验证。仓库里不保存构建产物,直接克隆源码的目录装不了。

使用

  1. 安装 ROT,重启 DeepSeek Harness Desktop。
  2. 打开「插件 → Remote Over Tailnet → 远程设置」,在「DSH Remote 本地中继服务」那一行右侧打开开关。
  3. 首次开启时,左下角「Remote Over Tailnet」入口的弹窗给出授权链接,在浏览器里点开并登录 tailnet 账号、同意加入;授权完成后弹窗里出现服务地址。
  4. 弹窗会显示 DSH Remote 服务器地址、账号与密码。在客户端中添加自定义服务器,填入这三项登录。
  5. 要在 DSH Go 里用 SSH 直连(不经过中继、也不经过第三方服务器),在同一个弹窗的「SSH 服务」那一行右侧打开开关,把「通用连接信息」里的地址、账号、密码,加上 SSH 端口 22 与 DSH 登录令牌填进 DSH Go 的「添加 SSH 主机」,实例管理选「只连接」。这一步不要求「中继服务」开着,两套服务各自独立。详见 SSH 直连。

插件开启中继服务时会自动完成这些步骤,不需要命令行:

  • 启动内嵌 Tailscale 节点,节点名固定为 dsh-remote,首次需要一次浏览器授权(也可以在配置里填 tailnet.authKey 跳过这一步)
  • 生成中继账号与密码,保存在 $DSH_HOME/dsh-remote-over-tailnet/tailnet/(权限 0600)
  • 在 127.0.0.1:8080 启动中继服务器
  • 让内嵌节点在 tailnet 内监听 80 端口并转发到本机中继

中继只监听回环地址,tailnet 内的节点通过 WireGuard 访问 http://dsh-remote.<你的 tailnet>(地址里不写端口)。

配置

键 默认值 说明
serverUrl http://127.0.0.1:8080 中继地址,必须是 http 回环地址,端口即中继端口
tailnet.enabled true 关闭后不启动内嵌节点、不启动中继
tailnet.authKey 空 可选的 tailnet 授权密钥,填了就跳过首次的浏览器授权
tailnet.dataDirectory $DSH_HOME/dsh-remote-over-tailnet/tailnet 账号密码、内嵌节点状态、relay.lock、relay.log 与中继 state.json 的存放目录,可改到其他磁盘
ssh.enabled false 在 tailnet 节点上再开一个 SSH 监听,只放行到当前 DSH Web 端口的隧道

身份目录按 serverUrl 的 origin 做哈希,改变中继端口等于更换 Host 身份,因此端口应保持稳定。

限制

  • 内嵌节点只提供 tailnet 内的访问,不做 Funnel,tailnet 之外的设备连不上。
  • 可以和上游插件 ds-harness-remote 同时安装:控制接口与界面用本插件自己的名字,dshRemote 服务名让给上游插件。一个 profile 里保留一个远程入口即可。详见 Tailscale 要求与排障。
  • 不修改客户端,也不支持扫码配对,需要在客户端中手动填写服务器地址与账号密码。本插件面向所有接入 DSH Remote 的客户端,DSH Go 只是其中之一。
  • 本插件与 Tailscale Inc.、DeepSeek 均无关联,未获其背书。

更多文档

  • SSH 直连
  • Tailscale 要求与排障
  • 开发、构建与本地验证

许可

MIT。保留上游 LICENSE 与 NOTICE,详见 LICENSE 与 NOTICE。

—/ 5

No ratings yet

Verified DSH bundle

Commit 3641ab39c451

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout