前言¶

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 配置¶

1. 初始凭据：若未预先配置密码，在 dsh web 控制台输出里查找标为 generated login 的生成账号信息。
2. 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

典型用法小结¶

1. 在 web profile 安装插件并启动 dsh web，配置 --trusted-host。
2. 打开 http://<主机>:8080/dsh，使用控制台 generated login 或已配置的账号登录。
3. 在 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。

• 目录页：https://www.skillhub.cn/plugins/KunalGupta25/dsh-login-gateway
• GitHub：https://github.com/KunalGupta25/dsh-login-gateway