dsh-remote-portal

Name: dsh-remote-portal
Availability: InStock
Author: tsukii12

Remote access for DeepSeek Harness: scan-to-pair on your LAN, and public access through a relay you run yourself. 为 DeepSeek Harness 添加远程访问：局域网扫码配对，以及通过自建中转服务器公网访问。

Stars: 1
Language: JavaScript
Created: Oct 22, 2026
Updated: Oct 23, 2026

Tools

GitHub repo

Introduction

简体中文 · English

dsh-remote-portal

为 DeepSeek Harness 提供远程能力：局域网或公网远程访问。

功能 · 安装 · 更新 · 公网访问 · 安全 · 常见问题

DeepSeek Harness 只监听 127.0.0.1，用一次性启动令牌认证——离开这台电脑就用不了。本插件不改动 dsh 的任何机制，只在它前面加一道自己的门：独立端口上的网关，先验密码或一次性配对码，再转发给本机 dsh。

_{面板是主区域里的一个页面（和「插件」「自动化任务」同级），侧栏保持可用。}

功能


局域网一条地址	`http://<局域网IP>:3081/`，手机浏览器直接打开，不需要公网 IP 或端口映射
扫码配对	面板生成二维码，180 秒有效、一次即失效
公网访问	在你自己的服务器上跑中转，服务器主动拨出，得到稳定公网地址
密码与设备	scrypt 加盐、连错锁定、逐台设备撤销
移动端重排	侧栏变抽屉、对话框不溢出、长代码/宽表格/大图不撑破页面
服务器目录选择器	「添加工作区」列出服务器上的目录，可逐级进入、可新建文件夹
零依赖	只用 Node 内置模块，无构建步骤

_移动端

_侧栏抽屉

_{服务器目录选择器}

安装

从 DeepSeek Harness 安装（推荐）：插件 → 添加插件 → 填入

https://github.com/tsukii12/dsh-remote-portal

从命令行装：

git clone https://github.com/tsukii12/dsh-remote-portal
cd dsh-remote-portal
./install.sh            # macOS / Linux，装进 desktop + web profile
.\install.ps1           # Windows

使用国内镜像：

dsh plugin --profile desktop add \
  https://ghfast.top/https://github.com/tsukii12/dsh-remote-portal/archive/refs/heads/master.tar.gz

装完**重启 DeepSeek Harness **即可。

首次必做一步：侧栏 → 远程访问 → 设置访问密码。在此之前门户不会监听局域网。

更新

先移除，再安装：

dsh plugin --profile desktop remove dsh-remote-portal
dsh plugin --profile desktop add    https://github.com/tsukii12/dsh-remote-portal

Web端把 --profile desktop 换成 --profile web。

