零基礎上手:DeepSeek Harness 在阿里雲計算巢及 ECS 雲伺服器上的完整部署指南
零基础也能上手|DeepSeek Harness 在阿里云计算巢、ECS 云服务器上的完整部署指南
DeepSeek Harness 部署指南涵蓋在阿里雲計算巢一鍵部署、在 ECS 手動部署,以及取得百煉 API Key 和設定模型。計算巢部署約需 3 分鐘,透過安全代理存取 Web UI,無需直接向公網開放服務端口。啟動 Web UI 時須加入 `--patch`,以啟用插件和技能。
2026-11-11 3
版权
版权声明:
本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
简介: 无论你是刚入门的开发者,还是寻求自动化升级的团队;无论你想做代码自动化重构、多智能体协同,还是内容创作——DeepSeek Harness 配合阿里云计算巢与百炼的强强联手,已将这场 AI 革命的门槛降到了最低:一键部署、三分钟上线、安全可控、插件即插即用。现在就行动:打开阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 ,跟随教程完成部署前往阿里云百炼大模型服务平台页面,探索更多模型能力与高级功能开启你的"零门槛 AI 体验之旅",让 13 款大厂大模型为你所用!
一、为什么这篇教程值得你收藏
在智能体(Agent)开发浪潮以摧枯拉朽之势席卷全球的 2026 年,从模型调用到智能体编排再到应用落地的全链路能力,已经成为衡量 AI 开发框架价值的黄金标尺。DeepSeek Harness(简称 DSH)——由 DeepSeek AI 以 MIT 协议全面开源的智能体框架,凭借"一切皆插件"的颠覆性架构与 Cordis 引擎驱动的微内核设计,上线短短时间便在 GitHub 斩获 160k Star,社区插件生态更是超过一千六百余款,堪称当下最炙手可热的 AI Agent 开发利器。
然而,本地运行 DSH 终究受限于单机性能与访问范围。想要实现 7×24 小时不间断运行、多设备实时同步、团队协作共享?答案只有一个——把它部署到云端。而将 DSH 搬上阿里云的最快路径,非阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 莫属。这篇保姆级教程,将从获取模型密钥、计算巢一键部署、Web UI 安全访问到插件生态扩展,手把手带你三分钟跑通一整套可编排、可观测、可复现、可进化的专属 AI 智能体平台。
所有核心操作指引与最新部署文档,请持续锁定阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 ,同时模型能力与定价详情请随时查阅阿里云百炼大模型服务平台页面,确保你始终用上最新版本与最优方案。



二、部署前的核心准备:两项资源缺一不可
2.1 获取百炼 API Key——你的"军火库钥匙"
一切部署的基石,是一串从阿里云百炼大模型服务平台页面获取的 API Key。请严格遵循以下步骤:
- 登录阿里云百炼大模型服务平台页面,在右上角精准选择目标地域。
- 务必牢记:每个地域拥有独立的接入域名、API Key 与模型列表,严禁跨地域混用,否则鉴权直接失败!
- 单击"创建 API Key",在弹窗中完成配置后点确定。
三大铁律,刻进 DNA:
- 新建的 API Key 仅在创建后显示一次,平台采用不可逆加密存储技术,后续无法在控制台查看明文,一旦丢失只能重置——务必立即复制或下载保存!
- 按量付费模式的 Base URL 需一并复制,用于后续模型接入,请与对应地域一一对应。
- 前往阿里云百炼大模型服务平台页面可随时管理、重置或查看密钥状态。
2.2 环境要求速查
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| Node.js 版本 | ≥22.19.0 | 22 或 24 稳定版 |
| ECS 实例规格 | 1 核 2G | 2 核 4G 以上(多模型/多插件并发) |
| 操作系统 | Debian 12 / Ubuntu | Debian 12 |
| 网络 | 可访问外网 | 建议开通镜像加速 |
计算巢官方模板会自动预装对应 Node.js 版本,无需你手动折腾;若手动部署 ECS,则需自行安装。更多细节请前往阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 查阅。
三、方案架构一张图看懂
通过阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 部署 DSH,整体架构清晰而优雅:
┌─────────────────────────────────────────────┐\│ 阿里云 ECS 云服务器实例 │\│ │\│ DeepSeek Harness Web UI → 监听 127.0.0.1:13080 │\│ Nginx 反向代理 → 监听 0.0.0.0:3080 │\│ 计算巢安全代理 → 基于实例输出访问 3080 │\└─────────────────────────────────────────────┘\↑ 安全代理内嵌,无需额外开放端口\│\外部用户浏览器 → 3080 端口安全访问 Web UI
核心要点:ECS 安全组仅放行安全代理出口网段访问 3080 端口,不直接对公网开放无鉴权 Web 服务,安全性远超传统部署方式。



