DeepSeek Harness 是 DeepSeek 开源的插件化 AI 智能体框架,在阿里云计算巢可以直接用官方模板一键拉起 ECS 云服务器,自动装好 Node、依赖、反向代理,不用手动敲复杂环境命令,新手几分钟就能完成部署,也支持单独在 ECS 上手动部署调试,两种方式都能打开 WebUI,接入兼容 OpenAI 协议的大模型接口,搭建可以自动拆解任务、调用工具、运行代码的 Agent 平台。它本身不是大模型,是智能体调度运行框架,核心是 “一切皆插件”,文件读写、网页抓取、代码解释器、Shell 执行都靠插件扩展,所以部署成功之后,重点是配置模型 API 密钥、新建独立工作区,还要做好权限管控,避免 AI 误操作服务器文件。计算巢一键方案优势是自动处理 VPC、安全组、Nginx 反向代理,走安全代理访问 WebUI,不用直接把 3080 端口暴露公网,安全性更高;手动 ECS 方案适合懂 Linux、想要自定义环境、二次开发插件的开发者。
一、前置准备清单
- 阿里云账号,开通计算巢、ECS 服务权限
- 模型 API Key(DeepSeek、百炼等兼容 OpenAI 协议的密钥,密钥地域和 ECS 地域保持一致)
- 网络:服务器能正常访问 npm 包源、模型接口地址
- 版本硬性要求:Node.js ≥22.19(计算巢模板自动安装,手动 ECS 需要自行安装)
- 系统推荐:Alibaba Cloud Linux、Ubuntu 22.04 LTS
二、硬件配置参考表
| 使用场景 | 推荐 ECS 规格 | 系统盘 | 备注 |
|---|---|---|---|
| 简单测试、体验功能 | 1 核 2G | 40G | 适合少量会话、简单任务 |
| 日常开发、多插件并发 | 2 核 4G | 60G | 绝大多数开发者首选 |
| 长期跑批量 Agent 任务 | 4 核 8G 及以上 | 80G+ | 适合代码工程、批量文件处理 |
三、方式一:计算巢一键部署(推荐新手)
- 进入阿里云计算巢控制台,搜索 DeepSeek Harness 社区版模板,同意服务协议
- 填写部署参数:选择地域、付费类型、设置 ECS 实例密码,其余参数默认即可
- 确认订单,勾选协议,点击立即创建,部署等待大约 3 分钟
- 部署完成,在实例详情输出栏拿到安全代理访问地址,直接打开 WebUI
- 进入设置页面填入 API Key,新建独立工作区,加载需要的插件,开始使用
端口说明:程序内部监听 13080,Nginx 反向代理到 3080,由计算巢安全代理转发访问
四、方式二:ECS 云服务器手动部署(适合自定义开发)
- 购买 ECS,放行 22 端口用于 SSH 登录,不建议直接开放 3080 公网
- SSH 登录服务器,安装 Node.js 22.19 + 版本、git、pnpm
- 两种启动命令任选其一
- 快速启动:npx @deepseek-ai/dsh web
- 源码部署:git 拉取仓库,安装依赖后启动 web 服务
- 配置 Nginx 反向代理,增加访问鉴权,避免裸奔暴露 WebUI
- 浏览器访问代理地址,配置 API 密钥、插件、工作区
五、部署后基础配置步骤
- 模型配置:在 WebUI 设置页填入 API 地址、密钥,选择对应模型
- 工作区设置:单独新建空白目录作为 Agent 工作目录,不要直接用系统重要目录
- 插件管理:按需开启代码解释器、网页检索、文件操作插件,不用的插件关闭
- 用量告警:在模型服务商后台设置 Token 消耗上限,防止 Agent 循环调用超额扣费
- 权限管控:不要用 root 账号运行 dsh,限制 Agent 读写范围
六、高频踩坑点和解决办法
- Node 版本过低,启动报错:升级到 22.19 及以上稳定版本
- API Key 地域不匹配,调用失败:ECS 地域和密钥所属地域保持一致
- 访问 WebUI 打不开:检查计算巢实例是否部署完成、安全代理链接是否正常
- Agent 乱删文件:严格隔离工作目录,关闭高危 Shell 插件,做好权限限制
- 依赖下载超时:切换国内 npm 镜像源
七、安全重要提醒
- 优先使用计算巢安全代理访问,避免 3080 端口直接对公网开放
- API 密钥不要硬编码写进配置文件,WebUI 内填写,密钥不要截图外传
- Agent 具备执行命令、读写文件能力,生产环境必须增加身份认证
- 测试完成不用的时候及时释放 ECS,避免持续产生云服务器费用
【常见问题】
问题 1:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,DeepSeek Harness 是大模型吗?
回答 1:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,DeepSeek Harness 不是大模型,它是开源 AI 智能体调度框架,用来编排 Agent、调用工具,需要搭配兼容 OpenAI 协议的模型 API 使用。
问题 2:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,计算巢一键部署和 ECS 手动部署有什么区别?
回答 2:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,计算巢模板自动创建 ECS、装环境、配反向代理,上手简单更安全;ECS 手动部署自由度高,适合二次开发、自定义环境。
问题 3:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,部署 DeepSeek Harness 对 Node.js 版本有什么要求?
回答 3:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,硬性要求 Node.js 版本≥22.19,版本过低会出现依赖加载失败、插件报错、服务无法启动。
问题 4:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,部署之后怎么防止 AI 误删服务器文件?
回答 4:阿里云计算巢 / ECS 云服务器一键部署配置 DeepSeek Harness,新建独立空白文件夹作为 Agent 工作区,不要指向系统目录,不用 root 运行,按需关闭 Shell 等高风险插件。
【参考资料】
[2026-11-16](2 天前 2026 年,装个 DeepSeek Harness,账号密钥全都不用,13 家大厂模型一次打通)阿里云开发者社区
[2026-11-04](DeepSeek Harness 阿里云计算巢 / 云服务器保姆级部署指南)阿里云开发者社区
[2026-11-03](新手必看!阿里云计算巢 & ECS 轻松部署 DeepSeek Harness,全程傻瓜式操作)阿里云开发者社区
[2026-11-01](DeepSeek Harness 方案部署页)阿里云官网方案页
[2026-10-12](阿里云部署 DeepSeek Harness 开源智能体:获取百炼 API‑Key 到 WebUI 配置全流程)阿里云开发者社区
【免责声明】
本文仅为阿里云计算巢、ECS 部署 DeepSeek Harness 的公开教程资讯整理,不构成阿里云产品采购、线上生产落地建议。DeepSeek Harness 为开发者预览版开源项目,存在版本迭代、BUG 风险;云服务器、模型 API 调用会产生费用,部署前请了解阿里云计费规则、模型 Token 计费规则,线上生产部署务必完善身份认证、权限隔离、审计管控。
