前言¶
DeepSeek Harness (DSH) 的 Web GUI 默认配置不支持从公网访问。dsh-https-fix 插件通过内置的 HTTPS 反向代理和运行时热补丁，解决了外网访问和安全配置的问题。
插件简介¶
dsh-https-fix 是一个联网工具类插件，由 MingYU-kalo 维护，遵循 MIT 许可证。它的核心作用是让 DSH 的 Web GUI 能够通过 HTTPS 从外网访问，同时提供证书管理、域名注册和访问控制功能。
核心功能¶
该插件主要提供以下能力：
- HTTPS 反向代理：插件自行监听 TLS，将流量转发至本地 HTTP 端口。
- 受信域名注册：在运行时将域名或 IP 注册进受信列表，无需修改 DSH 启动参数。
- 客户端热补丁：修改
@deepseek-ai/dsh-client-connection/lib/client.js，放行经域名/IP 访问的设置页。 - TLS 证书管理：支持自动自签证书、自有证书（含 IP 证书）以及无域名使用 IP 的场景。
- Web 账密登录：提供独立的 Web 认证（默认 admin/admin），会话 7 天。
- 访问与安全：可关闭外部 HTTP 访问、配置端口、开启自动 Token 模式。
- 诊断工具：提供“校验 HTTPS 可用性”功能，包含 12 项检查。
安装与启用¶
安装前请务必确认插件版本与 DSH 版本严格一致。安装命令如下：
dsh plugin --profile web add github:MingYU-kalo/dsh-https-fix#dsh-<版本>
若从本地路径安装，必须带 file: 前缀：
dsh plugin --profile web add file:/path/to/dsh-https-fix
安装完成后，重启 DSH Web 服务，浏览器访问 https://<域名或IP>:<端口>，默认使用 admin / admin 登录。
典型用法¶
- 登录后进入 设置 → 插件配置 → Https Fix。
- 在配置页填写域名或 IP，并选择证书类型：
- 两个路径留空：使用自动自签证书。
- 填写路径：使用自有证书。 - 点击 「一键打热补丁」。
- 点击 「校验 HTTPS 可用性」，确保 12 项检查全部显示为绿色。
注意事项¶
高危插件：该插件通过运行时热补丁修改了 DSH 的源码文件 @deepseek-ai/dsh-client-connection/lib/client.js，具有以下风险：
- 版本严格绑定：插件版本必须与 DSH 版本完全一致。装错版本会导致 DSH 直接无法启动。
- 升级冲突：DSH 升级后，旧版插件会覆盖热补丁导致 DSH 起不来。升级 DSH 前，必须先卸载或禁用插件。
- 安全风险：插件将 DSH 暴露到公网，默认账密为
admin/admin。请务必在登录页修改密码，并配置防火墙白名单。 - 本地安装限制：本地路径安装必须使用
file:前缀，否则会被识别为链接依赖导致启动失败。
总结¶
dsh-https-fix 通过热补丁技术实现了 DSH 的外网 HTTPS 访问能力，适合需要通过公网访问 DSH Web 界面的场景。但因其直接修改核心源码，对版本兼容性和升级流程有较高要求，使用时需格外谨慎。
