【保姆级教程】阿里云计算巢 / ECS云服务器 一键部署配置 DeepSeek Harness 全流程

简介: DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,采用“一切皆插件”架构与Cordis引擎,支持模型、工具、UI等能力自由组合与替换。本教程详解如何基于阿里云计算巢+百炼API,在ECS上一键部署并安全访问其Web UI,快速构建专属AI Agent平台。(239字)

在智能体(Agent)开发快速普及的背景下,从模型调用到智能体编排再到应用落地的全流程能力,已经成为衡量 AI 开发框架价值的核心指标。DeepSeek Harness(简称 dsh)正是这样一款由 DeepSeek AI 开发、以 MIT 协议全面开源的智能体框架,采用"一切皆插件"的架构设计并由 Cordis 引擎驱动,模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有能力都由插件组合而成,可自由替换、灵活重组。开发者无需改动框架源码,就能在配置层独立选择、替换或扩展任意一项能力,从而搭建出真正属于自己的专属 AI Agent 平台。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。

很多开发者想在可控的云环境中部署这样一套平台,却常常卡在环境搭建、模型接入与访问配置等环节。本教程基于阿里云计算巢与云服务器 ECS,完整讲解 DeepSeek Harness 开源智能体平台的部署流程,覆盖所需云产品、百炼 API Key 获取、计算巢一键部署、Web UI 安全访问与命令行安装方式,并附可直接运行的代码命令,帮助你快速构建支持时空组合能力的专属 AI Agent 平台。

一、先看懂方案架构与所需云产品

在动手之前,先理清 DeepSeek Harness 的方案架构。它作为开源智能体框架,核心设计理念是"一切皆插件",由 Cordis 引擎驱动,支持模型调用、智能体编排及时空组合能力,实现从模型调用到智能体编排的灵活扩展。它以 Python 库、CLI 工具、MCP Server、Anthropic Skill 等多种形态提供能力,开发者既可以在 IDE 或脚本中调用,也可以通过 MCP 协议接入各类工具。

在阿里云上部署本方案,主要涉及三类云产品: 阿里云 ECS 云服务器 用于承载运行环境;百炼 AI 模型服务平台提供模型推理能力;计算巢服务用于一键部署与模板管理。通过计算巢部署 DeepSeek Harness 社区版,采用单机 阿里云 ECS 云服务器 部署方式。具体架构为:DeepSeek Harness Web UI 在实例内部监听 127.0.0.1:13080 端口;Nginx 监听 0.0.0.0:3080 端口并反向代理到本地 Web UI;计算巢安全代理则基于服务实例输出地址访问 3080 端口,实现安全的远程访问。详情👉访问阿里云百炼大模型服务平台页面 了解

整个部署流程可概括为三步:先获取百炼 API Key,再通过计算巢一键部署(约 3 分钟),最后通过 Web UI 进行访问与使用。

二、第一步:获取百炼 API Key

前往阿里云百炼 API Key 页面,在右上角选择地域。需要特别留意的是,每个地域都有独立的接入域名、API Key 和模型列表,不能跨地域混用。单击创建 API Key,在弹窗中配置相关选项后单击确定。

这里有两个关键细节必须牢记。第一,新建的 API Key 仅在创建后显示一次,供你复制或下载保存。平台采用不可逆的加密存储技术,后续无法在控制台中再次查看明文,一旦丢失只能重置,务必立即妥善保存。第二,按量付费的 Base URL 需要复制保存,用于后续接入模型,请与对应的地域一一对应。详情👉访问阿里云百炼大模型服务平台页面 了解

三、第二步:使用计算巢一键部署社区版

打开阿里云计算巢官网,点击进入管理控制台,搜索"DeepSeek Harness",打开对应的计算巢部署模板。参考参数说明完成配置,地域等参数可参考示例值,其他参数选择默认配置即可。单击下一步确认订单,在新页面勾选"我已阅读并同意",单击立即创建,部署预计等待约 3 分钟即可完成。

四、第三步:访问与使用 Web UI

部署完成后,通过计算巢服务实例输出地址访问 3080 端口,即可打开 DeepSeek Harness Web UI 进行使用。外部用户通过该地址即可安全访问,无需额外开放端口。整体来看,这套流程门槛低、上手快:先获取百炼 API Key(注意地域隔离与密钥保存),再通过计算巢一键部署,最后通过 Nginx 反向代理与计算巢安全代理安全访问 Web UI,即可投入使用。

五、命令行与代码实操

如果希望不依赖计算巢,直接在已安装 Node.js 开发工具链的系统中快速启动 DeepSeek Harness Web UI,可以使用 npx 命令:

