@xgone/dsh-remote
DeepSeek Harness 网页界面的远程访问与身份验证：登录门禁、多因素身份验证（TOTP）、签名会话 Cookie、基于角色的访问权限、浏览器内目录选择器、账户管理设置。完全本地化（中文/英文）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @xgone/dsh-remote@0.3.3
Remote 以 @xgone/dsh-remote 发布，当前版本为 0.3.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
让 DeepSeek Harness 可以被安全地远程访问：在 dsh web 前增加账号密码 + MFA（两步验证）
门禁，外网浏览器登录后即可使用完整功能——全程不在宿主机上弹出任何原生窗口。
| 登录门禁（未登录访问任何路径） | 设置 → 登录与账号 |
|---|---|
| 登录页 | 账号管理设置页 |
/api 与 WebSocket 全部要求有效会话；密码
scrypt 加密存储、登录失败限速、首个管理员仅限本机创建。adminOnly 后支持 admin / user / guest 三级权限。dsh plugin --profile web add @xgone/dsh-remote
dsh web补丁不支持热重载，必须重启才生效：
dsh web
在本机浏览器打开 http://127.0.0.1:3080，登录页处于引导模式：输入用户名和密码（至少 6 位）
创建首个管理员，创建成功即登录。
服务器没有本地浏览器？见下方 无浏览器服务器。
进入 设置 → 登录与账号 → 双重验证 (MFA) → 启用，用认证器扫码并输入 6 位动态码即可。 请先保存页面上的 10 个备用码。
dsh web 只监听本机，请用反向代理暴露（需转发 WebSocket）：
server {
listen 8443 ssl;
server_name dsh.example.com;
ssl_certificate /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:3080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header Origin $http_origin;
}
}
ssh -R 隧道、Tailscale、Frp 等同样适用。HTTPS 部署请在配置中把 session.secure 设为
true。
编辑 ~/.dsh/profiles/web/cordis.patch.yml 中 remote 行的 config。常用项：
- id: remote
config:
enabled: true # false = 关闭门禁（被锁在门外时的逃生通道）
session:
secure: false # HTTPS 部署改为 true
adminOnly: true # false = 启用多角色（admin/user/guest）与账号管理
bootstrap: # 可选：预置首个管理员（仅账号库为空时生效）
username: admin
password: '换成一个强密码'
默认值即开箱可用；完整配置项（会话、MFA、限速、gzip、文件面板等）见 docs/REFERENCE.md。
在 cordis.patch.yml 中加 bootstrap 配置节（见上），重启即预置首个管理员，等价于本机
引导。首次登录后建议移除明文密码并绑定 MFA。
| 现象 | 处理 |
|---|---|
| 安装后没有登录页 | 重启 dsh web；确认 bundles 列表里有 @xgone/dsh-remote |
| 创建管理员时报 403 | 首个管理员仅限本机创建：在本机浏览器操作，或 ssh -L 后访问 127.0.0.1；无本地浏览器用 bootstrap 配置 |
| 被锁在门外 | cordis.patch.yml 设 enabled: false 重启；或删除 $DSH_HOME/auth/store.json 重新引导 |
| 忘记 MFA / 丢手机 | 管理员登录后：设置 → 登录与账号 → 该账号 → 禁用 MFA |
文件面板提示 outside-roots | 设置 → 登录与账号 → 允许的目录，添加该目录（即时生效，无需重启） |
升级 dsh 后登录成功但 /api 全部 401 | 升级本插件（≥ 0.3.1）并重新登录一次，见 CHANGELOG |
| 升级 dsh 后点文件路径没反应 / 不再进侧边栏 | 升级本插件（≥ 0.3.2）并重启 dsh web，见 CHANGELOG |
| 升级 dsh 后远程设置页异常 / 反复弹窗 | 先升级本插件——新版 DSH 的远程兼容修复随版本内置，见 CHANGELOG |
dsh plugin --profile web remove @xgone/dsh-remote
重启 dsh web 后门禁消失；账号数据保留在 $DSH_HOME/auth/store.json（彻底清除可手动删除）。
dsh web（Web 表面禁用 HMR）；dsh --profile alice --port 3081）。