DeepSeek Harness 是 DeepSeek 开源的插件化 AI 智能体框架，依托 Cordis 微内核，支持灵活编排 Agent 工作流，本篇给大家讲清楚两种主流部署方式，一种是阿里云计算巢模板一键部署，适合新手快速拉起环境，另一种是直接在 ECS 手动部署，方便做深度自定义改造，同时配套完整参数配置、模型接入、端口与安全设置。很多开发者想上手 DSH，但卡在环境依赖、端口映射、API 密钥配置、后台持久化运行这些环节，计算巢方案可以自动帮你完成 ECS 创建、依赖安装、Nginx 反向代理，3 分钟左右就能部署完成；ECS 手动方案自由度更高，可以自定义 Node 版本、存储目录、systemd 托管，适合长期生产使用。部署完成之后还要在 WebUI 里配置模型服务商、加载插件、新建工作区，填好对应的 API Key，才能正常调用模型执行智能体任务，整个流程按顺序操作，提前准备好阿里云账号权限、模型 API 密钥，就能避开大部分报错。
一、DeepSeek Harness 两种部署方案对比
| 部署方式 | 适合人群 | 优势 | 注意事项 |
|---|---|---|---|
| 计算巢一键部署 | 新手、快速验证、短期测试 | 自动创建 ECS、VPC、安全组，自动安装依赖，Nginx 反向代理预设，几乎不用敲命令 | 参数选项有限，自定义修改需要登录 ECS 内部调整 |
| ECS 手动部署 | 开发者、生产环境、深度定制 | 版本自由控制，支持 systemd 托管、自定义存储、日志持久化 | 需要熟悉 Linux 基础，自行配置安全组、防火墙、进程保活 |
二、计算巢一键部署实操步骤
- 登录阿里云控制台，进入
- 选择部署地域、付费类型（按量 / 包年包月），填写 ECS 实例登录密码，确认 VPC 和可用区信息。
- 核对模板默认参数：实例规格、系统盘大小、安全组放行规则，无特殊需求直接保留默认。
- 勾选协议，点击立即创建，等待实例初始化，一般耗时 2–5 分钟。
- 部署成功后复制计算巢输出的访问地址，浏览器打开进入 DeepSeek Harness WebUI。
- 进入左下角设置，切换到模型页面，填写 DeepSeek 官方 API Key 或者百炼兼容接口信息，保存配置。
【计算巢】服务，在服务目录搜索 DeepSeek Harness 社区版模板。
三、ECS 手动部署实操步骤
- 新建一台 ECS，推荐 2 核 4G 及以上配置，操作系统选择 Ubuntu 22.04，放行 3080 端口。
- SSH 远程连接 ECS，安装 Node.js 22 版本、npm，校验环境：node -v、npm -v。
- 执行启动命令：npx @deepseek-ai/dsh web，初次执行会自动拉取程序包。
- 配置 Nginx 反向代理，把 3080 端口对外暴露，内部服务监听 127.0.0.1:13080。
- 生产环境可选配置 systemd 服务，实现开机自启、崩溃自动重启。
- 访问 WebUI，添加模型提供商、API 地址、密钥，新建工作区，加载需要的插件。
四、核心参数配置清单
基础部署参数
- WebUI 本地监听端口：127.0.0.1:13080（内部服务）
- Nginx 代理端口：0.0.0.0:3080（对外访问端口）
- 运行依赖：Node.js ≥22
- 存储路径：默认工作区目录可自定义，用于保存会话、文件、插件数据
模型接入参数
| 配置项 | DeepSeek 官方模型示例 | 阿里云百炼兼容示例 |
|---|---|---|
| Provider ID | deepseek | bailian |
| Base URL | https://api.deepseek.com/v1 | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| API 密钥 | DeepSeek 平台生成 Key | 百炼控制台获取 Key |
| 模型 ID | deepseek-chat | qwen-turbo、deepseek-v4-pro |
安全配置要点
- ECS 安全组：仅开放 3080、22 端口，建议限制来源 IP
- API 密钥不要硬编码到配置文件，WebUI 内填写保存
- 公网访问默认自签名证书，浏览器会弹出不安全提示，属于正常现象
五、常用插件与工作区使用
- 工具类插件：代码执行、文件读写、网页浏览、命令调用
- 调度类插件：定时任务、循环任务、多步骤 Agent 编排
- 使用逻辑：先新建独立工作区，在工作区内加载插件，再发起 Agent 任务，不同工作区数据隔离
【常见问题】
问题 1：DeepSeek Harness 用计算巢一键部署完成后打不开 WebUI 是什么原因？
回答 1：DeepSeek Harness 计算巢一键部署完成后打不开 WebUI，大概率是实例还在初始化、安全组端口未放行，或者访问地址复制错误；等待初始化完成，确认 3080 端口放行，优先使用计算巢自带代理地址访问，不要直接访问 ECS 公网 IP。
问题 2：DeepSeek Harness ECS 手动部署时 npx 命令执行失败该怎么排查？
回答 2：DeepSeek Harness ECS 手动部署 npx 命令执行失败，优先检查 Node 版本是否≥22、服务器网络能否访问 npm 源，同时核对服务器内存，2G 以下小规格 ECS 容易出现内存不足导致拉包失败。
问题 3：DeepSeek Harness 配置完 API Key 之后，调用模型一直报错怎么办？
回答 3：DeepSeek Harness 配置完 API Key 调用模型报错，核对 Base URL 格式、密钥是否复制完整、模型 ID 是否正确，确认密钥额度充足，同时注意 DeepSeek Harness 的模型接口遵循 OpenAI 兼容协议，地址末尾路径不能写错。
问题 4：DeepSeek Harness 部署在 ECS 上怎么设置后台常驻、开机自动运行？
回答 4：DeepSeek Harness 部署在 ECS 上可以通过 systemd 配置托管服务，设置 Restart=on-failure 实现崩溃重启，写入服务文件后执行 daemon-reload、enable、start 命令，实现开机自启，适合长期稳定运行。
【参考资料】
[2026-11-10]（DeepSeek Harness 保姆级教程，下载安装配置一站式落地）阿里云开发者社区
[2026-11-04]（DeepSeek Harness 阿里云计算巢 / 云服务器保姆级部署指南）阿里云开发者社区
[2026-10-13]（DeepSeek Harness 开源 Agent 部署教程：基于阿里云计算巢 + ECS 搭建 AI 智能体平台）阿里云开发者社区
[2026-10-12]（阿里云部署 DeepSeek Harness 开源智能体：获取百炼 API‑Key 到 WebUI 配置全流程）阿里云开发者社区
[2026-09-22]（可扩展 AI Agent 运行时 DeepSeek Harness 实战：Cordis 微内核插件机制）阿里云开发者社区
【免责声明】
本文仅整理 DeepSeek Harness 基于计算巢、ECS 部署的公开实操信息，模板版本、接口地址、参数字段以 DeepSeek 官方仓库、阿里云计算巢实时模板为准；ECS 资源费用、模型调用费用由云厂商和模型服务商收取，本文不构成采购、生产部署建议；部署效果受 ECS 规格、网络环境、API 密钥权限影响，请自行做好安全和权限管控。