npx @deepseek-ai/dsh web

该命令默认会在 http://127.0.0.1:3080 启动 Web UI。本机启动时还会用默认浏览器自动打开页面;通过 SSH 启动时则只打印宿主机 URL,因为本地转发地址仅供本机访问。

也可以通过源码安装,获取完整项目源码并按照仓库说明完成安装:

git clone [https://github.com/deepseek-ai/deepseek-harness.git](https://github.com/deepseek-ai/deepseek-harness.git)
cd deepseek-harness
python -m venv .venv
source .venv/bin/activate
python -m pip install deepseek-harness-sdk

安装 Python SDK 后,即可在代码中直接调用 DeepSeek Harness,示例代码如下:

from deepseek_harness import Harness
h = Harness()
result = h.run(tasks="hello world")
print(result)

如果通过 Python 包管理工具安装 SDK,也可以直接执行:

python -m pip install deepseek-harness-sdk

六、插件的安装与扩展

DeepSeek Harness 的"一切皆插件"哲学同样体现在生态扩展上。官方已内置上百个插件,社区生态更是爆发式增长。安装插件的命令只有一条:

dsh plugin --profile web add "github:owner/repo#ref"

例如安装一个视觉插件:

dsh plugin --profile web add "github:liustack/modlens#main"

安装完成后,重启 dsh web 服务并刷新页面,插件即生效。这里有一个重要的坑:启动 Web UI 时必须加上 --patch 参数,否则很多插件和技能不会生效,完整命令如下:

npx @deepseek-ai/dsh web --patch

借助插件生态,你可以为纯文本模型补上看图能力、把界面升级成带任务看板的工作台、甚至聚合多家的免费模型进行零配置调用,实现能力的按需加载与灵活重组。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。

七、关键避坑要点

在部署与使用过程中,有几个关键细节需要重点留意。

第一,百炼 API Key 地域隔离。每个地域有独立的接入域名、API Key 和模型列表,选择地域后需使用该地域对应的 API Key 与 Base URL,不能跨地域混用,否则会出现调用失败。

第二,API Key 只显示一次。新建后务必立即复制或下载保存,平台采用不可逆加密存储,后续无法在控制台再次查看明文,丢失只能重置。

第三,端口分工要记清。计算巢部署采用单机 ECS 架构,Web UI 内部监听 127.0.0.1:13080,外部访问通过 Nginx 反向代理到 3080 端口,再由计算巢安全代理提供安全的服务实例输出地址。不建议直接暴露 13080 端口。

第四,依赖安全代理访问。计算巢安全代理基于服务实例输出地址访问 3080 端口,外部用户通过该地址即可访问 Web UI,无需额外开放端口。

第五,善用插件扩展能力。DeepSeek Harness 采用"一切皆插件"架构,模型接入、智能体编排、时空组合能力都通过插件实现,部署完成后可灵活扩展各类插件,满足不同业务场景。

第六,关注版本迭代。当前 DeepSeek Harness 处于开发者预览版(v0.1),正在快速迭代,未来可能出现破坏兼容性的变更,核心插件与基础接口也将快速演进。安装插件时尽量锁定版本号,避免依赖漂移带来的兼容问题。

八、部署完成后的使用方式

部署完成后,就可以基于 DeepSeek Harness 构建自己的智能体平台。开发者可以通过 Python SDK 在脚本中调用,也可以通过 CLI 工具在终端操作,或通过 MCP Server 将 Harness 能力接入其他 AI 工具,还能作为 Anthropic Skill 在支持技能的系统中使用。结合百炼平台提供的 Qwen 等大模型推理能力,可以实现从模型调用到智能体编排的完整链路,构建支持时空组合能力的专属 AI Agent 平台。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。

综合来看,基于阿里云计算巢 + 阿里云 ECS 云服务器 搭建 DeepSeek Harness 智能体平台,门槛低、上手快。先获取百炼 API Key(注意地域隔离与密钥保存),再通过计算巢一键部署,最后通过 Nginx 反向代理与计算巢安全代理安全访问 Web UI,即可投入使用。开发者也可以不依赖计算巢,直接使用 npx 命令或源码安装方式在本地或 ECS 上运行。部署时重点关注 API Key 只显示一次、地域不能混用、13080 与 3080 端口分工等要点,即可快速搭建一套功能完整、安全可控、可灵活扩展的 AI Agent 平台,支撑各类智能体应用的开发与落地。

相关文章
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7682 57
|
3天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1443 0
|
5天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
18天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5672 68
|
6天前
|
云安全 人工智能 安全
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2898 9
|
5天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
3天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
1859 0
|
10天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1869 1