DeepSeek Harness:把 dsh 装进容器长期跑
dsh 是 DeepSeek Harness 的启动器。这一页说明它怎么组织配置、容器化时要挂哪些卷、升级和回滚怎么做,以及哪些不在交付范围内。
dsh 是什么
DeepSeek Harness 的命令行程序叫 dsh。它不是单个“聊天窗口”,而是一个启动器:一个 profile 就是一组插件 bundle 的有序堆栈,外加你自己的补丁层。dsh web 起 Web profile,在浏览器里用;headless、sdk、acp 这些 profile 给脚本和自动化用。
profile、插件和补丁都放在 $DSH_HOME 下,默认是 profiles/<名字>/。package.json 记录用到的 bundle 和依赖,cordis.patch.yml 是你的覆盖层,再加 home 级补丁。插件用 dsh plugin --profile <名字> <pnpm 参数> 管,本质是转发给 pnpm。
手动跑起来不难。难的是让它长期稳定:重启后自己起来、升级不把插件搞坏、出问题能退回去。
为什么要容器化
- 依赖锁在镜像里,换机器不用重装 Node 和 pnpm。
$DSH_HOME和工作区挂成卷,重建容器不丢配置和会话。- 固定镜像版本,升级前可以留一个能回滚的旧 tag。
- 给容器设 CPU、内存和重启策略,别让它把整台机器拖垮。
交付什么
- 镜像或 Compose:固定 Node 版本和 dsh 版本,非 root 运行。
- 卷:
$DSH_HOME挂出来,工作区单独挂;两个都要能备份。 - 端口和入口:Web 端口只监听内网,前面接 Traefik 或 cloudflared,不直接晾在公网。
- 密钥:模型 API key 和第三方凭据走环境变量或运行时的 secret,不写进镜像,也不进 git。
- 插件:按你的需要装,记录版本范围和禁用项;升级前先确认
engines.dsh范围。 - 健康检查、重启策略和日志轮转。
- 升级步骤:备份
$DSH_HOME、换镜像 tag、验证插件和 Web 能起、不行就回滚。 - 一份验证清单:Web 能打开、插件加载正常、会话还在、重启后自动恢复。
不包含
- 模型权重下载、推理性能调优和 GPU 驱动。
- 修改 dsh 上游代码;确实要改的,单独谈范围。
- 替你申请模型 API 额度或账号。
- 7×24 值守。交付后日常重启和升级你自己能来。
安全上的几条
Web 界面默认不暴露到公网。要外网访问,就套一层 Access 或反向代理的认证,并且只走 HTTPS。容器用非 root,挂载只给需要的目录,尤其是 Docker socket 这种不要随手挂进去。密钥只从环境注入。
适合谁
已经在本地跑 dsh web 或 headless,想让它长期在线、换机器不折腾、升级有退路的人;或者准备给团队共用一套 Harness,需要固定版本和备份策略。
怎么开始
发邮件说明:现在怎么跑 dsh、用的哪个 profile、模型后端是什么、打算放在哪台机器、要不要外网访问。确认范围后给报价。
常见问题
不用容器行不行?
行。直接装在宿主机上更简单,但升级、回滚和依赖冲突都得自己扛。容器换来的是可重复。
数据都在哪?
profile、配置和会话在 $DSH_HOME,业务文件在工作区。把这两处备份好,换机器就是挂回去。
能接本地模型吗?
能,取决于 dsh 侧的 provider 配置。交付时会按你的后端(本地推理服务或 API)配好并验证。
升级会不会丢东西?
按流程先备份 $DSH_HOME 再换 tag;插件不兼容就退回旧镜像。交付时会一起验证一次。