四、三种部署方式,总有一款适合你
方式一:计算巢一键部署(新手首选,约 3 分钟搞定)
这是门槛最低、上手最快的方案,强烈推荐初次接触 DSH 的开发者。
操作步骤:
- 打开阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 ,进入管理控制台。
- 搜索"DeepSeek Harness",选择对应部署模板。
- 第一次使用计算巢服务需要先同意协议,点确定。
- 配置部署参数:
- 地域:建议选择离你最近的地域(与百炼 API Key 地域保持一致)
- 付费类型:按量付费适合测试调试,包年包月适合长期稳定使用
- 实例规格:最低推荐 1 核 2G,多模型并发建议 2 核 4G 以上
- 实例密码:自行设置并妥善记录
- 专有网络、IPv4 网段、交换机子网段:无特殊要求默认即可
- 单击"下一步"确认订单,勾选"我已阅读并同意",单击"立即创建"。
- 等待约 3 分钟,部署即完成!
部署完成后,在服务实例详情页的"输出"区域查看 deepseek_harness_3080_url,点击安全代理访问地址即可打开 Web UI。无需手动放行端口,安全性拉满。
?? 提示:完整参数说明与分步截图指引,尽在阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 。
方式二:npx 命令快速启动(轻量体验)
不想拉取完整源码?一行命令即可启动:
npx @deepseek-ai/dsh web --patch
重要坑位:必须加上 --patch 参数,否则大量插件与技能无法生效!
命令执行后,默认在 http://127.0.0.1:3080 启动 Web UI,本机启动时会自动打开浏览器页面;通过 SSH 启动时则只打印宿主机 URL。
方式三:源码手动部署(二次开发首选)
适合需要自定义修改源码、开发私有插件的进阶用户:
git clone https://github.com/deepseek-ai/deepseek-harness.git\cd deepseek-harness\pnpm install\pnpm run build\pnpm dsh web
启动成功后,终端输出访问地址 http://127.0.0.1:3080。如需公网访问,配合 Nginx 反向代理或计算巢域名转发配置。在阿里云 ECS 上操作时,可参考阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 提供的源码部署章节。
同时,安装 Python SDK 后即可在代码中直接调用:
pip install deepseek-harness-sdk
from deepseek_harness import Harness\
\h = Harness()\result = h.run(tasks="hello world")\print(result)
五、Web UI 配置:不配模型,一切白搭
打开 Web UI 只是第一步——核心在于模型配置。请按照以下流程操作:
- 点击左下角"设置"按钮
- 进入"Models / 模型"配置页
- 点击"添加提供方",在下拉菜单中选择服务商:
- DeepSeek 官方模型
- OpenAI 兼容模型
- 通过阿里云百炼大模型服务平台页面获取的千问系列模型(推荐 Qwen3.8-Max)
- 勾选目标模型,点击"添加所选"并保存
- 也可直接修改本地配置文件
~/.dsh/settings.yaml,写入 provider、apiKey、baseUrl 等信息
特别提示:通过阿里云百炼大模型服务平台页面接入的千问 3.8 系列模型,在文本推理、代码生成、视觉理解等任务上表现卓越,配合 Token Plan 还能享受限时折扣。2026 年 11 月 30 日前,Token Plan 新客首购低至 5 折,模型与 Agent 能力一次配齐!
工作区选择
返回主页面,点击"选择工作区",选定需要让 Agent 操作的工作区目录。系统已在 ECS 上准备 /opt/deepseek-harness/workspace 作为默认工作目录,DSH 的会话、凭据、存储和附件数据保存在 /opt/deepseek-harness/dsh-home 下。



