dsh-auth-gate

English | 简体中文

给 DeepSeek Harness（dsh）网页版加一道登录门。部署到 公网 dsh 实例前面之后，不登录就没人能碰到你的 agent、聊天会话和 LLM 凭证。

它能做什么

• 所有访问都要先登录。 每个页面、每个 API 调用、每条 WebSocket 连接都会检查； 没有有效会话的访客会被带到简单的登录页（API/脚本请求则返回 401）。

• 两种登录方式（配置里二选一）：

  • 密码（推荐）：每个管理员一个用户名和密码。
  • 令牌：整个实例共用一个秘密令牌。

• 浏览器和脚本都能用。 浏览器走登录页；脚本和 curl 直接带 Authorization: Bearer <token> 就能跳过登录页。

• 默认就安全。 密码只存哈希、登录有限速（反复输错会临时锁定该地址）、会话 cookie 带安全属性，而且配置缺失或损坏时拒绝访问而不是悄悄开门。

• 一个管理用户的小命令行工具：

  dsh-auth user add admin --password-stdin   # 添加用户
  dsh-auth user list                          # 查看用户
  dsh-auth user disable admin                 # 禁止某用户今后登录
  

快速开始

# 1. 从 npm 装进你的 dsh profile。
#    0.4.1 起包声明了 dsh.bundle manifest，`dsh plugin add` 会同时自动注册挂载
#    （dsh.profile.bundles），无需手动写挂载行：
dsh plugin --profile web add dsh-auth-gate

# 2. 创建管理员账号
printf '%s\n' '选一个强密码' | dsh-auth user add admin --password-stdin

# 3. 开启密码登录：在 $DSH_HOME/cordis.patch.yml 里覆盖插件配置
#    （仓库自带现成配置覆盖模板 deploy/cordis.patch.yml，见下方"配置"——挂载本身
#    不需要手动 patch 行）

# 4. 重启 dsh，打开你的站点——会先要求登录。

效果预览

未登录的访客会被带到登录页：

登录后进入你的实例：

右上角有一个纯图标登出按钮——新会话页（还没有任何输入/响应时）在窗口右上角浮动显示：

在真实会话页里，它在会话头部右上角（Session log 按钮右侧）：

配置

bundle 挂载行（id dsh-auth-gate，由 dsh plugin add 自动插入）使用默认配置： mode: "token"，由 DSH_AUTH_TOKEN 环境变量提供共享秘密。要改配置，在 $DSH_HOME/cordis.patch.yml（或 profile 的 cordis.patch.yml）里按 id 覆盖—— 仓库自带现成覆盖模板 deploy/cordis.patch.yml。注意：覆盖条目不要带 insert （否则会二次挂载插件），只覆盖 config：

- id: dsh-auth-gate
  config:
    mode: "password" # "password"（推荐）或 "token"
    cookieSecure: true # 使用 https 时保持 true

选项	默认值	作用
mode	"token"	"password" = 用户名密码登录；"token" = 一个共享秘密
sessionTtl	604800	一次登录持续多久（秒），到期需重新登录
cookieName	dsh_auth	会话 cookie 的名字（很少需要改）
tokenRef	"DSH_AUTH_TOKEN"	仅令牌模式：共享秘密存在哪个环境变量里
cookieSecure	true	只在纯 http 测试环境设为 false
usersFile	""	密码模式：用户列表文件位置。默认 $DSH_HOME/auth/users.yaml

部署

• 反代部署指南 —— Caddy/nginx 配置、浏览器信任栅栏的坑 （反代后设置页 403，以及为什么只加认证修不了它）、推荐的半外壳拓扑。
• docs/deployment_zh.md —— 运维清单、验收步骤（A–I）与故障诊断。

环境要求

• 服务器上需要 Node ≥ 22.19 和 pnpm。
• dsh 的 web profile 正常运行（dsh --profile web）。
• 如果 cookieSecure 是 true，站点必须走 https（浏览器在纯 http 下会拒绝安全 cookie）。

许可证

MIT

注意事项与局限

• 禁用用户只阻止新登录；已经登录的会话要等它自然过期。
• 登录限速在服务器重启后清零。
• 反代部署时，限速按反代出口地址统计。
• 右上角有登出按钮：会话页在会话头部（Session log 右侧），新会话页在窗口右上角 浮动显示；/auth/logout?next=/ 始终可作为兜底。
• 本插件只保护 dsh 的网页入口，不能替代服务器层面的安全：请保持服务器系统用户最小权限、 配置文件私密（.credentials.yaml 和 auth/users.yaml 创建时即为 0600 权限）。