dsh-passwords

English | 简体中文

给 DeepSeek Harness 加一层服务器级认证网关，使其成为可公网部署的多租户平台
登录认证 · 自动 HTTPS · 多租户权限 · 会话授权 · 审计加密 · 中英双语

功能

• 登录认证：首次配置创建主用户，之后所有访问先过登录页；会话 12 小时有效
• 自动 HTTPS：向 Let's Encrypt 自动签发并续期证书，80 端口自动跳转 443，无需配置
• 多租户：一个主用户加任意多个子用户，账号管理全部在 dsh 设置页完成
• 权限与配额：工作区白名单、逐会话开关、每小时 token 上限、每日时长上限、沙盒三档、上传与下载开关、封禁
• 会话授权：工作区权限不自动包含其中全部会话，主用户逐会话授予；归档状态在工作区列表与会话列表间保持一致
• 运维视图：主用户可查看全部工作区与会话，下载非敏感普通文件
• 审计与安全：登录限流与锁定、审计日志、SQLite 静态加密、登出即吊销会话
• 设置页卡片：远程设置补丁重载、软件更新、账号与权限管理、站内留言，全部中英双语

界面截图

登录页 · 浅色	登录页 · 深色	登录页 · English

dsh 主界面 · 登录后	聊天 / 留言	设置页卡片 · 账号管理

	设置页卡片 · 权限与配额

快速开始

前置条件

宿主机安装需要 Node.js 22.19+ 或 24+、可正常运行的 dsh、git 与 pnpm（手动执行 node scripts/register-plugin.mjs 注册插件时需要；一键安装器会自动安装 pnpm）。兼容门禁只接受 DSH 0.2.1 patch 线，即 >=0.2.1-alpha.1 <0.2.2-0（alpha.1 起的预发布与稳定 0.2.1）；当前开发树与 bundled Docker 默认运行时锁定 0.2.1-alpha.1。已退役的 0.1.x / 0.2.0 线、0.2.1-alpha.0 以及所有 0.2.2+ 身份都会被拒绝。Docker 安装只需要 Docker Engine 或 Docker Desktop 和一个 DeepSeek API key。

安装

五种安装方式，任选其一。宿主机安装会自动完成装依赖、编译、生成 SETUP_KEY、注册 dsh 插件、应用远程设置补丁；已有 .env 时不覆盖，重复运行安全。

# 1. Linux / macOS 一键安装
curl -fsSL https://raw.githubusercontent.com/slywalker2006/dsh-passwords/main/install.sh | sudo bash

# 2. 先 clone 再安装
git clone https://github.com/slywalker2006/dsh-passwords && cd dsh-passwords
sudo bash install.sh

# 3. npm 全局安装，适用于任意平台
npm install -g dsh-passwords
dsh-passwords install

Windows 下载仓库里的 install.bat 双击运行。默认安装到 %USERPROFILE%\dsh-passwords。

# 4. Docker：一条命令完成安装并初始化
docker run -d \
  --name dsh-passwords \
  --restart unless-stopped \
  -e DEEPSEEK_API_KEY=sk-你的key \
  -e SETUP_KEY=自己设定的强随机串 \
  -p 127.0.0.1:3088:3088 \
  -v dsh-home:/data/dsh \
  -v dsh-passwords-state:/data/dsh-passwords \
  skywalker237234/dsh-passwords:2.7.7

启动后浏览器打开 http://127.0.0.1:3088，用你自己设置的 SETUP_KEY 完成首次配置。若省略 -e SETUP_KEY，容器会随机生成密钥并写入卷内 setup-key.txt，用 docker exec dsh-passwords cat /data/dsh-passwords/setup-key.txt 读取后再完成首次配置（首次配置成功后该文件自动删除）。-e SETUP_KEY 会在首次初始化时作为初始 SETUP_KEY 写入卷内 .env，不会与随机值分叉，去掉该 env 重启也不会因此锁死（首次配置成功后 .env 中的 SETUP_KEY 会按既有加固流程自动轮换，此后登录使用你创建的账号密码，不再需要它）。

如需自定义端口、域名、SSH 端点或第三方端点登记等高级配置，可复制 docker/.env.example 为 docker/.env 并追加 --env-file docker/.env（Docker Compose 则可 docker compose --env-file docker/.env -f docker/docker-compose.yml up -d）；它是可选的进阶配置，不再是安装前置步骤。不要用仓库根目录的宿主机模板 .env.example：它会注入占位 SETUP_KEY（change-me-…）、MCP_GATEWAY_PORT=443 与空的 MCP_GATEWAY_AUTO_TLS=，覆盖镜像内置的 3088 端口和 MCP_GATEWAY_AUTO_TLS=0，导致容器不监听 3088、网关拒绝启动；其中相对的 MCP_DB_PATH=./data/platform.db 也会偏离容器默认的 /data/dsh-passwords/platform.db。

