---
title: "DeepSeek Harness：把 dsh 装进容器长期跑"
description: "dsh 是 DeepSeek Harness 的启动器。这一页说明它怎么组织配置、容器化时要挂哪些卷、升级和回滚怎么做，以及哪些不在交付范围内。"
canonical: "https://localdeploy.dev/zh/services/harness"
source: "content/pages/zh/services/harness.md"
lang: "zh"
altPath: "/services/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；插件不兼容就退回旧镜像。交付时会一起验证一次。

## 相关

- [Traefik 反向代理](/zh/services/traefik)
- [cloudflared 内网穿透](/zh/services/cloudflared)
- [定价与付款](/zh/pricing)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "localdeploy.dev",
  "url": "https://localdeploy.dev/",
  "description": "localdeploy.dev helps home labs and small teams assess the hardware they already own, then deploy a local AI assistant with Cloudflare, self-hosting and containers. Free basics, fixed-scope deployment packages, clear boundaries."
}
```
