前言¶
DeepSeek Harness（DSH）自带的 dsh web 默认只监听本机 127.0.0.1，不能直接挂到公网 IP 或域名上给浏览器访问。若你把 Harness 部署在云服务器上，又希望从外网安全打开工作区，就需要在官方 Web 前面加一层可控的入口。社区插件 dsh-login-gateway（维护者 KunalGupta25）在 web profile 下提供用户名/密码登录墙，并将已认证流量反向代理到本机 DSH 实例，分类属于 admin-security（仓库 topic：dsh-category-security）。
这是什么¶
dsh-login-gateway 是面向「云上部署 DSH、浏览器远程访问」场景的网关插件：默认在 8080 端口、路径前缀 /dsh 上监听，避免与官方 Web 默认端口 3080 冲突。发行包内不含硬编码的账号、域名或公网 IP；凭据在宿主机上生成并保存。当前 npm 包版本为 0.3.24，许可证 MIT，依赖 Node >=18。
核心功能¶
下面介绍 README 中已说明的能力，均可在 GitHub 仓库 核对。
登录墙与反向代理¶
未登录用户先看到登录界面；认证通过后，插件将请求代理到本机 DeepSeek Harness Web，从而在公网侧增加一层身份校验，而不是直接把 127.0.0.1:3080 暴露出去。
网关与 Trusted Host¶
启动 dsh web 时必须带上 --trusted-host，否则官方 API 会拒绝来自网关的入站流量。README 强调：若前面还有 Nginx 或 Caddy，需在网关设置里启用「Trust Reverse Proxy」，并把 /dsh、/assets/、/plugins/、/api、/dsh-image-gen、/query-balance 等路径代理到网关端口；完整字段与 Nginx 示例见仓库内 docs/setup.md。
控制台与 UI 配置¶
- 初始凭据：若未预先配置密码，在
dsh web控制台输出里查找标为generated login的生成账号信息。 - Gateway Settings：登录后进入 Settings → Gateway，打开 Gateway Settings 可修改用户名、密码、端口及代理相关选项，也可在此登出。
文档拖放¶
在浏览器中把非图片文档（PDF、Markdown、纯文本等）拖入界面时，会上传到服务器并在输入框插入 @filename 引用；PNG、JPEG、WebP、GIF 等图片仍走原生媒体栏流程。
与移动端布局插件配合¶
插件侧重认证与代理，保留官方桌面布局。若主要用手机浏览器访问，可在同一 web profile 下叠加社区插件 dsh-web-mobile：dsh-login-gateway 管认证与路由，dsh-web-mobile（包名 @dsh-external/dsh-mobile-nav）提供移动端抽屉、全宽聊天与触控设置，不影响桌面端展示。
安装与启用¶
前置条件：已安装 DeepSeek Harness。
从 GitHub 安装并启动（将 YOUR_PUBLIC_IP、your.example.com 换成你的公网 IP 或域名）：
dsh plugin --profile web add github:kunalgupta25/dsh-login-gateway
dsh web --trusted-host YOUR_PUBLIC_IP --trusted-host your.example.com
浏览器访问：
http://YOUR_PUBLIC_IP:8080/dsh
从本地目录安装：
dsh plugin --profile web add ./dsh-login-gateway
移动端组合示例：
dsh plugin --profile web add github:kunalgupta25/dsh-login-gateway
dsh plugin --profile web add github:mexiaosqwq/dsh-web-mobile
dsh web --trusted-host YOUR_PUBLIC_IP --trusted-host your.example.com
典型用法小结¶
- 在
webprofile 安装插件并启动dsh web，配置--trusted-host。 - 打开
http://<主机>:8080/dsh，使用控制台generated login或已配置的账号登录。 - 在 Settings → Gateway 调整网关参数；若上挂反向代理，按 setup 文档 配置信任代理与路径转发。
适用场景与注意¶
适合：在云 VPS 等环境运行 DSH，需要密码保护的公网 Web 入口，且希望与官方 localhost 绑定模型解耦的场景。
注意：
- 插件与当前
dsh web进程同权限运行；安装前请自行审阅 源码与 MIT 许可证。 - 社区插件目录 SkillHub 条目 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本文事实以仓库 README 与
package.json为准。
结尾¶
dsh-login-gateway 解决的是「官方 Web 只绑 localhost、云上却要安全远程打开」这一具体缺口：登录墙 + 反向代理 + 可配置的 Gateway 面板。需要完整配置项与 Nginx 示例时，直接阅读仓库 docs/setup.md。
