dsh-public-proxy：将 DSH Web UI 暴露给局域网

DeepSeek Harness (DSH) 的插件架构灵活，但在本地开发调试时，若需在局域网内的其他设备上访问 DSH 的 Web UI，默认配置往往不够方便。dsh-public-proxy 插件通过绕过安全限制，直接将 Web UI 暴露给局域网。

这是一个由 SpringNyan 维护的 DeepSeek Harness 插件，采用 MIT 许可证。它通过修改 DSH 的底层配置，使 Web UI 能够被局域网内的其他设备访问。

核心功能¶

• 局域网访问：将 DSH Web UI 暴露给局域网内的其他设备。
• 默认端口：默认在 3081 端口监听。
• 认证与控制：支持 Cookie 认证和绕过启动令牌，可通过配置 host、port、accessKey 等参数进行管理。
• 配置灵活性：支持自定义 host、port、accessKey、enableCookieAuth、bypassLaunchToken。

安装与启用¶

通过 DSH 命令行安装插件：

dsh plugin --profile web add dsh-public-proxy@latest

典型用法¶

安装并运行插件后，默认会在 3081 端口监听。局域网内的其他设备可以通过以下地址访问 Web UI：

http://<本机局域网IP>:3081

例如 http://192.168.1.100:3081

配置 Cookie 认证¶

默认情况下，代理不启用访问控制。为了保护代理，可以在 $DSH_HOME/profiles/web/cordis.patch.yml 中配置密钥：

- id: public-proxy
  config:
    accessKey: "your-secret-key"
    enableCookieAuth: true

启用后，访问代理时会要求输入访问密钥。密钥通过 Cookie 存储，30 天内无需重复输入。

配置绕过启动令牌¶

DSH Web UI 默认通过启动令牌保护，访问时需要在 URL 中携带令牌。启用 bypassLaunchToken 后，客户端直接访问代理即可，无需在 URL 中携带令牌：

- id: public-proxy
  config:
    bypassLaunchToken: true

安全警告¶

插件通过 HTTP 明文传输数据，访问密钥可能被网络监听者截获。请仅在可信任的局域网环境使用。

由于插件将 host 绑定至 0.0.0.0，这会将 Web UI 暴露给整个网络。DSH 官方出于安全考虑禁止绑定 0.0.0.0，本插件有意绕过此限制，请勿将代理直接暴露到公网。

注意事项¶

该插件以当前 DSH 进程的权限运行。使用前请检查源码与许可证，确保符合您的使用规范。

总结¶

该插件为 DSH 在本地局域网的使用提供了便利，允许开发者通过标准的 Web 界面进行调试和管理。更多详情可查看 GitHub 仓库。