在阿里云 ECS 上把 DeepSeek Harness（DSH）跑起来，再装上社区维护的 dsh-agency-agents 专家库，步骤不长，麻烦的是云上独有的几件事：出网、安全组、Node 版本、Web 端口怎么安全访问。这篇按操作顺序走一遍，并写清楚装机阶段最容易踩的四个坑。先说明定位：它是社区维护的 DSH 插件，并非 DeepSeek AI 官方产品；插件概览可以先看 DeepSeek Harness Hub 插件清单。
实例规格与镜像怎么选
单实例自用（一到三人）2 vCPU / 4 GiB 就够；同一实例还要跑构建和浏览器回归的话，建议 4 vCPU / 8 GiB 起步，系统盘 40 GiB ESSD，避免依赖目录与 ~/.dsh 把盘写满。
镜像优先 Alibaba Cloud Linux 3 或 Ubuntu 22.04 LTS。注意 Node 有硬要求：^22.19.0 || >=24.0.0，镜像自带版本偏低时用 nvm 装到 22 LTS，不要拿旧版本硬跑。只装 npm 包不需要额外 pnpm install，从源码安装才需要 pnpm。
安全组、出网与带宽
安全组入方向建议只放行 22，并把源 IP 限制到公司出口或跳板机；DSH Web 端口不要直接对公网开放，改用 SSH 隧道：
本地浏览器打开 http://127.0.0.1:8787 即可访问。出方向至少要能访问 npm registry；没有公网 IP 的实例走 NAT 网关，或把 --registry 指向内网可达的镜像源。带宽按量计费时，升级前先看一眼流量。
安装与校验
用官方 registry 装最新版（不要写死小版本号）：
装完立刻验一遍配置，不要急着重启：
配置输出里必须同时出现 agency-agents 与 agency-agents-remote，确认之后再重启 DSH Web 并做一次浏览器硬刷新。下面四个坑基本都集中在这一段。
坑一 · 手工拷贝 client 文件，设置页里看不到专家入口
现象。 插件看起来「装上了」，但设置页里找不到专家入口，输入框也没有 Experts 选择器。
原因。 手工复制 client 文件绕过了 dsh plugin add，而设置页需要挂载的 Remote 服务——文件在，服务没注册。
解决。 走正规安装：dsh plugin --profile web add <包名或本地目录>。就地安装时用 add .，它会读取 package metadata 与 cordis.patch.yml，不要直接拷 lib。
坑二 · 装完重启了却仍不生效
现象。 命令成功返回，DSH Web 也重启了，界面却没有任何变化。
原因。 只装不验。配置没有真正落进当前 profile，重启多少次都一样。
解决。 先跑 dsh --profile web --dump-config，确认输出含 agency-agents 与 agency-agents-remote；确认无误后再重启 DSH Web，并做浏览器硬刷新。
坑三 · 装到一半报 unmet peers
现象。 安装中途报 unmet peers，看上去像依赖树坏了。
原因。 禁用 auto-install-peers 的 profile 可能报 unmet peers；严格的 peer 检查也可能阻断安装。这类提示不一定代表运行时真的坏了。
解决。 检查宿主版本与浏览器模块可用性，不要只凭 npm 依赖树断定运行时失败；必要时对照支持版本白名单调整 profile 的 peer 策略。
坑四 · PowerShell 里输出乱码
现象。 在 PowerShell 里跑 dsh plugin … 与 --dump-config，输出是乱码，无法判断是否装成功。
原因。 终端默认代码页不是 UTF-8。
解决。 先把 [Console]::OutputEncoding 与 $OutputEncoding 设成 UTF-8，再执行命令：
云上目录与备份
插件配置与 profile 数据落在宿主侧的 ~/.dsh 下；自定义专家数据存在 DSH 设置的 agency-agents 命名空间里，在插件目录之外，所以升级插件不会清掉它。仍建议把 ~/.dsh 纳入 ECS 快照或定期同步到 OSS，尤其在换镜像、换实例规格之前。一条边界要记住：恢复自定义数据与回滚插件代码是两件独立的事。
总结
ECS 上部署这件事，工程量不在安装命令，而在云侧三件事：镜像里的 Node 要满足 ^22.19.0 || >=24.0.0、安全组别把 Web 端口裸放公网、装完必须用 --dump-config 验证再重启。把这几步做扎实，DeepSeek Harness Hub 插件清单 里其他插件的安装逻辑也能照这个流程套用。
适合与不适合
适合：已有 ECS 并希望把 DSH 固定成云端常驻服务的团队；需要多人通过 SSH 隧道访问同一实例的小团队；想先把安装链路验证清楚再上生产的运维同学；已把 ~/.dsh 纳入备份策略的环境。
不适合：期望专家自动层层派活的场景，它不支持递归委派；宿主版本随意升级的环境，支持版本是白名单，更早的 0.1.6 / 0.1.7 alpha 不受支持；需要官方支持的场景，它是社区维护插件，安全扫描结论也请如实看待——静态扫描标记为「含敏感能力」、共 11 处证据、尚无人工评估。
标签：专家智能体库、DeepSeek Harness、阿里云 ECS 部署、运维实践
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
