DeepSeek Harness 本质是本地开发工具，默认依赖 127.0.0.1 绑定和请求头校验。在 Docker、反向代理或公网部署场景下，这种基于 Host/Origin/Sec-Fetch-Site 的信任校验机制会失效。dsh-auth-gate 插件旨在解决这些场景下的未授权访问风险，为 Harness 提供网络层面的安全防护。
插件定位¶
dsh-auth-gate 是 DeepSeek Harness 的认证与安全加固插件，由 zephaniahwang94-cmyk 维护。它通过在 HTTP 和 WebSocket 路由上增加认证层，防止未授权的 API 访问，并对审批流程增加限制。
核心功能¶
该插件提供以下能力：
- Bearer token + session login：为 HTTP 和 WebSocket 路由提供基于 Token 的认证和会话登录。
- Prepended per-session waterfall limiter：在审批流程的水印流中增加前置限制，防止审批过载。
- Fail-closed authentication gateway：当认证配置生效时，未通过认证的请求将被直接拒绝（Fail-closed），而不是允许访问。
安装与启用¶
安装过程会自动构建插件并注册到指定的 Harness 配置中。凭证通过环境变量传递，不会写入配置文件。
Linux / macOS¶
export DSH_AUTH_USERNAME=admin
export DSH_AUTH_PASSWORD=Read-Host 'Enter a private password (12+ characters)'
./install.sh --protection Full
Windows PowerShell¶
$env:DSH_AUTH_USERNAME = 'admin'
$env:DSH_AUTH_PASSWORD = Read-Host 'Enter a private password (12+ characters)'
.\install.ps1 -Protection Full
安装完成后，后续启动 Harness 时需要指定 Patch 文件：
dsh --profile web --patch C:\path\to\dsh-auth-gate\presets\full.yml
重要限制与注意事项¶
在使用前需了解以下限制：
- 无用户隔离：所有通过认证的用户共享同一个 Agent 实例和会话池，没有用户级别的沙箱隔离。
- 无审计日志：该插件不记录谁进行了认证或用户的具体操作行为。
- 不修复 ACP / SDK 通道：这些通道通过 stdio (stdin/stdout) 运行，不在 HTTP 网络范围内，因此不受此插件保护。
- 信任校验头而非网络来源：插件验证请求头（如 Host/Origin），并不验证请求的实际网络来源。
- 反向代理登录桶：登录尝试基于 TCP peer address 计数。如果部署在反向代理（如 Nginx）之后，用户将共享代理的登录桶限制。此时建议在边缘层（反向代理）配置限流，因为插件无法信任被代理转发的头信息。
生态链接¶
- 目录页：dsh-auth-gate - SkillHub
- GitHub 仓库：zephaniahwang94-cmyk/dsh-auth-gate
