前言¶
DeepSeek Harness (DSH) 的 Web UI 通常通过 127.0.0.1 访问。当用户通过反向代理（而非直接访问本地地址）访问经过身份验证的 Web UI 页面时，DSH 会将其归类为远程请求，导致部分依赖 Host 的功能无法正常工作。dsh-trusted-host-is-loopback 插件通过修改客户端的判定逻辑，使这些页面在反向代理场景下被识别为本地访问，从而恢复相关功能的可用性。
插件介绍¶
这是一个由 Exagone313 维护的 DSH Bundle。它的核心作用是将经过身份验证的 Web UI 页面视为 loopback（本地回环）。这使得 Host-backed 设置（如设置中的模型配置、首次运行的 API-key 步骤、预览通知等）能够在通过反向代理访问 dsh 时正常工作。
核心功能¶
- 将经过身份验证的 Web UI 页面标记为 loopback。
- 启用 Host-backed 设置，使其在通过反向代理而非
127.0.0.1访问时生效。
安装与启用¶
安装插件后需要重启 DSH 进程。
dsh plugin --profile web add @exagone313/dsh-trusted-host-is-loopback
安装完成后，重启 dsh 即可生效。
注意事项¶
- 无需配置：该插件不需要任何额外的配置文件。
- Host/Origin 信任边界：这是安全边界。只有你通过
--trusted-host或trustedHosts声明为受信任的权威机构才能访问 Web UI。 - Hook 来源：
webserver/index-injecthook 属于@deepseek-ai/dsh-host-webserver插件，如果未来该 hook 名称变更，需要等待此插件更新。 - 测试版本：该插件在 dsh
0.2.0-rc.2版本上经过测试。
总结¶
该插件仅修改了客户端对 Host 的分类（ownsHost），并不改变服务端的认证逻辑或 Host/Origin 信任边界。它为需要通过反向代理访问 DSH Web UI 的场景提供了一个简单的解决方案。源码地址：https://github.com/Exagone313/dsh-trusted-host-is-loopback
