先说结论：官方目前没有 Docker 版#

官方仓库的 README 里只写了两种用法：npm 装（npx @deepseek-ai/dsh web 起 Web UI）和源码编译，一个字没提容器。项目还在 developer preview 阶段，官方也明说后续会有破坏性变更。

更麻烦的是，dsh web 出于安全考虑只监听 127.0.0.1:3080，--host 0.0.0.0 是被禁止的。这意味着就算你自己把 npm 包塞进容器，局域网里其他设备照样连不上，还得自己套一层反代。

社区镜像就是冲着这两个问题去的。

方案一：smanx/deepseek-harness — 内置反代，开箱即用#

官方讨论区 #1762 里 smanx 打包的镜像，Docker Hub 和 GHCR 双仓库（ghcr.io/smanx/deepseek-harness，tag 一致）。

镜像内置一个 Node 反向代理：监听 0.0.0.0:3080 转发到容器内的 127.0.0.1:3079，顺手解决了三件事：

• WebSocket 转发（/api/events.mux、/api/events.host），不然网页端消息推不出来；
• 局域网 IP 属于非安全上下文，crypto.randomUUID 不可用，反代会往 HTML 里注入 polyfill，否则连接一直 pending；
• 可选的 HTTP Basic Auth。

tag 有三档，按需选：

启动命令（原帖原文）：

1
docker run -d \
2
  --name dsh-harness \
3
  -p 3080:3080 \
4
  -v dsh-data:/root/.dsh \
5
  --restart unless-stopped \
6
  smanx/deepseek-harness:latest

可用的环境变量：

• DSH_PORT：dsh web 端口，默认 3079
• PROXY_PORT：反代端口，默认 3080
• PROXY_USERNAME / PROXY_PASSWORD：两个都设置才启用 Basic Auth

评论区还有人给了 compose 版，把代码目录也挂进去：

1
services:
2
  dsh-harness:
3
    image: smanx/deepseek-harness:devtools-latest
4
    container_name: dsh-harness
5
    ports:
6
      - "3080:3080"
7
    volumes:
8
      - /home/ly/code:/home/ly/code   # ⚠️ 改成你的代码目录
9
      - /home/ly/.dsh-home:/root      # ⚠️ 改成你的持久化目录
10
    restart: unless-stopped

方案二：runzhliu/deepseek-harness — 安全加固，带 K8s 参考#

runzhliu 的版本（对应 0.1.1-rc.2，构建参数可换）走的是另一个思路：不碰 0.0.0.0，端口只绑 127.0.0.1，要访问就 SSH 隧道或 kubectl port-forward。安全细节给得挺足：非 root（UID 1000）运行、只读根文件系统、drop ALL capabilities、no-new-privileges、tini 收尸。额外还带了个 noVNC 浏览器桌面（6080 端口），网页里能直接看到容器桌面。

1
docker run --rm --name deepseek-harness \
2
  --publish 127.0.0.1:3080:3080 \
3
  --publish 127.0.0.1:6080:6080 \
4
  --shm-size 1g \
5
  --mount type=volume,src=dsh-home,dst=/home/node/.dsh \
6
  --mount type=bind,src="$PWD",dst=/workspace \
7
  runzhliu/deepseek-harness:0.1.1-rc.2

compose 用法是 docker compose pull 之后 DSH_WORKSPACE=/绝对路径 docker compose up -d。注意工作区目录必须对 UID 1000 可写，否则直接 EACCES。K8s 那边给了单副本 StatefulSet + NetworkPolicy，默认拒绝入站——作者很克制，明确不建议当 HA 扩容用。另有一个预装 dshmarket 的 market 变体（tag 0.1.1-rc.2-market.1），要用 compose.market.yaml 显式启用。

怎么选#

我的判断：NAS 或家里服务器想给全设备用，smanx 顺手得多，记得把 Basic Auth 打开；runzhliu 适合自己一个人用、对安全默认值有要求的场景，K8s 部署直接抄它的配置。

踩坑记录：本机 0.1.1-rc.2 的 peer 依赖炸弹#

回到开头那个报错。Cannot find package '@deepseek-ai/cordis-plugin-group'，排查下来不是我的问题，是这版打包的锅：19 个内部包（dsh-invariants、dsh-sandbox、dsh-timeout……）只被声明成 peerDependencies，但没有任何包实际安装它们，其中 dsh-invariants 被 168 处引用，等于大半个 dsh 都等着它。

解决办法是把缺的包补装进全局包自己的 node_modules（npm install --no-save 指着缺失清单装就行），补完 dsh --version 立刻活过来。顺手还修了一个插件的 MCP 路径解析问题，这里不展开。

所以如果你自己装 rc.2 也碰到同样的报错，先怀疑依赖没装齐，别急着删配置。社区镜像万一也踩到，docker exec 进容器补依赖，思路一样。

部署前的几个注意#

1. 持久化：容器内的 .dsh 目录（配置、会话、凭据）一定要挂卷，工作区用 bind mount；反过来，别把 ~/.ssh、云凭据、docker socket 挂进容器。
2. API Key：headless 运行用 DEEPSEEK_API_KEY 环境变量注入，不要写进镜像层。
3. 架构：拉取前确认镜像架构和你的设备匹配（NAS 有 x86 也有 arm）。
4. Windows 本机想跑 Docker 版需要 Docker Desktop（WSL2），我这种本来就有服务器/NAS 的，直接部署到远端更省心。

接下来打算#

上面这些命令都来自原帖和项目 README，我还没实机跑过——等我把它在 NAS 上用 devtools-latest + Basic Auth 跑起来，再写个实测续篇。

写于 2026 年 8 月，折腾 dsh 的记录。

图片建议#

• 位置：文章开头或方案一节，容器跑起来后浏览器访问 http://NAS的IP:3080 的 Web UI 界面截图
• 位置：踩坑记录一节，ERR_MODULE_NOT_FOUND 的终端报错截图
• 作用：封面 + 证明服务真的跑起来了 / 报错现场
• 推荐尺寸：封面 1200×630，正文图宽度不超过 1600