更新后必须重启 dsh：宿主侧代码（index.js、lib/*）只在启动时加载，光刷新页面只换到客户端一半。

锁定版本：

dsh plugin --profile desktop add https://github.com/tsukii12/dsh-remote-portal#v0.6.0

版本记录见 CHANGELOG.md。

公网访问

在你自己的服务器上跑中转（单文件、零依赖）。一条命令：

curl -fsSL https://raw.githubusercontent.com/tsukii12/dsh-remote-portal/master/tools/deploy-relay.sh | sudo bash

国内网络：

# 推荐：ghfast 代理
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/tsukii12/dsh-remote-portal/master/tools/deploy-relay.sh | sudo bash

# 备用：jsDelivr（可能滞后数小时）
curl -fsSL https://cdn.jsdelivr.net/gh/tsukii12/dsh-remote-portal@master/tools/deploy-relay.sh | sudo bash

脚本会自己下载 relay.mjs，探测环境、逐项提问（回车即默认），完成安装并注册 drp 命令。

交互式设置：

提问	说明
访客如何连接	`1) HTTP` 不加密 / `2) HTTPS`
HTTPS 用域名还是 IP	域名：配好证书后浏览器不报警；IP：自签证书，浏览器警告一次，之后照常加密
域名解析	填完域名会实际解析一次（优先问 1.1.1.1，避开本机缓存）：指向本机才继续；指向别处（如走了 CDN）会提示并让你决定继续还是换域名；没有 A 记录会提示先加记录
证书	`1) 自动申请，HTTP 校验`（需 80 端口空闲）/ `2) 自动申请，DNS 校验`（80 被拦也能签：Cloudflare 令牌或手工 TXT）/ `3) 我已有证书`（粘贴 PEM 或填路径）/ `4) 自签`（浏览器提示不安全）
端口	对外端口、中转端口（自动跳过已占用的；域名被 80/443 拦截时对外端口默认 8443）

⚠️ 选 HTTP 时，访问密码和全部会话内容（聊天、文件、命令输出）在公网上是明文。只有完全可信的局域网才该这么做。

管理命令：

$ drp
service     running · autostart on
uptime      2h 14m
agent port  1.2.3.4:9443 (TLS)
visitor     0.0.0.0:443 (TLS, self-signed)
endpoint    tls://1.2.3.4:9443
relay       reachable
tunnel      connected · 2 streams
traffic     in 8.0 MiB · out 7.9 MiB · 2140 requests · 3 clients
public      https://1.2.3.4/__t/ab12cd34ef56/

更新中转：再跑一次同一条命令即可——令牌与证书会复用，端口不会漂移。

面板里「中转服务器」只填 IP:端口（如 1.2.3.4:9443），协议自动识别（先试 TLS，失败回退明文）。完整部署见 docs/DEPLOY-SERVER.md。

安全

门户是唯一的门：没设密码就不会监听非回环地址。
会话 Cookie dsh_portal：HttpOnly、SameSite=Lax、绑定 UA，TLS 下自动 Secure。
门户自己的每个响应都带严格 CSP / X-Frame-Options: DENY；被代理的 dsh 响应一个字节都不改（有测试钉死）。
上游认证用宿主凭据在后台换取，令牌不出本机、不落日志、不回显面板。
明文 HTTP 下同网段可抓包看到 Cookie；介意就配 TLS 或走中转。

详见 SECURITY.md。

常见问题

远程端某些按钮点了没反应？

多数是只在桌面端有意义的入口（在资源管理器 / VS Code 中打开等）。

局域网打不开？

① 面板状态是否「运行中」；② 手机与电脑是否同一网段；③ 防火墙是否放行端口；④ 监听地址是否为 `0.0.0.0` 或 `auto`。

公网地址打不开？

一台中转可以接多台 dsh：`drp token add` 生成新令牌，`drp tokens` 列出所有隧道，`drp urls` 列出所有地址。

drp status 看隧道状态：offline 说明家里没连上中转（检查 9443 是否放行、令牌是否一致）；connected 但 503 说明反代缓冲（见部署文档排障表）。

撤销设备会踢掉 dsh 会话吗？

不会。撤销只让那台设备的门户 Cookie 失效，底层 dsh 身份是多设备共享的。

测试

node --test → 82 个测试，约 75 秒，网络路径不 mock：门户用真实监听端口，隧道用真实中转 + 真实 agent（覆盖 HTTP、HTTPS、WebSocket），二维码由独立解码器校验，移动层跑在测试自己启动的 dsh 上。缺少 Chrome 时浏览器测试会显式跳过。

兼容性


dsh 版本	`0.2.x`（在 `0.2.1-rc.2` 上逐项验证）
profile	`desktop`（Electron）与 `web`（`dsh web`）
系统	Windows / macOS / Linux
浏览器	Chrome / Edge / Safari 15.4+ / Firefox 121+

文档

ARCHITECTURE.md — 设计与实测宿主事实
docs/DEPLOY-SERVER.md — 服务端部署（systemd / Caddy / nginx / TLS）
CHANGELOG.md — 逐版本记录
SECURITY.md — 安全策略

已知限制

只在同一网络内可达，公网访问需要服务器进行中转；不做 NAT 穿透。

许可

MIT