临时解决 dsh 无法监听 0.0.0.0 及远程访问 HTTP 403

[knoka0812]

后续更新：推荐使用统一补丁方案

最初发布的部署教程主要解决 DeepSeek Harness 无法监听 0.0.0.0，以及远程访问 settings.*、credentials.*、agentPreset.* 等特权接口返回 HTTP 403 的问题。

后续测试第三方插件时发现，远程 Web UI 还存在两项独立限制：

1. dsh-host-apiproxy 默认只向设置页暴露白名单中的设置命名空间，第三方插件即使已经在 Host 侧注册设置 schema，设置卡片仍可能提示命名空间未暴露。
2. dsh-client-ui-settings 默认让非回环浏览器使用内存设置模式，导致远程插件设置表单不可用或无法持久化。

目前已整理出一个统一补丁项目：

https://github.com/knoka0812/deepseek-harness-deployment-plug

该项目通过一个源码补丁和一个 Cordis 覆盖层增加三个默认安全的配置开关：

• pinPrivilegedToLoopback
• exposeAllSettingsNamespaces
• allowRemoteSettingsPersistence

使用项目提供的公网覆盖层后，可以统一处理：

• Web UI 监听 0.0.0.0
• 已声明 trustedHosts 的远程浏览器访问特权接口
• 自动暴露所有已由 Host 插件注册的设置命名空间
• 远程浏览器读取和保存 Host 设置

原部署教程仍保留，用于说明公网访问原理、网络入口、反向代理、沙箱构建和故障排查：

https://github.com/knoka0812/deepseek-harness-deployment-guide

当前补丁仅验证支持 DeepSeek Harness commit 47f943859bef60e4160492346772ded9b24f765a。在其他版本上使用前必须先执行 git apply --check，并重新运行测试和构建。

安全提醒：该方案仍属于无登录认证的匿名远程管理方案。trustedHosts 不是用户认证，正式环境应增加反向代理认证、来源 IP 限制并使用非 root 用户运行。

遇到 dsh web --host 0.0.0.0 被拒绝，以及转发后工作区、Settings、Agent Presets 等接口返回 HTTP 403 时，可以参考下面这份经过实际部署验证的临时解决方法：

https://github.com/knoka0812/deepseek-harness-deployment-guide

需要注意的是，只删除 CLI 中对 --host 0.0.0.0 的拒绝检查并不够。当前版本还需要处理以下部分：

• 使用浏览器实际访问的 IP/域名[:公网端口] 配置 --trusted-host。
• 端口映射时填写公网端口，而不是容器内部端口。
• Settings、Credentials、Agent Presets、模型发现等接口还有第二层 loopback-only 检查，否则仍会出现 transport 403。
• 反向代理或端口映射需要支持 /api/events.mux 和 /api/events.host 两条 WebSocket。
• 公网明文 HTTP 可能遇到浏览器安全上下文限制，推荐使用 HTTPS。
• 从源码运行时，可能还需要单独构建 Landlock runner，否则命令会提示沙箱后端不可用。

教程覆盖公网 IP + 端口、HTTPS 域名、反向代理、WebSocket、52 个 RPC 方法的 403 排查、会话下载和沙箱验证。

验证结果包括：52 个标准 RPC 方法均不再出现非预期 403，Settings 和 Agent Presets 返回 HTTP 200，两条 WebSocket 可以正常连接；错误 Origin 和 Sec-Fetch-Site: cross-site 仍保持 403。

这是自行修改源码、移除上游安全限制的临时 workaround，不是官方支持的安全远程模式。DeepSeek Harness 能执行命令和修改文件，不建议将无认证实例长期暴露到公网；至少应限制来源 IP、增加反向代理认证，并避免使用 root 用户运行。

[knoka0812]

已更新解决方案：原方案主要解决监听地址和特权 API 403；新版补丁进一步解决了第三方插件设置命名空间未暴露，以及远程浏览器设置无法持久化的问题。

新版补丁：
https://github.com/knoka0812/deepseek-harness-deployment-plug