——从零到上线，三步搭建你的专属 AI 智能体平台
一、为什么是 DeepSeek Harness？为什么选阿里云？
当 Agent 开发的浪潮以摧枯拉朽之势席卷全球，一款真正"能干活"的开源智能体框架，就是你手中最锋利的武器。DeepSeek Harness（简称 DSH）——由 DeepSeek AI 以 MIT 协议全面开源，采用"一切皆插件"的架构设计，由 Cordis 引擎驱动。模型调用、代码读写、终端执行、会话记忆、界面渲染……所有能力皆由插件自由组合、灵活替换。GitHub Star 数量飙升至 160k，社区插件生态已然破千六百余款，堪称当下最炙手可热的 Agent 开发基座。
而将它部署在阿里云上，借助阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台的标准化模板能力，再以阿里云百炼大模型服务平台页面获取模型推理密钥，便可实现 7×24 小时云端不间断运行、多设备实时同步、团队协作共享。门槛低、上手快、安全可控、灵活扩展——这不是口号，而是这篇保姆级指南将手把手教你兑现的承诺。
整套流程可概括为三句话：
- 先去阿里云百炼大模型服务平台页面获取 API Key——注意地域隔离，密钥只显一次，丢了就没了；
- 再通过阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台一键部署——约 3 分钟，自动创建 ECS 并完成环境搭建；
- 最后通过计算巢安全代理访问 3080 端口的 Web UI——配置模型、选择工作区、装上插件，即可投入使用。
二、前置准备：两把"钥匙"缺一不可
2.1 第一把钥匙：百炼 API Key
登录阿里云百炼大模型服务平台页面，在右上角选择地域。务必记住：每个地域都有独立的接入域名、API Key 和模型列表，绝不能跨地域混用！ 单击"创建 API Key"，配置完成后单击确定。
重中之重的三条铁律：
| 铁律 | 说明 |
|---|---|
| 密钥只显示一次 | 创建弹窗关闭后，平台采用不可逆加密存储，无法再次查看明文，丢失只能重置！务必立即复制保存到密码管理器。 |
| 地域必须匹配 | API Key 与 Base URL 必须与所选地域一一对应，跨域调用 100% 鉴权失败。 |
| 免费额度先领 | 新用户完成实名认证后，自动发放超 7000 万免费 Token，有效期 90 天，覆盖千问系列、DeepSeek、GLM 等主流模型，零成本即可启动开发。 |
详细的密钥创建与管理操作，请前往阿里云百炼大模型服务平台页面查阅官方指引。
2.2 第二把钥匙：Node.js 运行环境
DeepSeek Harness 要求 Node.js 版本不低于 22.19.0，推荐 22 或 24 稳定版本。若采用阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台官方模板部署，环境会自动预装；若手动部署 ECS，则需自行安装——别偷懒，版本过低会导致依赖报错、启动失败。
三、部署方式一：计算巢一键部署（新手首选，3 分钟搞定）
这是最推荐的方式，尤其适合初次接触 DSH 的开发者。你不需要写一行复杂脚本，不需要手动处理安全组、网络、环境依赖——阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台替你把一切打理妥当。
步骤详解
① 打开控制台
访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台，进入首页即可看到"一键部署"入口。第一次使用计算巢服务需要先同意协议，点确定。
② 配置部署参数
计算巢服务会自动为你创建一台阿里云 ECS 云服务器，按如下参数配置：
| 参数 | 建议值 |
|---|---|
| 地域 | 离你最近的地域（与百炼 API Key 地域保持一致） |
| 付费类型 | 按量付费适合测试调试，包年包月适合长期稳定使用 |
| 实例规格 | 最低推荐 1 核 2G；跑多模型、多插件并发建议 2 核 4G 以上 |
| 实例密码 | 自行设置并妥善记录 |
| 网络/子网 | 无特殊要求默认即可 |
详细参数说明可在阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台查阅。
③ 确认创建
单击"下一步"确认订单，勾选"我已阅读并同意"，单击"立即创建"。部署预计等待 约 3 分钟 即可完成资源交付。
④ 访问 Web UI
部署完成后，在服务实例详情页的"输出"区域查看 deepseek_harness_3080_url。点击输出中的安全代理访问地址，即可打开 DeepSeek Harness Web UI。
安全亮点：计算巢安全代理基于服务实例输出地址访问 3080 端口，ECS 安全组仅放行安全代理出口网段，不直接对公网开放无鉴权 Web 服务，安全性极高，无需你额外开放端口。
四、部署方式二：手动部署 ECS（进阶玩家，二次开发必备）
如果你希望自定义修改源码、开发私有插件，就需要亲自上阵。这套方案同样离不开阿里云百炼大模型服务平台页面提供的模型能力支撑。
4.1 SSH 连接服务器
ssh root@你的实例公网IP
连接成功后，先执行基础命令确认环境：
cat /etc/os-release # 查看操作系统版本\free -h # 查看内存占用\df -h # 磁盘空间检查
硬件层面，测试验证 2 核 2G 配置的 Linux 服务器就可以稳定运行 DSH，操作系统推荐 Debian 12，也兼容 Ubuntu 等主流发行版。
4.2 安装 Node.js 与 pnpm
# 安装 Node.js 22\curl -fsSL https://deb.nodesource.com/setup_22.x | bash -\# 或 yum install -y nodejs\
\# 安装 pnpm\npm install -g pnpm
4.3 拉取源码并编译
git clone https://github.com/deepseek-ai/deepseek-harness.git\cd deepseek-harness\pnpm install\pnpm run build
4.4 启动服务
pnpm dsh web
启动成功后，终端输出访问地址 http://127.0.0.1:3080。
快速体验捷径：不想拉取完整代码？直接执行一条命令：
npx @deepseek-ai/dsh web --patch
关键坑点：启动 Web UI 时必须加上 --patch 参数，否则很多插件和技能不会生效！该命令默认在 http://127.0.0.1:3080 启动 Web UI，本机启动时会自动打开浏览器。
4.5 Nginx 反向代理（公网访问必备）
若需公网访问，配置 Nginx 反向代理：
location / {
\proxy_pass http://127.0.0.1:3080;\proxy_set_header Host $host;\proxy_set_header X-Real-IP $remote_addr;\}
4.6 通过 1Panel 图形化部署（降低门槛）
如果你不想全程命令行，可以使用开源现代化 Linux 运维面板 1Panel，它内置应用商店，支持容器化一键部署 DSH：
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
安装完成后，浏览器打开 服务器IP:面板端口/安全入口，登录后台 → 应用商店 → 搜索"DeepSeek Harness" → 配置 HTTPS 端口与访问地址 → 一键安装。部署完毕访问 https://服务器IP:10443，输入 Web 账号密码即可进入。
五、核心配置：模型接入与工作区设置
5.1 模型配置——让 Agent"有脑可思"
Web UI 打开后还不能直接对话，核心在于模型配置。有两种方式：
方式一：Web UI 界面配置
点击左下角"设置" → 进入"Models / 模型"配置页 → 添加自定义模型服务商 → 填入阿里云百炼大模型服务平台页面的接口地址、API Key → 选择 Token Plan 中开通的模型。
方式二：直接编辑配置文件
vim ~/.dsh/settings.yaml
写入对应的 provider、apiKey、baseUrl 和默认模型名称，保存退出。
关于模型选择：当前阿里云百炼大模型服务平台页面汇聚了 150 余款主流大模型，涵盖通义千问系列（qwen3.8-max、qwen3.8-flash、qwen3.7-plus 等）、DeepSeek-v4-pro、GLM-5.2、Wan3.0-Video、Kimi、智谱等多模态矩阵。双十一期间更推出"全模型通享低至 4.5 折"政策，配合 Token Plan 订阅（个人版 39 元/月起），以 Credits 统一抵扣文本、图像、语音、代码解释器等多模态能力。
5.2 工作区选择——让 Agent"有地可耕"
返回首页，点击"选择工作区"。工作区是 Agent 读写文件、执行脚本的目录，建议单独划分一个目录存放项目，避免误操作修改系统文件。服务实例已在 ECS 上准备 /opt/deepseek-harness/workspace 作为默认工作目录，会话记录、凭据、存储和附件数据保存在 /opt/deepseek-harness/dsh-home 下。
六、插件生态：从"能用"到"好用"的飞跃
DeepSeek Harness 原生自带基础对话、终端、文件读写插件，但想要更强的能力，就需要安装社区插件。安装命令只有一条：
dsh plugin --profile web add "github:owner/repo#ref"
以下是日常开发高频使用的插件推荐：
| 插件 | 功能 | 安装思路 |
|---|---|---|
| dsh-web-ui | 聚合任务看板、Git 可视化面板、Token 消耗监控、界面美化 | dsh plugin --profile web add "github:xxx/dsh-web-ui#main" |
| dsh-memory-plugin | 会话长期记忆、用户画像自动召回，适合长期项目连续调试 | dsh plugin --profile web add "github:xxx/dsh-memory-plugin#main" |
| 定时任务插件 | 支持 Cron 定时调度，让 Agent 定时执行脚本、巡检服务 | dsh plugin --profile web add "github:xxx/dsh-cron#main" |
| 语音输入插件 | 语音转文字下发指令，适合快速交互 | dsh plugin --profile web add "github:xxx/dsh-voice#main" |
| Agent Teams | 多智能体拆分协作，处理复杂大型开发任务 | dsh plugin --profile web add "github:xxx/agent-teams#main" |
全部插件开启后，重启服务生效：
pnpm dsh web restart
插件详情与最新收录，可前往阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台查阅社区生态汇总。
七、Python SDK 调用：代码中直接驾驭 Harness
如果你想在自己的 Python 项目中直接调用 DeepSeek Harness，可以安装官方 SDK：
python -m pip install deepseek-harness-sdk
示例代码：
from deepseek_harness import Harness\
\h = Harness()\result = h.run(tasks="hello world")\print(result)
八、高频问题排雷手册
| 问题 | 原因与解决 |
|---|---|
| 3080 端口访问异常 | 3080 是默认 Web 端口。手动部署需在安全组放行端口或配置 Nginx 反向代理；计算巢部署则通过安全代理自动处理，无需额外操作。 |
| API Key 鉴权失败 | 核对密钥是否正确、地域是否匹配、Token Plan 额度是否充足。额度耗尽后模型调用会直接报错，可在控制台开启"额度用尽即停止调用"开关。 |
| 插件不生效 | 启动 Web UI 时忘记加 --patch 参数！务必使用 npx @deepseek-ai/dsh web --patch。 |
| 地域混用导致调用失败 | 每个地域有独立的接入域名和 API Key，必须一一对应，绝不能跨域。 |
| 密钥丢失无法找回 | 平台不可逆加密存储，丢失只能重置。创建后务必立即复制保存！ |
九、写在最后：从部署到创造
从模型调用到智能体编排，从本地调试到团队协作，从零代码上手到二次开发扩展——这套基于 阿里云 ECS 云服务器 + 阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 + 阿里云百炼大模型服务平台页面 的全链路方案，为你铺平了从"想法"到"上线"的每一步路。
现在就行动：
- 打开阿里云百炼大模型服务平台页面，完成实名认证，领取免费 Token，创建 API Key；
- 进入阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台，跟随图文教程一键部署；
- 配置模型、选择工作区、装上插件——你的专属 AI 智能体，即刻上线。
AI 不应该是少数人的特权，而应该是每个人的工具。从今天开始，让 DeepSeek Harness 成为你的智能伙伴，让阿里云成为你最坚实的云上基座。
