DeepSeek Harness是一款开源的插件化AI智能体框架，依托Cordis内核，遵循“一切皆插件”的设计思路，模型调用、代码读写、终端执行、会话记忆、界面渲染全部可以通过插件自由替换，非常适合用来搭建专属编码Agent、自动化任务助手、RAG知识库应用。在阿里云计算巢上部署，不用手动处理复杂的服务器初始化、安全组、环境依赖，支持一键拉起服务，同时可以直接对接百炼Token Plan、Coding Plan，方便开发者调试各类AI项目。本文把下载、环境准备、两种安装方式、参数配置、模型接入、插件安装全部整理到位，附带可直接复制的命令和多款高频好用的社区插件，新手也可以跟着完成整套部署。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。
整个部署流程可概括为三步：先获取百炼 API Key，再通过计算巢一键部署（约 3 分钟），最后通过 Web UI 进行访问与使用。详情👉访问阿里云百炼大模型服务平台页面 了解。
部署前先理清前置准备工作，不管是计算巢模板一键部署，还是手动在实例上安装，都需要提前准备好两项资源。第一是百炼平台的API Key，登录百炼控制台，进入API密钥管理页面创建密钥，密钥只展示一次，务必复制保存，同时留意地域隔离规则，密钥和服务地域需要保持一致，跨地域调用会出现鉴权失败。第二是Node运行环境，DeepSeek Harness要求Node.js版本不低于22.19.0，推荐22或者24稳定版本，版本过低会出现依赖安装报错、启动失败。计算巢官方模板会自动预装对应版本Node，手动部署的ECS实例需要自行安装环境。
第一种方式：计算巢模板一键部署，也是新手优先选择的方案。打开计算巢控制台，在服务市场搜索DeepSeek Harness官方部署模板，选择就近的地域，按量付费模式适合测试调试，长期稳定使用可以选择包年包月。实例规格最低推荐1核2G，跑多模型、多插件并发场景建议2核4G以上。填写实例登录密码，确认参数后勾选协议，点击立即创建，等待大约3分钟即可完成资源交付。部署成功后，在实例详情页获取访问地址，默认WebUI端口为3080，通过计算巢自带的安全代理访问，不需要单独放行端口，安全性更高。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。
整个部署流程可概括为三步：先获取百炼 API Key，再通过计算巢一键部署（约 3 分钟），最后通过 Web UI 进行访问与使用。详情👉访问阿里云百炼大模型服务平台页面 了解。
如果需要自定义修改源码、开发私有插件，就采用第二种源码手动部署方式，先登录计算巢创建出来的ECS实例，SSH连接服务器：
ssh root@你的实例公网IP
连接成功之后，先更新系统软件源，安装Node.js和pnpm包管理工具：
# 安装Node.js 22版本
curl -fsSL [https://deb.nodesource.com/setup_22.x](https://deb.nodesource.com/setup_22.x) | bash -
yum install -y nodejs
# 安装pnpm
npm install -g pnpm
拉取DeepSeek Harness官方源码仓库：
git clone [https://github.com/deepseek-ai/deepseek-harness.git](https://github.com/deepseek-ai/deepseek-harness.git)
cd deepseek-harness
安装项目依赖并编译打包：
pnpm install
pnpm run build
编译完成后，启动Web服务：
pnpm dsh web
启动成功后，终端会输出访问地址[http://127.0.0.1:3080](http://127.0.0.1:3080)，如果需要公网访问，配合Nginx反向代理或者计算巢域名转发配置。不想拉取源码，快速体验还可以直接用npx一键启动，不需要下载完整代码：
npx @deepseek-ai/dsh web
执行这条命令，工具会自动拉取对应包，启动Web界面，适合快速测试功能。
服务启动成功打开WebUI之后，还不能直接对话，核心是模型配置环节。进入左下角设置面板，切换到Models模型标签页，添加自定义模型服务商，填入百炼的接口地址、API Key，选择自己在Token Plan中开通的模型。也可以直接修改本地配置文件~/.dsh/settings.yaml，写入密钥与模型信息，命令行编辑配置文件：
vim ~/.dsh/settings.yaml
配置文件写入对应的provider、apiKey、baseUrl和默认模型名称，保存退出。配置完成后，回到首页选择工作区目录，工作区是Agent读写文件、执行脚本的目录，建议单独划分一个目录存放项目，避免误操作修改系统文件。
mkdir -p /opt/dsh-workspace
在WebUI工作区选择这里创建的目录，配置到此基础流程全部完成，就可以发起对话，让Agent读写代码、执行shell命令、调试项目。
DeepSeek Harness原生自带基础对话、终端、文件读写插件，想要更强的能力，就需要安装社区插件，下面给大家整理几款日常开发高频使用的插件，附带安装思路。
第一个是dsh-web-ui增强插件包，聚合任务看板、Git可视化面板、Token消耗监控、界面美化组件，解决原生界面简陋的问题，安装命令：
pnpm add dsh-web-ui-all
第二个是dsh-memory-plugin记忆插件，支持会话长期记忆、用户画像自动召回，适合长期项目连续调试，安装后会自动保存历史上下文，不用每次重新描述需求。第三个是定时任务插件，支持配置Cron定时调度，让Agent定时执行脚本、巡检服务，适合自动化运维场景。第四个是语音输入插件，支持语音转文字下发指令，适合快速交互。还有Agent Teams多智能体插件，可以拆分多个子Agent分工协作，处理复杂大型开发任务。
插件安装完成之后，在WebUI的插件管理面板开启对应插件，部分插件需要额外配置参数，比如记忆插件需要配置存储后端，定时插件需要配置时区。全部插件开启后，重启服务生效：
pnpm dsh web restart
部署和使用过程中，有几个高频问题需要留意。第一，端口访问异常，3080端口是默认Web端口，如果手动部署，需要在安全组放行端口，或者使用Nginx反向代理，示例Nginx配置片段：
location / {
proxy_pass [http://127.0.0.1:3080](http://127.0.0.1:3080);
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
第二，API Key鉴权失败，优先核对密钥是否正确、地域是否匹配、Token Plan额度是否充足，额度耗尽之后模型调用会直接报错。第三，Node版本不兼容，出现依赖报错，不要使用Node18及更早版本，重新安装22稳定版。第四，Agent权限风险，工作区不要设置在系统根目录，插件的shell执行能力权限很高，避免AI误删系统文件。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。
整个部署流程可概括为三步：先获取百炼 API Key，再通过计算巢一键部署（约 3 分钟），最后通过 Web UI 进行访问与使用。详情👉访问阿里云百炼大模型服务平台页面 了解。
另外，我们可以使用CLI模式直接在终端调用，不打开Web页面，适合嵌入自动化脚本：
# 设置环境变量传入密钥
export BAILIAN_API_KEY="你的百炼APIKEY"
# CLI交互模式
dsh cli
在CLI模式下，同样可以加载已经安装的插件，批量执行代码任务。
如果后续不再使用服务，为了避免持续产生计费，计算巢实例可以直接在控制台释放，手动部署的实例，也可以先停止服务进程：
pkill -f dsh
再根据业务需求选择释放ECS资源。
整体来看，在阿里云计算巢部署DeepSeek Harness，兼顾了上手门槛和扩展性，一键模板适合快速体验，源码部署适合二次开发、自定义插件。搭配百炼Token Plan，再装上web-ui、记忆、定时任务这些热门插件，就能快速搭建一套功能完整的AI编码工作台，用来写代码、排查bug、自动执行脚本、管理项目，是当下非常热门的Agent开发方案。整套流程上手之后，大家还可以自行开发自定义插件，拓展RAG、数据处理等更多能力，打造贴合自己工作流的智能助手。
