DeepSeek Harness 官方的 dsh web 默认只监听本机 127.0.0.1,无法直接对公网开放。如果你已将 Harness 部署在云服务器上,需要一个反向代理和一个登录层来从外网访问。dsh-cloud-gateway 专门用于解决这一场景。
这是什么¶
这是一个用于 DeepSeek Harness 云端部署的登录墙和公网网关插件。它默认监听 8080 端口,访问路径为 /dsh,避免与官方 Web 的 3080 端口冲突。发布包不含真实账号、密码或公网 IP,凭据仅保存在本地。
核心功能¶
- 登录墙与反向代理:提供带账号密码的登录墙,登录后反向代理到本地 DeepSeek Harness。
- 端口与路径:默认监听 8080 端口,访问路径为
/dsh。 - 文件引用:支持保存非图片文件(PDF、Markdown)并生成
@文件名引用。 - 配置灵活性:支持在设置中配置账号、密码、端口及是否信任反向代理。
- 生态兼容:可与社区插件
dsh-web-mobile配合使用。
安装与启用¶
安装前需确保已安装 DeepSeek Harness。
dsh plugin --profile web add github:MrLukezy/dsh-cloud-gateway
启动命令必须携带 --trusted-host 参数,否则登录后接口会被官方围栏拦截。
dsh web --trusted-host YOUR_PUBLIC_IP --trusted-host your.example.com
典型用法¶
安装并启动后,在浏览器中访问:
http://YOUR_PUBLIC_IP:8080/dsh
配置账号与信任反代:
1. 首次登录前,查看 dsh web 日志,查找 generated login 中的临时凭据。
2. 登录后进入 设置 → 网关,点击 网关设置,修改账号密码。
3. 若前面有 Nginx 等反向代理,在网关设置中开启「信任反向代理」,并反代 /dsh、/assets/、/plugins/、/api、/dsh-image-gen、/query-balance 等路径。
适用场景与注意¶
适用场景:已将 Harness 部署在云服务器,需要从外网通过浏览器访问工作台。
注意事项:
* 手机体验:本插件不改变官方桌面布局,手机竖屏体验不佳,建议配合 dsh-web-mobile 插件使用。
* 启动参数:启动命令必须带 --trusted-host。
* 凭据安全:发布包不含真实账号密码,凭据保存在本地。
* 许可证:MIT 许可证。
总结¶
dsh-cloud-gateway 为 DeepSeek Harness 的云端部署提供了一个轻量级的公网访问方案,通过登录墙和反向代理功能,解决了本地监听无法外网访问的痛点。