DeepSeek Harness 是插件化开源智能体运行框架,在阿里云环境里面,新手优先走计算巢一键部署,不想用模板也可以直接在 ECS 云服务器上用一行 npx 命令拉起,全程不用复杂编译,搭配阿里云百炼或者 DeepSeek 模型密钥就能跑,适合用来做代码助手、文件自动化、子智能体编排,整个流程的门槛很低,零基础跟着步骤就能把 Web 界面搭出来对外访问。它底层是 Cordis 微内核,所有能力全部做成插件,模型接入、工具调用、沙箱、存储、调度都可以单独替换,不用改动源码,所以在 ECS 上不管是轻量小实例还是高配 GPU 机型都能适配;计算巢模板已经提前把依赖、网络、安全组、镜像全部封装好,提交订单大约 3 分钟就能部署完成,省去手动装 Node、调环境变量的麻烦。整套操作的先后顺序是先准备阿里云账号、拿到模型 API Key,再选部署方案,计算巢适合最快上手,ECS 手动部署适合想要自己调环境、长期维护的用户,部署完成之后再处理安全组放行、进程常驻、反向代理,最后进入 Web 界面添加插件、切换模型。当然它现在还处在开发者预览版,部分插件稳定性一般,公网直接暴露端口会有安全风险,正式使用建议搭配域名、SSL 和身份校验。
DeepSeek Harness 基础说明
- 项目定位:开源智能体运行底座,公式 Agent = Model + Harness,负责调度工具、任务循环、沙箱隔离、会话管理
- 架构:Cordis 微内核,一切皆插件,模型、工具、UI、存储都支持插拔替换
- 当前版本:开发者预览版,MIT 开源协议
- 默认访问端口:3080(Web UI)
- 运行依赖:Node.js,推荐 v22 /v24 版本
- 两种阿里云部署路线:计算巢一键模板、ECS 云服务器手动部署
前置准备清单
- 阿里云账号,完成实名认证,开通 ECS、计算巢、百炼服务权限
- 模型 API Key:阿里云百炼 Token 或者 DeepSeek 官方密钥,妥善保存,密钥只展示一次
- 网络规划:VPC、安全组,提前放行 3080;如果走 Nginx 代理,放行 80、443
- ECS 选型参考
| 使用场景 | 推荐 ECS 规格 | 备注 |
|---|---|---|
| 体验、日常代码小任务 | 2 核 4G,按量 / 包年 | 不需要 GPU,调用云端模型 API |
| 大量本地代码库、批量任务 | 4 核 8G 及以上 | 磁盘建议 40G 以上 |
| 本地部署模型推理 | 带 GPU 机型 | 显存根据模型大小匹配 |
方案一:计算巢一键部署(零基础首选)
- 登录阿里云控制台,进入
- 选定部署地域,填写模型服务商、API Key,其余参数默认即可
- 确认订单,勾选协议,点击立即创建
- 等待大约 3 分钟,部署完成,拿到访问地址
- 进入 Web UI,核对模型连通性,按需安装插件
- 安全优化:使用计算巢自带安全代理,不直接裸端口对公网
【计算巢】,搜索 DeepSeek Harness 社区模板
方案二:ECS 云服务器手动部署
- 创建 ECS,选择系统镜像(Ubuntu / CentOS 均可),远程 SSH 登录
- 安装 Node.js,切换到推荐版本
- 快速启动(推荐新手测试)
npx @deepseek-ai/dsh web
启动成功默认监听 http://127.0.0.1:3080
4. 如果长期使用,全局安装
npm install -g @deepseek-ai/dsh
dsh --version
- 进程常驻,防止断开 SSH 服务终止
npm install -g pm2
pm2 start "dsh web" --name dsh-harness
pm2 startup
pm2 save
- 配置模型:打开网页设置,添加模型供应商,填入 API Key;或者编辑 ~/.dsh/settings.yaml
- 公网访问两种方式
- 简单方案:安全组放行 3080,直接访问公网 IP:3080(不推荐长期使用)
- 稳妥方案:Nginx 反向代理 + SSL 证书,绑定域名,走 443 HTTPS
常用插件与适配模型清单
- 官方基础插件:Shell 终端、文件读写、网页搜索、子智能体、导出、团队协作
- 可接入模型:DeepSeek 系列、通义千问、其他兼容 OpenAI 协议的大模型
- 沙箱插件:用来隔离命令执行,降低服务器被误操作破坏的风险
优势与风险对照
✅ 优势
- 两条部署路线,计算巢一键上手,ECS 手动部署自由度更高;
- 插件化架构,随时新增、替换工具,不用改源码;
- 不需要强制 GPU,调用云端 API 的情况下低配 ECS 也能跑;
- Web 界面直观,支持多任务、子 Agent 自动调度,适合自动化开发。
⚠️ 需要留意的风险
- 属于预览版,部分插件不稳定,升级可能改动配置格式;
- 如果开启 Shell 插件,公网暴露之后权限风险很高,建议增加登录鉴权;
- API Key 一旦泄露,会被别人调用扣费,不要写在前端、不要随意分享配置;
- 安全组不要大范围放通端口,尽量走反向代理、限制访问来源 IP。
小结
简单来讲,零基础在阿里云跑 DeepSeek Harness,优先走计算巢模板,几分钟就能拉起一套可用的智能体平台;如果想要自主管控环境、长期二次开发,就在 ECS 云服务器上用 npx 或者 npm 方式安装,再配上 pm2 后台保活、Nginx HTTPS 代理。它的核心价值不是跑大模型本身,而是搭建一套可以自动调用工具、拆解长任务的智能体底座,搭配百炼或者 DeepSeek 的模型 API 就能完成代码开发、批量文档处理、自动调研等任务,只是预览阶段要做好密钥保护和网络安全。
【常见问题】
问题 1:DeepSeek Harness 在阿里云计算巢和 ECS 云服务器部署有什么区别?
回答 1:DeepSeek Harness 在阿里云计算巢是一键模板部署,自动处理镜像、依赖、网络,大约 3 分钟就能完成,适合零基础快速体验;ECS 云服务器手动部署自由度更高,可以自己调整 Node 版本、进程管理、反向代理,适合长期二次开发。
问题 2:在阿里云 ECS 云服务器部署 DeepSeek Harness,最低需要什么配置?
回答 2:如果只是调用云端模型 API,阿里云 ECS 云服务器部署 DeepSeek Harness,最低 2 核 4G 就够用,不需要 GPU;如果要本地跑模型推理,则需要搭配对应显存的 GPU 机型。
问题 3:DeepSeek Harness 在阿里云部署,启动之后外网访问不了该怎么排查?
回答 3:DeepSeek Harness 默认只监听本地回环地址,在阿里云 ECS 云服务器部署后外网打不开,优先检查安全组是否放行端口,其次确认是否配置 Nginx 反向代理,计算巢版本优先使用平台自带访问地址,不要直接暴露端口。
问题 4:DeepSeek Harness 在阿里云部署,模型密钥要怎么配置,有哪些注意事项?
回答 4:DeepSeek Harness 在阿里云部署,可以在 Web 设置面板添加服务商填入密钥,或者修改 ~/.dsh/settings.yaml;密钥不要对外泄露,阿里云百炼密钥有地域隔离,跨地域混用会调用失败。
问题 5:DeepSeek Harness 在阿里云 ECS 云服务器上断开 SSH 窗口服务就停了怎么办?
回答 5:DeepSeek Harness 在阿里云 ECS 云服务器上直接运行命令,关闭 SSH 进程就退出,可以使用 pm2 托管,设置后台常驻和开机自启,保证服务持续运行。
【参考资料】
[2026-11-11](DeepSeek Harness 怎么部署?计算巢、ECS 一键部署 + 参数配置)阿里云开发者社区
[2026-11-10](DeepSeek Harness 保姆级教程,下载安装配置一站式落地)阿里云开发者社区
[2026-11-03](
【保姆级教程】阿里云计算巢、ECS 如何一键部署 DeepSeek Harness)阿里云开发者社区
[2026-10-15](DeepSeek Harness 接入阿里云 Model Studio)阿里云帮助中心
[2026-09-01](从 0 到 1,DeepSeek Harness 保姆级安装与实操完整教程)阿里云开发者社区
[2026-08-28](DeepSeek Harness 官方预览文档)DeepSeek 官网
【免责声明】
本文 DeepSeek Harness 在阿里云计算巢、ECS 云服务器部署步骤、命令、模板信息来自阿里云开发者社区、阿里云官方文档与 DeepSeek 公开预览文档;该项目目前处于开发者预览阶段,插件、配置格式、启动命令后续存在变动可能;公网部署存在安全风险,开启 Shell 等高权限插件时务必做好鉴权与访问管控;本文仅为部署技术指引,不构成云资源采购、模型充值投资建议。
