dsh-remote

dsh-remote

中文 · English

让 DeepSeek Harness Web UI 可以被安全地远程访问：在 dsh web 前增加登录门禁、MFA/TOTP、角色权限和远程文件预览。外部浏览器登录后即可使用完整功能，同时不在宿主机上弹出原生窗口。 适用于已经能在本机运行 dsh web 的环境。插件默认只监听本机回环地址；公网访问仍需 HTTPS 反向代理或安全隧道。 目录 功能概览 界面预览 快速开始 远程访问 安装为应用 配置 无浏览器服务器 常见问题 文档 开发与测试 卸载 已知限制 功能概览 登录门禁：未登录访问任何路径都会进入登录页；/api 和 WebSocket 全部要求有效会话。密码使用 scrypt 加密存储，登录失败限速，首个管理员仅限本机创建。 MFA 两步验证：兼容 Google Authenticator、1Password、Authy 等标准 TOTP 认证器；支持扫码绑定和 10 个一次性备用码，管理员可以为账号关闭 MFA。 会话与权限：签名会话 Cookie；默认管理员专用，可选启用 admin / user / guest 三级角色。 远程文件面板：在右侧边栏预览代码、Markdown、图片、PDF、视频、音频、文本、目录和 .docx 提取文本；不支持预览的文件直接下载。默认只允许 DSH 主目录与工作目录，可在设置中添加目录。 远程访问：适配 nginx、SSH 隧道、Tailscale、Frp、Cloudflare Tunnel 等方式，并完整转发 WebSocket 事件流。 可安装为桌面 / 手机应用：清单、Service Worker 与图标未登录也可获取，桌面与手机浏览器都能装成独立窗口，冷启动自动修复 Cookie，见安装为应用。 浏览器内工作区：选择或新建工作区使用浏览器内目录对话框，不调用宿主机原生文件窗口。 界面与性能：跟随 DSH 的浅色 / 深色主题和中英文语言；远程响应默认自动 gzip 压缩，静态资源可配合边缘缓存。 界面预览 快速开始 1. 安装

2. 重启 dsh web

补丁不支持热重载，安装或升级后必须重启：

3. 创建首个管理员

在本机浏览器打开 http://127.0.0.1:3080。首次访问会进入引导模式：输入用户名和密码（至少 6 位）创建首个管理员，创建成功后自动登录。 服务器没有本地浏览器？见无浏览器服务器。 4. 绑定 MFA（推荐）

进入 设置 → 登录与账号 → 双重验证（MFA）→ 启用，用认证器扫码并输入 6 位动态码。请先保存页面上的 10 个备用码。 5. 开放远程访问

确认本机登录和 MFA 工作正常后，按下方远程访问配置反向代理或隧道。外部访问必须转发 WebSocket；HTTPS 部署还要设置 session.secure: true。 远程访问

dsh web 默认只监听本机回环地址，请通过反向代理或隧道暴露，不要直接把未加密的服务端口暴露到公网。

下面是 nginx 示例，重点是保留 WebSocket 升级头：

ssh -R 隧道、Tailscale、Frp 和 Cloudflare Tunnel 同样适用。HTTPS 部署请在配置中把 session.secure 设为 true。 安装为应用（PWA）