relay

Discovered

Zero-knowledge WebSocket relay for DSH Remote Control: routes sealed records between the host plugin and paired phones, never parses payloads. Single-file bundle, self-hostable, Docker image. Zero-knowledge WebS

Machine translated

@dsh-remote/relay

DSH Remote Control 的零知识 WebSocket 中继：在宿主插件与已配对的手机之间转发密封记录，只认帧名 / 会话 id / 协议版本闸，从不解析载荷——密文对它就是一个 base64 字符串。

生产形态是单文件产物 dist/bundle/main.js（ws / zod / 协议层全部内联，运行时零依赖）；部署只有两种：拷这个单文件 + 起进程（systemd / docker / nginx 配方见下），或从源码构建。

自托管

完整配方（环境变量表、systemd / docker / nginx、排错、升级）见 docs/SELF-HOSTING.md。最速验证：

DRC_HOST_TOKEN=<与主机插件一致> node dist/bundle/main.js
curl -s http://127.0.0.1:8787/healthz

常用配置

变量	必填	默认	说明
`DRC_HOST_TOKEN`	✅	—	主机出站认证凭据。`openssl rand -hex 32` 生成。与主机插件那份必须逐字一致
`DRC_PORT`		`8787`	监听端口。`0` = 让系统分配（测试与容器用）
`DRC_BIND`		`127.0.0.1`	绑定地址。默认只绑回环：TLS 由反代终止。只有自己就是边缘（容器直接发布端口）时才设 `0.0.0.0`
`DRC_PUBLIC_URL`		空	`/api/info` 返回的对外地址。公网填 `wss://你的域名`
`DRC_LOG_LEVEL`		`info`	`debug` / `info` / `warn` / `error` / `silent`。区分大小写
`DRC_PAIR_TTL_MS`		`120000`	配对码的服务端权威寿命（毫秒）
`DRC_MP_APPID`		—	小程序 appid。与 `DRC_MP_SECRET` 同时配置才启用 `GET /code`（生成小程序码）；不配则插件回退旧 `dshr:` 码
`DRC_MP_SECRET`		—	小程序 secret。只放在中继，永不进插件包；换了 secret 记得同步这里
`DRC_MP_ENV`		`release`	小程序码打开哪一版：`release` / `trial` / `develop`。新版只上了体验版时必须设 `trial`，否则码把用户带进老版本（能扫进去、配对必失败）
`DRC_STATE_FILE`		空（关闭）	会话表落盘路径。默认关闭 = 纯内存；配上后启动先读它、会话表有增删时写回
`DRC_STATE_SAVE_MS`		`60000`	周期补写状态文件的间隔（只为刷新 `lastActivityAt`）
`DRC_MAX_BUFFERED_BYTES`		`1048576`	慢消费者阈值：发送缓冲区连续超限达本角色窗口才 1008 断开
`DRC_SLOW_CONSUMER_HOST_MS`		`10000`	主机侧慢消费者窗口（毫秒）。主机卡住就是所有人卡住，所以窗口短
`DRC_SLOW_CONSUMER_CLIENT_MS`		`45000`	客户端侧慢消费者窗口（毫秒）。必须大于手机自己的重连周期（≈42.5 秒）

端点

路径	说明
`GET /healthz`	运维契约（二十四个字段）：`ok` / `version` / `uptimeSec` / `hosts` / `clients` / `conversations` / `pendingPairs` / `hostTokens` / `droppedFrames` / `slowConsumers` / `rejectedPairs` / `shutdownForced` / `persistence` / `stateRestored` / `stateSavedAtSec` / `stateWrites` / `stateWriteFailures` / `lastPingAgo` / `shuttingDown` / `protocolSelf` / `protocolMin` / `peerProtocolMin` / `peerProtocolMax` / `peersNoProtocol`
`GET /api/info`	`{"publicUrl","protocol"}`
`GET /api/pair-status`	默认 404。无需认证地回答"配对码 N 是否有效"等于给 6 位码空间装了扫描 oracle；确需调试时 `DRC_PAIR_STATUS=1`，用完关掉
WebSocket	路径不设限，任意路径都能升级

落盘五字段（persistence / stateRestored / stateSavedAtSec / stateWrites / stateWriteFailures）是"还在落盘"的唯一读数——换机器先看 stateWriteFailures，不是 0 就是没在写。

开发

pnpm install
pnpm build        # tsc + 单文件打包
pnpm test         # tsc + 打包 + node --test（含产物级判据）

红线

不 import 载荷：依赖图里只有协议层的 frames / ids / negotiate / outbound；构建产物里不许出现任何密码学实现——tests/bundle.test.mjs 直接读产物断言。
路由表是内存的：重启即全部作废（客户端会看到 unknown_session），这是设计不是缺陷。
日志永不落载荷、落完整配对码、落 hostToken（有判据锁住）。
本包不发 npm：private: true，发布流程里不许出现发包步骤与 id-token（有判据）。

许可

MIT

Comments

Loading…

Similar plugins

dsh-pocket-relay

by kinderao

Phone and remote access to the DSH Web UI: scan a LAN QR code, or reach your PC from anywhere through a self-hosted relay server you run yourself instead of a cloudflared tunnel. Per-device credential

Tools & CapabilitiesManifest valid

★ 4

GPL-2.0

JavaScript

Sep 17, 2026

dsh plugin --profile web add dsh-pocket-relay

dsh-relay

by SunNull

Cloud relay for DeepSeek Harness: expose your home dsh instance to any device with full real-time sync (out-of-tree plugin + wire-trunk architecture)

Manifest valid

★ 0

MIT

JavaScript

Aug 24, 2026

dsh plugin --profile web add dsh-relay-host

dsh-remote-link

by BotonJ

Authenticated remote gateway for DeepSeek Harness: QR/HMAC pairing, cookie sessions, mDNS, fork_session tool. Zero-dep plugin.

Tools & CapabilitiesTerminal & ClientsSessions & MessagesManifest valid

★ 6

MIT

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-remote-link

dsh-full-remote

by JUANWANG-BUAA

Auditable, token-gated DeepSeek Harness remote gateway: mobile QR access, per-device sessions, Host/Origin rewrite, settings/credentials/directory support.

Security & AuditManifest valid

★ 49

MIT

TypeScript

Oct 17, 2026

dsh plugin --profile web add dsh-full-remote

dsh-remote-access

by zergtant

DeepSeek Harness (dsh) 远程访问插件：提供 TLS、登录认证、会话保护和 HTTP/WebSocket 透明反代，支持局域网及 FRP ，cloudflare隧道等远程访问。

Development & InfrastructureManifest valid

★ 0

MIT

JavaScript

Sep 13, 2026

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

DSH-Remote-plugin

by AKHYui

DeepSeek Harness desktop plugin that exposes a local harness to your own relay over a single outbound WebSocket - no inbound ports, works behind NAT. Forwards a fixed op allowlist, session events, pro

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Oct 18, 2026

dsh plugin --profile web add dsh-remote-bridge