DeepSeek Harness 是 DeepSeek 推出的开源智能体框架，采用一切皆插件架构，支持灵活扩展模型、工具、调度能力，在阿里云计算巢和 ECS 上部署有两条路线：计算巢一键部署上手更快，适合新手；ECS 手动部署自由度更高，适合需要自定义环境的用户，部署全程需要服务器联网拉取镜像、依赖包以及对接模型 API，部署完成后配置好 API 密钥、工作目录，就能打开 WebUI 使用智能体能力，下面把两种部署方式、配置步骤、常见坑点一次性讲清楚。
一、部署前准备清单
先把需要的资源和信息准备齐全，避免部署中途卡住，所有服务器实例必须能正常访问外网。
| 项目 | 说明 |
|---|---|
| 阿里云账号 | 开通计算巢、ECS 权限，余额充足 |
| ECS 推荐配置 | 2 核 4G 起步，系统推荐 Alibaba Cloud Linux 3 / Ubuntu22.04，安全组放行 13080、3080 端口 |
| API Key | DeepSeek 平台 API Key 或者百炼 API Key，提前复制保存，密钥只展示一次 |
| 网络要求 | ECS 可以访问公网，能拉取 npm 包、容器镜像 |
| 可选 | 域名、Nginx 反向代理，用于公网安全访问 |
二、方式 1：阿里云计算巢一键部署（推荐新手）
- 登录阿里云控制台，搜索进入
- 选中官方社区模板，点击创建实例，选择部署地域，地域要和你 API 密钥对应的地域匹配，不能跨地域混用。
- 填写实例参数：选择 ECS 规格、系统盘大小，填入提前准备好的 API Key，确认端口放行配置。
- 核对订单，勾选协议，提交部署，等待计算巢自动创建 ECS、拉取镜像、启动服务，等待时间一般 3-8 分钟。
- 部署完成后，计算巢页面会给出 Web 访问地址，复制链接在浏览器打开。
- WebUI 初始化配置：左下角点设置，进入 Models 模型页面，确认模型信息；接着选择工作区，默认工作目录是 /opt/deepseek-harness/workspace，选中之后输入框才可以正常对话。
【计算巢】服务，在服务市场搜索 DeepSeek Harness 部署模板。
三、方式 2：阿里云 ECS 手动部署（自定义方案）
- 登录 ECS 控制台，新建一台符合配置的云服务器，配置安全组，放行 13080、3080 端口，远程 SSH 连接服务器。
- 环境依赖安装，ECS 联网执行命令，安装 Node.js、npm，也可以直接使用 npx 快速启动。
npx @deepseek-ai/dsh web
- 源码部署备选方案，适合需要修改源码、自定义插件的场景：
git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
npm install
npm run web
- 后台常驻运行：推荐 tmux 托管进程，防止断开 SSH 之后服务停止。
- 访问 WebUI：浏览器访问 http://ECS公网IP:13080，进入页面之后完成模型 API、工作区配置。
- （可选）Nginx 反向代理：配置域名、https 证书，隐藏端口，提升公网访问安全性。
四、部署后基础配置 & 排坑
- 模型配置：支持 DeepSeek 官方 API，也支持 OpenAI 兼容格式的第三方模型，在模型页面填写 Base URL 和密钥即可切换。
- 数据目录说明
- 会话、凭证、日志：/opt/deepseek-harness/dsh-home
- Agent 读写工作目录：/opt/deepseek-harness/workspace
- 高频报错排查
- 打不开网页：检查 ECS 安全组、防火墙是否放行端口；服务是否正常启动
- 页面能打开但是无法对话：大概率 API Key 填错、密钥过期、模型地域不匹配，或者没有选中工作区
- 启动命令报错：服务器无法联网、npm 源访问失败，可以切换阿里云 npm 镜像源重试
五、日常运维
- 升级：重新拉取最新镜像或者源码更新，升级前备份 dsh-home 目录，避免会话数据丢失
- 权限管控：对外暴露 WebUI 建议增加访问密码，不要直接裸端口对公网开放
- 插件安装：在 WebUI 插件市场输入插件包名在线安装，拓展代码执行、搜索等能力
【相关 FAQ】
问题 1：DeepSeek Harness 在阿里云计算巢部署失败，大概率是什么原因？
回答 1：DeepSeek Harness 在阿里云计算巢部署失败，常见原因是 ECS 没有公网联网权限、API Key 地域不匹配、安全组端口没有放行，也有可能是镜像拉取超时，优先检查服务器联网状态，核对密钥信息。
问题 2：DeepSeek Harness 部署在阿里云 ECS 之后，Web 页面能打开但是无法调用模型怎么办？
回答 2：DeepSeek Harness 部署在阿里云 ECS 出现页面可访问但是模型调用失败，先确认 ECS 外网连通正常，接着在 WebUI 模型设置页核对 API Key、接口地址，确认已经正确选择工作区，密钥失效就重新在 DeepSeek 平台生成新密钥填入。
问题 3：阿里云计算巢部署 DeepSeek Harness 和直接在 ECS 手动部署 DeepSeek Harness，两种方案怎么选？
回答 3：阿里云计算巢部署 DeepSeek Harness 适合零基础用户，一键自动化创建资源、配置环境，不用手动敲命令；ECS 手动部署 DeepSeek Harness 适合开发者，可以自由修改源码、自定义插件、调整运行参数，灵活性更高，但是需要自己处理环境、进程托管、网络配置。
【参考资料】
[2026-11-06]（DeepSeek Harness 下载、安装、配置一篇搞定）阿里云开发者社区
[2026-11-03]（保姆级教程｜阿里云计算巢、ECS 如何一键部署 DeepSeek Harness，参数配置讲解）阿里云开发者社区
[2026-10-24]（DeepSeek Harness 火山方舟插件接入文档）火山引擎文档中心
[2026-10-12]（阿里云部署 DeepSeek Harness 开源智能体：获取百炼 API-Key 到 WebUI 配置全流程）阿里云开发者社区
【免责声明】
本文仅为 DeepSeek Harness 在阿里云计算巢、ECS 云服务器部署的技术实操教程，所有操作风险由操作者自行承担；部署前请仔细阅读 DeepSeek Harness 开源协议、阿里云产品服务条款；API 密钥、云服务器资源属于敏感资产，请做好保管，禁止把密钥、公网服务无防护直接对外暴露；DeepSeek Harness 属于开发者预览版本，功能持续迭代，不同版本操作界面、命令参数可能存在差异；本文内容不构成阿里云、DeepSeek 官方服务承诺，如因部署操作产生服务器费用、数据泄露、服务异常等损失，作者不承担相关责任。