supernpc/dsh repository overview

⁠supernpc/dsh

DeepSeek Harness（dsh）Web UI 的开箱即用镜像。运行方式等价于官方 npx @deepseek-ai/dsh web， 但 dsh 本体和常用插件在构建期就已装进镜像 —— 启动不需要联网拉包，也不需要在浏览器里逐个点安装。

容器内自带一层 nginx（0.0.0.0:8080 → 127.0.0.1:3080），对外只需映射 8080。

⁠Tags

⁠预装插件

插件版本在每次构建时直接跟踪各自 npm 的 @latest（不再钉死某一版），因此会随作者发布而更新。 若某插件最新版尚未声明兼容当前 dsh，该次构建会跳过它而不是失败（构建日志里有 SKIP 提示）， 作者把当前 dsh 加进白名单后下一轮构建会自动装回。

⁠端口

⁠docker-compose 运行

services:
  dsh:
    image: supernpc/dsh:latest
    container_name: dsh
    restart: unless-stopped
    ports:
      # 宿主机端口随意，容器侧必须是 8080
      - 3080:8080
      # 可选：dsh-pocket 局域网扫码直连
      # - 3081:3081
    environment:
      TZ: Asia/Shanghai
    volumes:
      # 数据卷（会话 / 配置 / 凭据 / 插件），首次创建自动从镜像灌入
      - dsh-data:/root/.dsh
      # 要让 dsh 操作的项目目录挂进来即可
      # - /your/projects:/workspace/projects

volumes:
  dsh-data:

docker compose up -d
docker compose logs -f dsh     # 出现 http://127.0.0.1:3080 的 URL 行即启动完成

打开 http://127.0.0.1:3080，首次进入在设置页配置模型 API key。

⁠升级

docker compose down
docker compose pull
docker compose up -d

/root/.dsh 里的会话与配置会保留。镜像升级后如果插件没跟着更新，加一次环境变量 FORCE_SEED=1 再 up -d（会把插件恢复到镜像版本，不动会话等运行数据），完成后移除。

⁠注意事项

• 需要配置才能用的插件：ModLens 需要填一个视觉 API key（设置页）；dsh-im 各渠道在设置页 扫码 / 填 token；其余插件装上即用。
• 安全：dsh 的 API 能执行 shell。请只映射到本机或可信网络 （-p 127.0.0.1:3080:8080），公网访问建议加反向代理鉴权或使用 dsh-pocket 的密码模式。
• 插件缺失：如果你发现某个插件没装上，大概率是本次构建时它还没有声明兼容当前 dsh 的版本， 被自动跳过了（构建日志有 SKIP 提示）。等插件作者发版后拉取更新的镜像即可。