dsh-server-login

面向公网的多租户 DSH 托管平台 —— 部署到一台公网服务器后，多个用户注册并经管理员审核，各自获得一套相互隔离的 DeepSeek Harness（DSH）环境，随时通过域名安全访问（已适配手机端）。

以 DSH 插件市场 的 cordis-plugin 形态分发，遵守 STANDARD.md。

它解决什么

DSH 本身是单用户本地工具：没有认证、没有多租户隔离、Web 远程访问缺认证层。dsh-server-login 在其之上补一层服务端登录 + 多租户编排：

用户浏览器
   │ HTTPS
   ▼
nginx（TLS 终结，主域 + *.子域 通配）
   ▼
编排服务 dsh-server-login（Fastify，单进程）
   ├─ 认证 / 审核 / 管理台 / 网页桌面 / 域名 API
   └─ 按 Host 或 /u/<userId>/dsh/* 路由
        └─ 反向代理 → 各用户的 DSH 子进程（只绑 127.0.0.1 动态端口，不出公网）

流程：管理员审核注册用户 → 每个用户落到自己的文件桌面 → 按文件夹启动 DSH → 通过域名访问，彼此文件隔离。

核心能力

部署形态（二选一）

同一套代码，靠 DSH_SERVER_LOGIN_DEPLOY_MODE 切换：

模式 B 已完整落地（Phase 0–4）：每用户 DSH Pod（dsh + tcp-bridge sidecar）+ file sidecar（8082）+ Headless Service + NetworkPolicy；控制面 3 副本 + Lease 选主 + reconcile + 崩溃接管；NAS(CNFS) 共享卷 + PSA restricted + ResourceQuota。见 K8s 部署教程 与 踩坑记录。

快速开始（模式 A）

前置：Linux 服务器、Node ^22.19 或 ≥24、已安装 DSH CLI（npm i -g @deepseek-ai/dsh）。完整的生产流程（systemd / DNS / 通配证书 / nginx）见部署教程。

git clone https://github.com/pointer-a/dsh-server-login.git
cd dsh-server-login
npm install && npm run build            # tsc → lib/

# 1) 创建首个管理员（用它登录管理台）
node lib/cli.js bootstrap-admin --username admin --password '<强密码>' --db ./dev.local.db

# 2) 启动编排服务
node lib/cli.js --port 3080 --db ./dev.local.db

打开 http://127.0.0.1:3080/：

1. 用 admin 登录进入管理台；
2. 另开浏览器注册一个普通用户 → 回管理台点「通过」；
3. 该用户重新登录进入桌面 → 上传文件 / 建文件夹 → 点「在此文件夹启动 DSH」；
4. 首次使用在桌面的「管理密钥」里填入自己的 DeepSeek API Key（加密存储；未设置时 DSH 能启动但无法调用模型）。

⚠️ 本地试跑可以验证登录 / 审核 / 桌面 / 启动全链路；但要打开 DSH 聊天界面，需要配置域名与每用户子域名（BASE_DOMAIN + COOKIE_DOMAIN + nginx 通配，见部署教程第 6–9 步）——DSH 的 SPA 使用绝对路径，纯子路径方式加载不了静态资源。

配置

环境变量均可省略；同名 CLI flag（--port / --db / --isolation-mode 等）优先级更高，全部见 src/config.ts 与 node lib/cli.js --help。

文档

学习路线：模式 A 先读「部署教程」跑通 → 再看「硬隔离」加固，出问题查「常见问题排查」；模式 B 直接从「K8s 部署教程」开始，卡住查「K8s 踩坑记录」。

开发

npm install          # pnpm/npm 均可；Node ^22.19 || >=24
npm run typecheck    # tsc --noEmit
npm test             # 构建 + node:test 单测（DB 双后端 / k8s spawner / leader / fs 围栏）
npm run smoke        # 及 smoke:* 系列：对运行中的服务做端到端冒烟（scripts/smoke*.mjs）

安全

• 会话：不透明随机 token，仅 SHA-256 哈希落库；cookie HttpOnly + SameSite，HTTPS 下加 Secure。
• 密码：scrypt 加盐哈希，常数时间比较。
• 密钥：每用户 API key 以 AES-256-GCM 加密落库，主密钥来自 env 或 <dataRoot>/secret.key（0600）。
• 路径：所有文件操作先做词法包含校验，再逐段拒绝符号链接分量，防止越出用户根目录。
• 隔离分层：软隔离（默认）→ 账号级硬隔离（OS 账号 + setpriv 降权，0700 真正生效）→ 端口守卫（iptables owner-match）→ k8s Pod 边界（non-root / drop ALL / 只读 rootfs / NetworkPolicy）。
• 审计：注册 / 登录 / 审核 / 改密钥等动作写入 audit_log。

细节与威胁模型见技术蓝图 §7、硬隔离教程。

问题反馈与支持

这是我开发的第一个正式项目，功能可能还不够完善，非常欢迎大家提出意见和反馈！ 如果你在使用过程中遇到问题，或者有改进建议，欢迎提交 Issue：

• 🐛 遇到 Bug：请描述你的复现步骤、报错信息、以及运行环境（系统/DSH 版本等）
• 💡 功能建议：请说明你的使用场景和你期望的效果
• 📖 文档疑问：指出 README 中看不懂或描述不清的地方

我会尽量在 1~2 天内回复，确认有效的问题会尽快修复并发布更新。 感谢你的支持！🌟

许可证

MIT