dsh-admin-gate
Manifest validPassword 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
管理员密码(admin-gate)
给 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 继续用。
使用说明
- 第一次访问
/admin-gate,页面提示设置管理员密码(至少 4 位),输入后即进入 - 之后每次进 Harness:
/会自动跳到/admin-gate - 在闸门页,或 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.mjs22 → 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、隔离失效,手动重载又正常 |
| 14 | session/control 全站投影流没做归属过滤 | 白名单一旦放行 session/*,所有账号的会话标题都会漏出去 |
| 15 | sessionController 在启动早期尚未挂载,归属层整段被跳过 | 重启后访客能读到管理员全部对话,而 / 返回 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
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
★ 15
↓ 668/wk
MIT
JavaScript
Oct 16, 2026
dsh plugin --profile web add dsh-ui-authConversation 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
★ 0
dsh plugin --profile web add dsh-session-lockby 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) 网页版登录门插件:账号口令或共享令牌认证
★ 20
↓ 810/wk
MIT
TypeScript
Nov 17, 2026
dsh plugin --profile web add dsh-auth-gateby binskyz
DSH 插件:本地加密凭据库 + 无头浏览器登录态 + 带登录态抓取(贴吧/NGA/Pixiv/书屋),含浏览器密码迁移与设置页
★ 2
MIT
JavaScript
Nov 10, 2026
dsh plugin --profile web add dsh-yunpaRegisters 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
★ 7
NOASSERTION
TypeScript
dsh plugin --profile web add dsh-deepseek-web-freeby 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.
★ 101
MIT
JavaScript
Nov 1, 2026
dsh plugin --profile web add @sroada/dsh-confirm-gate