DSH Plugins Marketplace

DSH Plugins

Plugins

/

Security & Audit

/

dsh-admin-gate

d

dsh-admin-gate

Manifest valid

Password gate in front of the DeepSeek Harness web UI: admins sign in with a password stored only as a scrypt salted hash, and guests enter without one but are held to an allowlist of /api endpoints a

UI (client)hasBundlePatch

管理员密码(admin-gate)

English | 中文

给 DeepSeek Harness 装一道门——管理员输密码进入,访客免密码进入并按名单放行接口与工具,每个账号的对话互相看不见。

本项目由 AI 辅助生成,代码、测试、文档均由 AI 完成。欢迎自由使用、修改和分发。

安装

# 把仓库放进 profile 的依赖里
cd /root/.dsh/profiles/web
pnpm add link:/path/to/dsh-admin-gate

然后在 profile 的 package.json 里被 dsh.profile.bundles 引用:

"@local/dsh-admin-gate"

重启 Harness,或者用设置页的「插件」把 @local/dsh-admin-gate 关掉再打开。 装好后访问 /admin-gate 设第一个密码。

功能特性

  • 管理员密码:scrypt 加盐哈希,只存哈希不存明文
  • 访客免密进入:按下发的白名单只放行指定 /api 端点与 agent 工具
  • 多账号:可以有多个管理员,各自独立密码
  • 对话独立:每个账号只看得到自己开的对话;访客看不到任何管理员的
  • 无访客模式:把访客入口整个关掉,只有管理员能进
  • 三种模式:admin-only / guest / open,随时切换
  • 登录限流:10 分钟内错 5 次锁 5 分钟
  • 原子写入:状态文件先写临时文件再 rename,断电不会留下半个 json

三种模式

模式谁进得来用途
admin-only(默认)只有管理员无访客模式:门只给主人开
guest管理员 + 访客访客免密码,按名单放行
open所有人停用闸门,等于关掉这个插件

切到 admin-only 时,已经在场的访客会被立刻踢掉,不会挂着旧 cookie 继续用。

使用说明

  1. 第一次访问 /admin-gate,页面提示设置管理员密码(至少 4 位),输入后即进入
  2. 之后每次进 Harness:/ 会自动跳到 /admin-gate
  3. 在闸门页,或 Web 设置页的「管理员密码」分区里:
    • 改密码(改完会把别处的管理员会话踢掉)
    • 加减管理员账号
    • 切模式
    • 调访客名单

为什么闸门在 host 那边

客户端弹个全屏遮罩只能挡住眼睛,挡不住手:页面里的 fetch('/api/...') 照样能发。 所以真正的判定全在 host:

