容器化部署 ly921002/dsh-docker

自建 DeepSeek Harness（DSH）Web 容器

一套 Dockerfile + compose 编排，用来在 Linux 上运行 DeepSeek Harness 的 web 配置档。上游没有发布 Docker 镜像——这个镜像基于 npm 包 @deepseek-ai/dsh 构建，该包把预构建的浏览器 bundle 放在 @deepseek-ai/dsh-web-frontend 里，所以没有源码构建步骤。

内容

| 文件 | 用途 |
| Dockerfile | node:24-bookworm-slim + 固定版本的 @deepseek-ai/dsh，外加 tini、字体和可选的 pwsh/python3 |
| docker-entrypoint.sh | 解析出具体的绑定地址，拼装 dsh --profile web 命令行 |
| healthcheck.sh | SPA 起来后探测绑定地址（绝不用 loopback） |
| docker-compose.yml | 只在 127.0.0.1 上发布端口，把 DSH 状态持久化到 ./data |
| nginx-dsh.conf | 反向代理 + TLS 终止示例，带 WebSocket upgrade |
| .env.example | 可调参数 |
| DEPLOY.md | 完整部署走查，面向 Oracle Cloud VPS 编写 |

快速开始

cp .env.example .env
docker compose config # syntax check first
docker compose up -d --build
docker compose logs -f dsh # the startup URL is printed once

打印出来的启动 URL 带着本进程的凭据——把它当密码对待。设置 DSH_EXTRA_ARGS="--print-url false" 可以让它不出现在日志里。

为什么这样设计

DSH 的三个事实决定了这套设计，全部对照随包发布的运行时和上游文档验证过：

1. 通配符绑定会被拒绝。 --host 0.0.0.0 或 :: 会在启动时失败，报错 "binding every interface would expose remote code execution to the network"。因此入口脚本用 hostname -i 解析出容器自己的地址，并拒绝把通配符传下去。这也是这套编排不用 --network host 的原因。

2. 远程访问需要两个参数一起给。 --public-url 只改变打印/打开/运行时使用的 URL，不授予任何信任。真正授权浏览器的是 /api 的 Host 围栏，也就是 --trusted-host。只设其中一个，所有 API 调用都会返回 403。两者默认都为空，意思是「只走 loopback + 反向代理」。

3. 3080 端口默认绑定到 127.0.0.1。 在你在前面放上代理、并设置 DSH_PUBLIC_URL/DSH_TRUSTED_HOST 之前，什么都访问不到。

其他验证过的默认值：运行时树是纯 JS（没有 *.node 文件），所以不需要按平台做原生重编译；在 Linux 上 standard 预设会禁用 PowerShell 工具行，shell 是 bash（只有自定义预设重新启用它时才需要装 pwsh）；Office→PDF 用 LibreOfficeKit WASM 引擎，因为没有发布原生 Linux 引擎包，所以需要那些字体包和 2 GB 内存上限；全文会话搜索默认关闭（openAt: never、:memory:）；桌面配置档之外不运行任何遥测。

版本

锁定在 0.2.1-rc.3，这是开发者预览版，预计会有破坏性变更。npm 的 latest dist-tag 仍是 0.2.1-rc.2；next 跟踪 rc.3。改动 Dockerfile 里的 DSH_VERSION（以及 docker-compose.yml 里的构建参数）时，要一起改。

状态

这些文件是在没有 Docker 命令行的机器上写的，所以镜像还没在这里构建过，也没做过冒烟测试。先跑 docker compose config，再跑 up -d --build。