前言¶

DeepSeek Harness (DSH) 在 0.1.7 版本中引入了 loopback 检查，将设置页面的持久化限制在 127.0.0.1、localhost 或 ::1。当 DSH Web 后接反向代理（如 Nginx）并通过域名访问时，页面会被归类为非特权，设置会静默降级为内存模式，导致设置页提示不可用。

什么是 dsh-plugin-loopback-trust¶

这是一个由 6mt 维护的客户端插件，用于在反向代理环境下恢复 DSH Web 的 Host 持久化设置。它通过将页面连接标记为 host-owning，使得设置页在非 loopback 域名下依然可用。

核心功能¶

• 标记 Host 所有权：将页面连接标记为 host-owning，保持设置页的 Host 持久化。
• 优先级运行：位于 boot prefetch tier，在客户端插件之前运行。
• 轻量级实现：零依赖，无主机端代码，纯客户端 JavaScript 实现。
• 版本兼容：支持 dsh >=0.1.7 <0.3。

安装与启用¶

1. 执行安装命令：

    dsh plugin --profile web add 6mt/dsh-plugin-loopback-trust

2. 重启 dsh web（新 bundle 必须启动）。
3. 在浏览器中硬刷新页面。

启用后，通过域名访问 Settings -> Models，设置应可正常加载。

适用场景与注意¶

• 适用场景：DSH Web 部署在反向代理后，需要通过域名访问并保存 Host 持久化设置。
• 信任声明：这是一个信任声明，需确保反向代理有预期的访问控制。
• 安全边界：不触及服务器端的 /api Host fence，不包含遥测或数据泄露。

结语¶

该插件完全由客户端 JavaScript 实现，无外部依赖。相关资源可在 GitHub 或 社区目录 查看。