位置做什么
connection.admit / admitConnection / authorizeIndex闸门自己决定"你是谁":发一个带身份标记的 Peer(访客 / 某个账号)
connection/request没过闸门的 /api 一律 401;访客模式下再按端点白名单过一遍,越界 403
sessionController 方法包装会话方法按 sessionId 判归属,不是自己的拒绝或筛掉
tools.guard()访客触发的 agent 回合里,工具只放行白名单内的
webserver/index-inject页面一加载就 GET /admin-gate/api/state,没过闸门就整页换到闸门页
/admin-gate/*闸门页与它的 JSON 接口,不挂在 /api 下,不依赖 Harness 的 cookie

即使注入的那段跳转脚本被绕过,/api 那里的拒绝仍然在——页面只是外表。

对话归属:谁的对话谁才看得见

光拦 /api 端点不够。 session/list 放行给访客之后,访客看到的是所有 对话的标题;session/page 放行之后,只要知道 sessionId 就能读全文。端点名单 管的是"能不能调这个方法",管不了"这个方法返回的是谁的对话"。

所以另有一层归属判断:

层做什么
HTTP会话方法按参数里的 sessionId 判归属,不是自己的直接抛
流(WebSocket)session/follow 等流在打开时同样判一次
列表list / search 不报错,筛掉别人的条目(不暴露"存在但你看不到")
新建create 谁开的就记在谁名下

归属记在状态文件的 sessions: { "<sessionId>": "acct:<账号id>" | "guest" }。

  • 没登记的老对话算"无主",只有管理员看得见
  • 升级到 v3 时会一次性把磁盘上已有的对话划给最早创建的那个账号(那些本来 就是它开的),之后谁开谁领

给访客什么

默认名单刻意保守——这两个名单决定的是「主人身份能不能被借出去」,不该由插件替主人拍板:

  • 接口默认只读:会话列表/历史、工作区文件、模型目录、技能列表、settings/describe 等。 刻意不含 session/prompt——一放行访客就能让 agent 干活,而 agent 是以主人身份在这台机器上跑的。
  • 工具默认只有 web_search / web_fetch。不给 read / bash / write: read 能读 ~/.dsh 里的凭据,bash 能跑任何命令。

想让访客能聊天,就把 session/prompt 加进接口名单;想给读文件的权限,就加 read。都是显式选择。

状态存在哪

$DSH_HOME/admin-gate.json(默认 /root/.dsh/admin-gate.json):

{
  "version": 3,
  "mode": "guest",
  "accounts": {
    "<id>": { "name": "管理员", "salt": "...", "hash": "...", "n": 16384, "r": 8, "p": 1, "createdAt": 0 }
  },
  "sessions": { "session-abc": "acct:<id>" },
  "guest": { "endpoints": ["..."], "tools": ["..."], "customized": false }
}
  • 密码是 scrypt 加盐哈希,不存明文,也不进 profile patch(patch 会随升级被覆盖)
  • 忘了密码:删掉这个文件,重新打开 /admin-gate 会引导重设
  • 会话 token 只在内存里,Harness 重启后要重新过闸门
  • v1 的单个 password、v2 的旧结构都会在读取时自动迁移,不用手动改

更新历史

v1.2.2

  • 修:sessionController 和 connection 一样是后挂服务,插件启动时 ctx.get() 拿到 undefined,归属隔离那一整段被静悄悄跳过 —— 重启后访客能列出、能直读管理员 全部 143 段对话(/ 却是 200,看着一切正常)。同一个坑,隔一天换个服务又踩一次
  • 改成 ctx.inject(['sessionController'], …) 等服务就绪再包装,另加 10 秒看门狗, 真等不到才告警
  • 新增"服务晚到"回归测试(会真的把 controller 延后 10ms 再注入)

v1.2.1

  • 修:插件只声明依赖 webServer,启动早期 connection 还没挂上,身份层被整段跳过 —— 重启后访客打 / 是 401、隔离失效,而手动重载插件又一切正常(这种"重启坏、 重载好"的 bug 最会骗过测试)
  • 修:session/control 全站投影流没做归属过滤 —— Harness 自己的 allows() 对 owner principal 一律放行,而我们的 Peer 全是 owner,等于它一帧都不替我们挡
  • 两处都补了回归测试(identity.test.mjs 22 → 30 条)

v1.2.0

  • 修:访客根本没有自己的身份——Harness 的 browserAuth 在闸门之前就 401, 访客只能借管理员的 cookie 进来,用的还是 owner 身份,于是管理员对话全看得见
  • 新增身份层:包 connection.admit / admitConnection / authorizeIndex, 闸门自己签发带身份标记的 Peer
  • 新增归属层:状态升到 v3,sessions 表记录对话归属;包装 15 个会话方法按 sessionId 判归属,list / search 改成筛掉而不是报错
  • 新增 tests/identity.test.mjs(32 条):身份签发、归属隔离、多账号独立
  • 升级时自动把已有对话划给最早创建的账号

v1.1.0

  • 新增多账号:多个管理员各自密码
  • 新增无访客模式(admin-only 成为默认)
  • 修复 8 个 bug(见下)

v1.0.0

  • 首个版本:管理员密码、访客白名单、三种模式

已修的 bug

v1.1.0

#问题影响
1通配符 a*b 会把 ab 也放过去访客可能拿到没打算给它的端点
2畸形 cookie(%E4%)会抛 URIError一个坏 cookie 就能让整个请求 500
3所有访客共用同一个 guestPeer一个访客断开可能带走别人
4工具白名单用闭包旧 Set改完名单不生效,要重启
5每个请求都读盘慢,且并发写有竞态
6改密码后访客会话不清旧访客能继续挂着
7登录没有失败限制可以暴力猜密码
8状态文件非原子写写到一半断电会留下半个 json

v1.2.0 / v1.2.1 / v1.2.2

#问题影响
9访客没有独立身份,借用 owner 身份管理员所有对话对访客可见
10访客打开 / 是 401(连界面都看不到)访客形同不能使用
11端点白名单只管"能不能调",不管"返回谁的"知道 sessionId 就能读全文
12新开的对话没有归属记录访客能看到后来开的对话
13插件只声明依赖 webServer,启动早期拿不到 connection身份层整段被跳过:重启后访客 401、隔离失效,手动重载又正常
14session/control 全站投影流没做归属过滤白名单一旦放行 session/*,所有账号的会话标题都会漏出去
15sessionController 在启动早期尚未挂载,归属层整段被跳过重启后访客能读到管理员全部对话,而 / 返回 200 毫无异常

已知边界

  • 只在浏览器这条路上生效。本机命令行、API token(/connect 换出来的)不走这道门—— 它们本来就是主人自己在用,不是「远程访客」
  • 闸门页是自带样式的一页 HTML,不跟随 Harness 主题(它在 Harness 外面)
  • 访客判定按「这次请求是谁发起的」走 AsyncLocalStorage,并用 agent 归属兜底; 如果某个调用链完全绕开 HTTP(例如定时任务自己触发),它会像主人一样被放行

测试

node tests/gate.test.mjs      # 47 条:闸门、多账号、模式、白名单、状态迁移
node tests/identity.test.mjs  # 32 条:身份签发、会话归属隔离、多账号对话独立

两个都要跑。gate.test.mjs 里没有 connection / sessionController,所以身份与 归属那两层在那边是整段跳过的——只有 identity.test.mjs 真的覆盖到。

项目结构

admin-gate/
├── index.js                  # host 半边:闸门、身份、归属、闸门页
├── client.js                 # browser 半边:设置页的「管理员密码」分区
├── cordis.patch.yml          # bundle 声明
├── locale/{zh,en}.json       # 文案
├── icon.svg                  # 图标
├── tests/
│   ├── gate.test.mjs         # 闸门与状态
│   └── identity.test.mjs     # 身份与对话隔离
└── README.md

开源协议

MIT License

Comments

Loading…

Similar plugins

dsh-ui-auth

by 0QwQ0

Authentication gate for the DeepSeek Harness Web UI: login covers pages, /api, /plugins and WebSocket upgrades; PBKDF2 password hashing, HttpOnly SameSite session cookies, IP-based login lockout, a us

Security & AuditManifest valid

★ 15

↓ 668/wk

MIT

JavaScript

Oct 16, 2026

dsh plugin --profile web add dsh-ui-auth

Conversation lock for the DeepSeek Harness sidebar: every conversation row gets a lock button, and a locked conversation blurs only the conversation area behind a password box while the sidebar stays

Security & AuditManifest valid

★ 0

dsh plugin --profile web add dsh-session-lock

by TecFancy

Login gate for the DeepSeek Harness (dsh) web surface: password or shared-token authentication, session cookies, rate limiting, and a user-management CLI. | DeepSeek Harness (dsh) 网页版登录门插件:账号口令或共享令牌认证

Security & AuditManifest valid

★ 20

↓ 810/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile web add dsh-auth-gate

by binskyz

DSH 插件:本地加密凭据库 + 无头浏览器登录态 + 带登录态抓取(贴吧/NGA/Pixiv/书屋),含浏览器密码迁移与设置页

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 2

MIT

JavaScript

Nov 10, 2026

dsh plugin --profile web add dsh-yunpa

Registers a `deepseek-web` provider that drives your own signed-in chat.deepseek.com account as an extra model in DSH, so no Open Platform API key is needed: the sidebar footer lists your Web conversa

Models & ProvidersManifest valid

★ 7

NOASSERTION

TypeScript

dsh plugin --profile web add dsh-deepseek-web-free

by SteelUnion

DeepSeek Harness gate - per-turn persistent-operation counter: remind, instruct the model to stop, then ask for confirmation. Steps aside under sandbox/read-only modes; follows a live permission switch without restart. Verified on real hardware (full -> workspace-write -> read-only -> full). Crafted on an estimated 0.27 USD of model spend.

Security & AuditDevelopment & InfrastructureManifest valid

★ 101

MIT

JavaScript

Nov 1, 2026

dsh plugin --profile web add @sroada/dsh-confirm-gate