六、插件生态:让你的 Agent 进化成"超级助手"
DeepSeek Harness 奉行"一切皆插件"哲学——模型、工具、技能、UI、存储全部可替换。社区插件汇总仓库 awesome-dsh-plugin 已收录超过一千六百款插件,几乎每周都有新的优质工具上线。
统一安装命令:
dsh plugin --profile web add "github:owner/repo#ref"
安装完成后,执行 pnpm dsh web restart 生效。再次强调:启动 Web UI 时必须加上 --patch 参数!
十款超实用插件推荐
| 排名 | 插件名称 | 核心能力 | 安装命令 |
|---|---|---|---|
| 1 | dsh-market | 插件生态入口,应用商店级存在,一键搜索安装社区所有插件 | dsh plugin --profile web add dshmarket |
| 2 | modlens | 为纯文本模型补上看图能力,OCR + 版面布局分析 | npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.25.2 |
| 3 | dsh-at-file | 输入 @ 即可模糊搜索本地文件并自动引用内容 | dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.8.tar.gz |
| 4 | dsh-web-search-pro | 聚合 DeepSeek/Bing/Exa 搜索引擎 + 小红书/知乎/B 站定向爬取 | 详见**阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 |
|
| 5 | OpenViking | 让 Agent 拥有"长期记忆",自进化上下文数据库与知识 RAG 库 | 详见阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台
** |
更多插件详情与安装指引,请前往阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 获取完整清单。
七、安全要点与高频坑点
| 坑点 | 解决方案 |
|---|---|
| API Key 只显示一次 | 创建后立即复制保存,丢失只能重置 |
| 地域混用导致鉴权失败 | 百炼 Key 与 ECS 地域必须一致 |
| 插件不生效 | 启动时必须加 --patch 参数 |
| Node.js 版本过低报错 | 确保 ≥22.19.0,推荐 22 或 24 |
| Web UI 直接暴露公网 | 通过计算巢安全代理访问,不单独放行端口 |
| 13080 与 3080 端口混淆 | 13080 是内部监听,3080 是 Nginx 对外代理 |
八、总结:三步开启你的专属 AI 时代
整套流程凝练为三句话:
先去阿里云百炼大模型服务平台页面获取 API Key——注意地域隔离,密钥只显一次,丢了就没了;再通过阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台
一键部署——约 3 分钟,自动创建 ECS 并完成环境搭建;最后通过计算巢安全代理访问 3080 端口的 Web UI——配置模型、选择工作区、装上插件,即可投入使用。
这一切的起点,不过是打开阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 点一下"立即创建",再去阿里云百炼大模型服务平台页面复制一串密钥——三分钟,你的专属 AI 时代就此开启。
无论你是刚入门的开发者,还是寻求自动化升级的团队;无论你想做代码自动化重构、多智能体协同,还是内容创作——DeepSeek Harness 配合阿里云计算巢与百炼的强强联手,已将这场 AI 革命的门槛降到了最低:一键部署、三分钟上线、安全可控、插件即插即用。
现在就行动:
- 打开阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 ,跟随教程完成部署
- 前往阿里云百炼大模型服务平台页面,探索更多模型能力与高级功能
- 开启你的"零门槛 AI 体验之旅",让 13 款大厂大模型为你所用!
本教程基于 2026 年 11 月最新版 DeepSeek Harness 与阿里云计算巢/ECS/百炼产品撰写,所有操作指引以阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台 与阿里云百炼大模型服务平台页面官方文档为准。
來源:阿里雲開發者社區 AI · developer.aliyun.com