DSH Plugins
返回列表
🧩

dsh-webui-auth

admin-security 更新于 2026.10.30

在终端中运行以下命令:

dsh plugin install multidsh/dsh-webui-auth

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

在 DeepSeek Harness 中执行 dsh plugin install multidsh/dsh-webui-auth,从 https://github.com/multidsh/dsh-webui-auth 安装 WebUI 身份认证插件后重启 DSH 即可生效。

插件介绍

把 DSH WebUI 暴露在局域网或反代后面时,默认谁都能打开界面、调接口、挂 WebSocket——这在共享环境或公网入口上几乎不可接受。dsh-webui-auth 是持久化组合插件,在 HTTP/传输层把整站收成「先登录、后一切」:未认证的浏览器拿不到 SPA 与静态资源、/api 与 /plugins 返回 401、实时连接升级也会被拒绝,且不能靠前端改请求绕过。

实现上它不碰 DSH 核心源码,而是在运行时包装 webServer 路由:WebUI 兜底走会话校验后转交静态前端,API 与插件 bundle 与同前缀 exact 路由一并纳管,并带 fail-closed——路由包装不完整时拒绝启用认证,避免「开了登录却裸奔 /api」。会话写在磁盘(重启仍有效),HttpOnly Cookie 携带;首次创建管理员需启动日志里的 setup token,支持审计、限流与密码策略,并与 v0.1.2-alpha.2+ 核心自带浏览器认证协作完成 token→Cookie 交换。

它还针对常见部署做了适配:反代改写 Host 时用 X-Forwarded-Host 修正登录跳转;非回环域名需配合 trustedHosts;DSH Desktop 走宿主直连桥与界面级锁,避免 shell 丢弃 Cookie 导致启动失败。适合自托管、需要给 WebUI 加一道独立口令闸门的操作者——尤其用浏览器验证传输层门禁时,用 dsh web 打印的地址或反代域名访问即可。

使用场景

  • 局域网或内网暴露 DSH WebUI,需要口令才能访问
  • nginx 等反代后对外提供 WebUI,并修正 Host 改写下的登录跳转
  • 多人共用一台机器或家庭 NAS 上跑 DSH,防止未授权操作

适合人员

  • 自托管 DSH 并希望独立 WebUI 登录闸门的用户
  • 负责服务器安全、需要传输层强制认证的管理员
  • 使用反代或公网入口并配合 trustedHosts 部署的操作者