DSH Plugins
返回列表
dsh-web-guard

dsh-web-guard

admin-security 更新于 2026.11.05

在终端中运行以下命令:

dsh plugin install lvxianchao/dsh-web-guard

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

在 DeepSeek Harness 中执行 dsh plugin install lvxianchao/dsh-web-guard 安装本插件(源码:https://github.com/lvxianchao/dsh-web-guard),安装后重启 dsh 即可由 bundle 自动挂载门禁。

插件介绍

把 DeepSeek Harness 的 Web 界面暴露到局域网或公网时,默认那套「进程里打印 ?token=、重启就换、还得去 journal 里翻」的进门方式,既不像正经登录,也不适合长期运维。更麻烦的是:前面挂 NPM、Caddy 等反代时,/api 常因 Host 被改写而 403;token 还会留在系统日志里;纯 HTTP 环境下浏览器缺少安全上下文,界面还可能因 crypto.randomUUID 不可用而直接报错。

dsh-web-guard 在 Harness 前面加一道代理式密码门:统一密码与会话,首次启动生成密码并哈希落盘;会话在服务端校验,浏览器只拿 HttpOnly Cookie,不再接触终端 token。它会把上游请求整理成 Harness 围栏认可的 loopback 形态,从而消掉典型反代 403;必要时注入 randomUUID 兼容垫片,让 HTTP 也能正常用 UI。认证发生在代理层——没有有效会话的请求到不了后面的 Harness。

插件监听 3081,只把流量转发到仅绑定回环的 Harness(默认 3080),并提供登录页、管理页(改密、会话策略、踢设备、全员登出等)。会话表会持久化到磁盘,重启 DSH 一般不会把已登录浏览器踢下线。这是单密码、单权限的前门,不是多用户系统;谁进门谁就相当于能在该主机上跑 Agent 的能力范围——与 Harness 产品设计一致。

适合已经或打算把 Web UI 接到反代、TLS 或内网 HTTP 上的自托管用户,尤其是希望用固定密码和可撤销会话替代 token、并认真把这道门当作唯一入口的人。若你曾把该地址暴露到公网,README 也强调:装好后不要随意卸载或禁用,应预留不经过此门的恢复路径(如控制台或独立 SSH)。

截图预览

使用场景

  • DeepSeek Harness Web UI 需要通过 NPM、Caddy 等反代对外提供访问
  • 希望用固定密码和可撤销会话替代每次重启生成的 terminal token
  • 在纯 HTTP 或公网/局域网暴露 UI 时需要统一入口并避免 /api 403

适合人员

  • 自托管 DeepSeek Harness 并启用 Web 配置文件的运维者
  • 在反代后部署 Harness 且遇到过 Host/Origin 相关 403 的用户
  • 把 Web UI 当作对外入口、重视登录与会话管理的个人或小团队