dsh-rgate

dsh-rgate

English | 中文

DeepSeek Harness Web UI 的远程访问登录门禁。给整个浏览器界面加上密码墙：公网（非回环）匿名访问只能看到登录页，登录前所有 /api RPC 一律拒绝。

为什么需要它

Harness 自带的浏览器信任围栏（trustedHosts）是防 DNS 重绑定的可达性策略，不是认证——只要 Host 头通过围栏，任何人都能使用 Web UI。本插件为自托管部署补上缺失的认证层：IP 扫描器撞到的是登录页，而不是你的 agent。

功能

• 全页登录墙——通过 webServer.tapIndex 向每个 index.html 注入门禁脚本；未登录的非回环访问被重定向到 /rgate-login（自包含登录页）。
• 全量 /api 门禁——新版 Harness 由官方自身对 /api RPC 面鉴权（无凭据一律 401），rgate 不再代理或遮蔽这些路由，只注册自己的 /api/remote-auth.* 端点与 /rgate-login；回环直通，非回环访客必须持有会话 cookie，否则被注入的门禁脚本重定向到登录墙。
• Cookie 会话——rgate_session，HttpOnly + SameSite=Strict，7 天内存会话；登出与改密会吊销全部会话。
• 免 ?token= 访问——Harness 本体（dsh-client-connection）默认只认进程 token 换来的 cookie：不带 ?token=<launchToken> 的地址一律 401，每次访问都得先找到那行 URL。登录墙通过后，rgate 额外签发一枚同格式的 HMAC 签名 cookie（rgate_auth，密钥 ~/.dsh/.rgate-signing.key），并让本体的 isAuthenticated 用同一密钥验证它、让 authorizeIndex 放行 index——于是直接访问域名就能落到登录页，登录后 ?token= 不再需要。/api 仍要求签名，匿名请求依旧 401。
• 登录限速——每客户端 5 次失败后指数退避（30 秒起翻倍，上限 16 分钟）。在 Cloudflare Tunnel 之后，客户端键取 Cf-Connecting-Ip（回退 X-Forwarded-For、再回退 socket 地址），攻击者无法把所有人一起锁死。
• 审计日志——登录成功/失败/锁定、改密事件写入 harness 日志（journald），不含密码。
• 哈希密码存储——~/.dsh/remote-auth.json（0600）内以 scrypt（N=16384, r=8, p=1）+ 随机盐 + 常数时间比较存储；旧版明文文件自动迁移。忘记密码：删除该文件并重启服务，新密码会在服务日志中打印一次。
• Remote Access 设置分区——settings.section 条目：门禁状态、登录/登出、改密。密码不再明文展示（哈希存储设计使然）。
• Origin 校验——登录/登出/改密端点拒绝跨站表单提交。

安装

从 GitHub 安装（纯 ESM，无构建步骤、无安装脚本——安装时不会执行任何代码）：

dsh plugin --profile web add github:raomaiping-hash/dsh-rgate

如需可复现安装，可锁定 commit sha：dsh plugin --profile web add github:raomaiping-hash/dsh-rgate#<commit-sha>——后续推送无法悄悄改变你机器上运行的内容。

从 npm 或 tarball 安装：

dsh plugin --profile web add dsh-rgate              # npm
dsh plugin --profile web add ./dsh-rgate-0.1.0.tgz  # tarball

随后重启 web profile。插件激活时打印 [rgate] 门禁已启用 …，首次启动会在 ~/.dsh/remote-auth.json 生成随机密码：

journalctl -u deepseek-harness | grep rgate

配置

门禁本身没有配置文件，两个行为约定需要了解：

• 回环永远可信。127.0.0.1 / localhost / ::1 不设墙——这是管理员通道。
• 其他所有 Host 一律要求登录（局域网、Tailscale、公网域名一视同仁）。想要免登录入口，请在上游保护它（见下）。

密码文件位于 $DSH_HOME/remote-auth.json（默认 ~/.dsh/remote-auth.json——遵循 harness 约定，与 settings.yaml 同层）：

新增的 HTTP 端点

已知边界

• WebSocket 事件流不受门禁。/api/events.mux 与 /api/events.host 的升级由内置 dsh-client-connection 持有：重复注册同名 upgrade 会抛错、抢先注册会打断启动。通过围栏的客户端仍可连接并收到实时会话事件帧。稳妥的修法在上游：给公网域名启用 Cloudflare Access（Zero Trust），或在前面放一个带认证的反向代理（如 nginx auth_request）——在流量到达 Harness 之前就把 UI、API、WebSocket 全部封闭。
• **/api 方法表不归本插件维护。**Harness 原生 /api 鉴权（无凭据一律 401）会覆盖新增 RPC，rgate 从不遮蔽该方法表。
• **会话在内存中。**Harness 重启会登出所有人（否则 7 天有效）。
• 静态资源对未登录访问者仍可见（它们是公开代码）；所有数据都在 API 门禁之后。

威胁模型

门禁是单密码、个人/小团队部署的认证层。前提是 Harness 进程与主机文件系统可信——能读到 remote-auth.json 或进程内存的人已经拥有主机。它不能替代系统/网络卫生、HTTPS 终结，或公网入口处的上游访问控制。

测试

tests/smoke.mjs 在隔离的 HOME 里用桩 context 驱动插件的真实路由处理器（不碰真实凭据）：

node tests/smoke.mjs

许可证

MIT

设置面说明

Harness 0.1.2-rc.2+ 将设置面（模型提供方、凭据、预设编写）限制为仅限本机页面，等待真实认证层。rgate 正是这层认证：每次启动会幂等地重打一行客户端补丁，让已登录的远程浏览器正常使用设置；未登录访客仍被登录墙拦截。锚点表达式（@deepseek-ai/dsh-client-ui-settings/lib/client.js 中的 ctx.remote.$host.isLoopback ? "host" : "memory"）已在 Harness 0.1.5-rc.2 上重新核实。原文件会在目标旁自动备份（client.js.rgate-backup），Harness 每次升级后补丁自动重打。