Docker 部署至少需要 DEEPSEEK_API_KEY。MCP_GATEWAY_PUBLIC_HOST 建议填实际访问的域名。宿主端口只发布在回环地址 127.0.0.1:3088，容器内监听 0.0.0.0:3088；公网访问由 nginx 或 Caddy 终结 TLS 后转发。镜像内置 DSH 0.2.1-alpha.1（DSH 0.2.1 patch 线当前锁定版本；该镜像尚未做运行验收）；初始化完成以 healthz/readyz 均返回 ok:true 为准。

说明：

• 宿主机安装默认目录为 /opt/dsh-passwords，可用 DSH_PASSWORDS_DIR 更改；检测到已有 dsh-passwords 目录时就地幂等重跑，其他同名目录会报错退出
• SETUP_KEY：宿主机安装结束时打印并写入安装目录的 setup-key.txt；Docker 用 -e SETUP_KEY 指定，省略则随机生成并写入卷内 setup-key.txt
• Docker 的两个命名卷分别存 dsh profile 与 .env、数据库、证书；删除即丢数据
• Docker 中的“保命技能”不会尝试在容器内自删；Compose 部署需要彻底清理时，在宿主机执行 docker compose down -v，而 docker run 部署需要先 docker rm -f dsh-passwords，再执行 docker volume rm dsh-home dsh-passwords-state（都会永久删除卷数据）
• 分容器部署时给 dsh 容器加 MCP_DSH_PATCH_ALLOW_BIND_ALL=1，让网关容器能访问 dsh web；0.2.1-alpha.1 的 dsh-web-app 仍然在启动时拒绝 --host 0.0.0.0，所以该子补丁依旧需要保留
• npm 全局安装（方式 3）：Unix 首次安装需要 sudo（自动 HTTPS 要监听 80/443）；nvm / Homebrew 管理的 Node 常不在 root 或系统 PATH 中，可能找不到 dsh-passwords 命令；npm 全局目录会随包更新被替换，不适合长期保存 .env 与 data/，推荐 clone 后安装，或用 DSH_PASSWORDS_ENV_FILE 把配置与数据指向稳定目录

首次配置

1. 启动 dsh：dsh web。Docker 用户跳过此步，容器内自动启动。
2. 浏览器打开 https://<服务器地址>，首次访问自动进入配置页。
3. 输入 SETUP_KEY 创建主用户。此后该地址的所有访问都先过登录页。

首次配置成功后 setup-key.txt 自动删除，.env 中的密钥自动固化并轮换。

Docker 用户一条命令启动后直接打开 http://127.0.0.1:3088 完成首次配置，公网访问再自行用 nginx 或 Caddy 把 80/443 反代到 http://127.0.0.1:3088；首次配置用的 SETUP_KEY 就是 -e SETUP_KEY 设置的值，省略时用 docker exec dsh-passwords cat /data/dsh-passwords/setup-key.txt 读取。

卸载

宿主机安装可在 dsh-passwords 安装目录执行：

node dist/cli.js uninstall
# 全局 npm 安装也可直接执行：
dsh-passwords uninstall

该命令只从 DSH web profile 移除 dsh-passwords 的 link 与 bundle，并回滚本插件管理的 dsh 补丁；其他插件和 bundle 会保留。完成后按提示重启 dsh-web。

卸载不会删除安装目录、.env、数据库、TLS/ACME 证书或其他插件。profile 依赖重建或补丁回滚失败时会恢复原 profile，避免留下半卸载状态。Docker 部署请按所用 Compose 或容器编排停止并移除容器；不要删除命名卷，除非也要永久清除数据。

自动 HTTPS

默认探测公网 IP 并用 <IP>.sslip.io 向 Let's Encrypt 签发 90 天证书，到期前 30 天自动续期，新证书热加载。有自己的域名时在 .env 加 MCP_GATEWAY_DOMAIN。签发失败拒绝启动，不降级明文；续期失败但旧证书仍在有效期内时继续使用并后台重试。

证书域名使用 <IP>.sslip.io 是因为 Let's Encrypt 不给纯 IP 签发证书。直接访问裸 IP 的 https 地址会提示主机名不匹配，从 80 端口入口进入会自动跳转到正确地址。

部署拓扑

http-01 验证只在签发与续期时访问 80 端口，约每 60 天一次。

HTTP 模式

默认拒绝明文 HTTP。内网环境确需使用时：

node scripts/start-http.mjs [端口]    # 默认 8080，需确认风险提示

或在 .env 写入 MCP_GATEWAY_AUTO_TLS=0 与 MCP_GATEWAY_PORT=8080，dsh 启动时插件以 HTTP 模式拉起网关。该模式不依赖公网 IP、DNS、ACME 或外部 CDN，可用于内网部署；首次安装仍需要 npm/GitHub 可访问，或提前准备项目 tarball、依赖缓存和本地 DSH 安装。模型对话仍需要配置上游模型提供方（例如 DEEPSEEK_API_KEY）；没有外部模型服务时，登录、权限、文件与管理功能可运行，但不会产生模型回复。

设置页卡片

登录后打开设置，能看到「dsh-passwords · 密码门」卡片。

