DSH Plugins
返回列表
🧩

dsh-pairing-gate

admin-security 更新于 2026.10.29

在终端中运行以下命令:

dsh plugin install chjy090/dsh-pairing-gate

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install chjy090/dsh-pairing-gate(源码:https://github.com/chjy090/dsh-pairing-gate),安装后按 README 重启 dsh 并完成首次初始化。

插件介绍

在 DeepSeek Harness 前面加一道「第二道门」,是很多单人自用部署的真实需求:你希望从局域网、内网穿透或公网访问 dsh,又不想把后台完全裸露在 3080 端口上,同时希望登录强度足够、又不必每次输入 TOTP。本插件 dsh-pairing-gate 正是为此设计的前台认证网关——认证通过后把 HTTP 与 WebSocket 反代到 dsh,未认证的浏览器拿不到 launch token 与会话 cookie。

它的认证模型是「设备绑定即第二因素」:新设备先在管理端用 6 位 TOTP 授权生成配对二维码,扫码或打开链接完成绑定;之后这台设备只需用户名与密码即可登录。改密或重置 TOTP 会撤销全部设备与会话,需要重新配对,适合把「可信设备」和「日常登录」分开管理的场景。配套 DSH-Mobile 时,App 扫码配对只接受 HTTPS 配对 URL,网关与 publicUrl、证书指纹的配置需要与生产拓扑一致。

除登录与反代外,插件还提供浏览器初始化向导、/__admin 管理页,以及 dsh 侧边栏原生「认证管理」面板:账号与 TOTP、配对二维码、设备与会话吊销、监听地址与对外 publicUrl、审计与限流等能力都在 README 描述范围内。默认是本机 127.0.0.1:3443 明文 HTTP 试用配置;跨机、公网或 App 配对需要按文档配置 TLS 与 publicUrl,并注意 loopback 监听时的安全提示。

适合已经或打算自建 dsh、希望用网关统一对外入口、并采用扫码配对 + 密码的单用户安全模型的运维者与个人用户。若你只需要密码或共享令牌式登录与用户管理 CLI,那是另一个同名生态下的不同项目,与本插件功能不同。

使用场景

  • 希望对外只暴露网关端口,认证后再访问本机 dsh
  • 新手机或浏览器需扫码配对一次,之后用用户名密码登录
  • 通过 frp 或反向代理公网访问,并配置 HTTPS 配对链接

适合人员

  • 自建 DeepSeek Harness 的单人运维者
  • 需要设备绑定作为第二因素的自用部署用户
  • 计划配合 DSH-Mobile 做扫码配对的 Android 用户