密码要求：至少 12 位，含大写、小写、数字、符号。

软件更新

• 版本发现走 GitHub Release，包始终从 npm registry 下载并按 dist.integrity 的 sha512 校验
• 自动模式：每 24 小时检查，发现新版本后限速下载，平台连续空闲 1 小时后安装重启；主用户可手动跳过等待
• 手动模式：检查只发现版本，第一次点击触发下载，第二次点击安装重启
• 安装保留 .env、data/、数据库、TLS 与 profile，失败自动回滚
• Docker 更新需显式配置 MCP_DSH_DOCKER_SELF_UPDATE=1 与 Compose 相关变量，未配置时只显示宿主机手动命令；Docker socket 等同授予容器宿主控制权限，仅在可信部署启用

配置参考

环境变量与 .env 的优先级按安装方式不同：Docker 内以容器环境变量（--env-file docker/.env）优先于卷内 .env；宿主安装相反，部署 .env 中的托管键优先于进程中继承的同名环境变量。

常用命令

node dist/cli.js audit --limit 20        # 最近 20 条审计日志
node dist/cli.js patch status            # 远程设置补丁状态
node dist/cli.js patch                   # 重载补丁并重启 dsh-web
node dist/cli.js serve-gateway --port 9000   # 手动启动网关
DSH_PASSWORDS_NO_AUTOSTART=1 dsh web     # 禁止网关自动拉起
curl -s https://地址/gateway/healthz      # 存活检查
curl -s https://地址/gateway/readyz       # 就绪检查，含数据库

常见问题

node -e "const {DatabaseSync}=require('node:sqlite');const db=new DatabaseSync('data/platform.db');db.exec('DELETE FROM users;')"

npm config set allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs --location=user

curl -so /dev/null -w "TLS:%{time_appconnect}s\n" https://地址/gateway/login

手动安装

当前发布版本 2.7.7 只支持 DSH 0.2.1 patch 线（>=0.2.1-alpha.1 <0.2.2-0）；开发与 bundled Docker 运行时锁定 0.2.1-alpha.1。已退役的 0.1.x / 0.2.0 线、0.2.1-alpha.0 以及所有 0.2.2+ 身份都会被版本门禁拒绝。宿主机安装器会检查 Node.js 22.19+ 或 24+，注册插件并应用兼容补丁。

1. git clone https://github.com/slywalker2006/dsh-passwords && cd dsh-passwords
2. npm install && npm run build
3. cp .env.example .env，把 SETUP_KEY 改为 openssl rand -hex 24 生成的随机串
4. node scripts/register-plugin.mjs 注册插件
5. node dist/cli.js patch 应用补丁，找不到 dsh 目录时用 MCP_DSH_ROOT 指定

之后启动 dsh，网关自动拉起，按「首次配置」完成初始化。

安全与隐私

账号密码只存 bcrypt 哈希；用户名、IP 与审计记录加密落盘；证书签发失败拒绝启动。

• 连续失败锁定按轮次退避，1 到 60 分钟封顶；主用户不受多 IP 轮换的全局锁死影响
• 同一 IP 15 分钟内 30 次失败触发 IP 级节流 30 分钟，应对跨用户名密码喷洒
• 登出即服务端吊销 token；改密、改名后全部旧会话失效
• 第三方插件运维面端点仅主用户可用；上传与下载按权限门控，新子用户默认禁用下载
• 请求超时与并发连接上限抵御 slowloris；路径归一化拦截 %2f、双重编码等变体
• 首次配置成功后自动删除 setup-key.txt 并固化独立密钥变量

语言

界面中英双语，跟随 dsh 语言设置。登录页右上角可手动切换并持久化，CLI 跟随 LANG / LC_ALL。

版本兼容

当前发布版本为 2.7.7，开发与 bundled Docker 默认运行时锁定 0.2.1-alpha.1：这是 npm 上 0.2.1 patch 线当前最新已发布的身份（alpha dist-tag），也是 9 个 @deepseek-ai/dsh* 开发依赖实际解析并锁定的版本。开发依赖声明范围 >=0.2.1-alpha.1 <0.2.2-0，即接受 alpha.1 起的 alpha/beta/rc 预发布与稳定 0.2.1，拒绝已退役的 0.1.x / 0.2.0 线、0.2.1-alpha.0 与所有 0.2.2+ 身份；但 npm 目前只发布了 0.2.1-alpha.1 一个 0.2.1 身份，因此后续预发布与稳定版的兼容仅由 SemVer 范围与版本身份门禁保证，未在实机运行、也未通过完整网关验收。

参与贡献

• 提交问题前请阅读 社区规范清单，并使用 问题模板 或 功能模板
• 代码贡献请阅读 CONTRIBUTING.md，使用 PR 模板，保持改动聚焦并附测试证据
• 提交前跑 npm ci && npm run build && npm test，CI 会在 Node 22/24 上自动执行

贡献者

License

GNU GPL v3.0 only，完整文本见 LICENSE。

本项目是 dsh 的独立扩展，与 DeepSeek 无隶属关系。