跳到正文
阿里雲開發者社區 AI·· 10 天前AI 評分43

DeepSeek Harness 下載、安裝與配置教學:附常用插件

DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)

AI 導讀

DeepSeek 在 2026 年 8 月開源 AI Agent 運行框架 DeepSeek Harness(DSH),採用 MIT 協議,並以插件形式提供可替換的模型、工具、會話、沙箱和 UI。教程涵蓋多種安裝方式、阿里雲百煉模型配置、插件使用及雲端部署;DSH 支援主流大模型,亦可透過 Web UI 或命令列操作。

正文

简介: DeepSeek Harness(简称 DSH)是 DeepSeek 在 2026 年 8 月开源的 AI Agent 运行框架,采用 MIT 协议。与 Claude Code、Codex 这类开箱即用的成品 Agent 不同的是,DSH 把模型、工具、会话、沙箱、UI 等都做成可替换的插件,开发者可以自由组装出自己的 Agent。

DeepSeek Harness(简称 DSH)是 DeepSeek 在 2026 年 8 月开源的 AI Agent 运行框架,采用 MIT 协议。与 Claude Code、Codex 这类开箱即用的成品 Agent 不同的是,DSH 把模型、工具、会话、沙箱、UI 等都做成可替换的插件,开发者可以自由组装出自己的 Agent。

它提供了一套可复用的 Agent 底层能力——会话管理、工具调用、记忆与沙箱隔离都以插件形式提供,按需启用。DSH 也支持市面上所有主流大模型,包括本家的 DeepSeek 和 Anthropic、OpenAI 等。

DSH 以本地 Web UI 运行,在浏览器里配置好模型与插件即可开始使用。本文也提供了一个插件,可以桌面应用的形式使用 DSH ,不需要单独安装 Node.js、pnpm 或 DSH。

在阿里云环境中,既可以在ECS云服务器手动部署,也可以直接使用计算巢模板一键部署,同时支持对接阿里云百炼Token Plan、Coding Plan,调用主流大模型服务。本文为2026最新整理完整教程,覆盖下载、多方式安装、模型配置、插件安装、公网访问、后台常驻运行,附带多款高频实用插件,所有操作命令可直接复制执行,新手也可以平稳完成部署。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。
image.png
整个部署流程可概括为三步:先获取百炼 API Key,再通过计算巢一键部署(约 3 分钟),最后通过 Web UI 进行访问与使用。详情👉访问阿里云百炼大模型服务平台页面 了解。
bailian1.png
bailian2.png

1111.jpg

2026年阿里云双十一活动入口:

2026年阿里云双十一活动入口 核心功能 适配人群
阿里云双十一活动主会场入口 https://t.aliyun.com/U/hNZNGM 阿里云轻量应用服务器、阿里云ECS云服务器、阿里云GPU云服务器、阿里云百炼大模型服务平台特惠机型一键选购 新客首购、免费试用、秒杀抢购
阿里云千问AI会场入口 https://t.aliyun.com/U/oJcPMY 150+模型折扣、Token Plan、千问办公、Qoder、AI礼包 个人开发者、中小企业
万网会场入口 https://t.aliyun.com/U/3cSx9W AI建站、域名、备案、组合购,11月2日至11月30日 个人开发者、中小企业
云服务器活动主会场入口 https://t.aliyun.com/U/tj0Y6d 阿里云大模型服务平台、阿里云轻量应用服务器、阿里云ECS云服务器、阿里云GPU云服务器特惠机型一键选购 新客首购、免费试用、秒杀抢购
综合权益中心入口 https://t.aliyun.com/U/Qu7Kql AI权益+云产品权益双轨并行,Token Plan、千问办公、万小智AI建站等一网打尽 新老用户均可,尤其适合AI应用探索者
99计划专场入口 https://t.aliyun.com/U/qISm14 99元e实例与199元u1实例新购续费同价,锁价至2030年 个人开发者、中小企业长期持有
云服务器ECS专属活动入口 https://t.aliyun.com/U/YeFGPX Agent友好云服务器:算力、模型、应用一次配齐 个人开发者、中小企业
云资源产品直降活动入口 https://t.aliyun.com/U/5Kr5JI 从模型到应用,全链提效,助力开发者与企业创新加速 个人开发者、中小企业
免费试用主会场入口 https://t.aliyun.com/U/91c17L 160+款云产品免费试用 个人开发者、中小企业
百炼 Token Plan 活动入口 https://t.aliyun.com/U/PjblPi 千问 AI 双 11 Token Plan 低至5折 个人开发者、中小企业
大模型服务平台百炼活动入口 https://t.aliyun.com/U/2Nuy7H 千问 AI 双 11 Token Plan 低至5折 个人开发者、中小企业

asaw.png

ecs.png

egs.png

111111.jpg

3.jpg

4.jpg

5.jpg

一、前置环境准备(阿里云ECS)

推荐使用阿里云ECS的Ubuntu 22.04或者CentOS 7/8系统,最低配置2核4G,长时间跑Agent任务建议4核8G以上。DeepSeek Harness对Node.js版本有硬性要求,需要Node.js 22.19及以上版本,低版本会出现依赖安装失败、插件加载异常。登录ECS的SSH终端,先执行环境准备命令:

# Ubuntu系统安装Node 22.x
curl -fsSL [https://deb.nodesource.com/setup_22.x](https://deb.nodesource.com/setup_22.x) | bash -
apt update && apt install -y nodejs git
# CentOS系统安装Node 22.x
curl -fsSL [https://rpm.nodesource.com/setup_22.x](https://rpm.nodesource.com/setup_22.x) | bash -
yum install -y nodejs git
# 校验版本
node -v && npm -v
# 安装pnpm包管理器,源码编译推荐使用
npm install -g pnpm

同时前往阿里云百炼控制台,创建Token Plan的API密钥,密钥仅展示一次,妥善保存,不要直接提交到代码仓库。如果选择计算巢一键部署,只需要提前准备好密钥,在部署表单中填入即可,省去手动配置环境的步骤。

二、三种安装方式,按需选择

DeepSeek Harness一共提供三种主流安装方案,分别是npx临时体验、npm全局安装、源码编译安装,另外还有Windows、macOS桌面客户端,适合本地电脑使用。

第一种,npx快速体验,适合第一次试用,不会在系统留下全局包,用完即走:

npx @deepseek-ai/dsh web

首次运行会自动拉取全部依赖包,网络正常情况下1~3分钟启动完成,默认WebUI地址是[http://127.0.0.1:3080](http://127.0.0.1:3080)。这种方式适合临时测试,关闭终端之后服务自动停止,不适合长期后台运行。

第二种,npm全局安装,是服务器长期使用的首选方案,安装之后任意目录都可以调用dsh指令:

npm install -g @deepseek-ai/dsh
# 校验安装成功
dsh --version
# 查看全部子命令
dsh --help
# 启动Web界面
dsh web

第三种,源码编译安装,适合需要二次开发、自定义插件、修改底层逻辑的用户:

# 拉取源码仓库
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
# 启动服务
pnpm dsh web

桌面客户端可以直接前往官方发布页下载安装包,Windows、macOS开箱即用,不需要手动配置Node环境,适合本地开发人员。

三、模型对接配置,接入阿里云百炼

DeepSeek Harness支持多模型源切换,既可以使用DeepSeek官方模型,也可以对接阿里云百炼兼容接口,使用Token Plan、Coding Plan的算力包。配置分为临时环境变量方式和永久配置文件方式。

临时环境变量,适合快速测试,终端关闭之后失效:

# 设置百炼API密钥
export BAILIAN_API_KEY="你的百炼APIKEY"
# 设置兼容接口地址
export DEEPSEEK_BASE_URL="[https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1](https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1)"

永久配置文件方案,推荐服务器长期部署使用,配置文件默认路径~/.dsh/settings.yaml,编辑这个文件:

nano ~/.dsh/settings.yaml

写入百炼模型源配置内容:

agent-default-model:
  provider: bailian-tp
  model: qwen3.8-max
llm-pi-ai:
  providers:
    bailian-tp:
      displayName: "阿里云百炼TokenPlan"
      api: openai-completions
      baseURL: "[https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1](https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1)"
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.8-max
        - id: qwen3.7-max
        - id: qwen3.7-plus

凭据文件存放密钥,路径为~/.dsh/.credentials.yaml,为了安全,给配置目录设置权限,仅当前用户可读:

chmod -R 700 ~/.dsh

配置完成后,重启dsh web服务,进入WebUI的模型设置页面,就可以选择百炼系列模型,发送测试指令验证连通性。

四、常用插件安装与使用(附赠高频插件)

DeepSeek Harness的核心亮点就是插件化架构,官方自带基础插件,同时社区有大量实用插件,覆盖文件读写、Shell执行、代码审查、Git操作、单元测试生成、文档导出、沙箱隔离等场景。插件加载方式分为WebUI图形化安装、CLI命令安装两种。

通过CLI安装社区插件示例:

# 安装文件增强插件
dsh plugin install @dsh-plugins/file-extra
# 安装Git代码操作插件
dsh plugin install @dsh-plugins/git-tool
# 安装代码静态扫描插件
dsh plugin install @dsh-plugins/code-audit
# 查看当前已经加载的全部插件
dsh plugin list
# 卸载不需要的插件
dsh plugin uninstall @dsh-plugins/code-audit

本次整理的常用插件清单:文件增强插件、Shell安全沙箱插件、Git仓库操作插件、代码漏洞扫描插件、Markdown文档导出插件、单元测试生成插件、HTTP请求插件、SQL查询插件、定时任务调度插件。
插件安装完成后,在WebUI的Agent预设里面开启对应插件,Agent就自动拥有对应的能力。同时Harness支持三种运行模式:标准模式(默认,全量工具插件)、PTC程序化工具调用模式(模型自动编排多步工具调用)、极简模式(仅保留基础文件、Shell工具,用于基准测试),可以根据任务切换模式。

五、阿里云ECS公网访问、后台常驻与反向代理

默认启动之后服务只监听127.0.0.1,外网无法直接访问,有两种方案:放行端口、Nginx反向代理。首先在ECS安全组放行3080端口,或者使用Nginx反向代理,绑定域名、增加SSL证书,提升访问安全性。
用pm2把dsh做成后台常驻进程,关闭SSH窗口服务也不会停止:

# 全局安装pm2进程管理
npm install -g pm2
# 后台启动dsh web
pm2 start "dsh web" --name dsh-harness
# 设置开机自启
pm2 startup
pm2 save
# 查看运行日志
pm2 logs dsh-harness
# 重启服务
pm2 restart dsh-harness

Nginx反向代理简单配置,把域名流量转发到本地3080端口,同时配置SSL证书,避免裸HTTP访问:

server {
   
    listen 80;
    server_name dsh.example.com;
    return 301 https://$host$request_uri;
}
server {
   
    listen 443 ssl;
    server_name dsh.example.com;
    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    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;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

配置完成后重载Nginx:systemctl reload nginx,就可以通过域名公网访问Harness Web界面。

六、CLI常用指令、会话管理

除了Web图形界面,dsh完整支持命令行交互,适合嵌入流水线、自动化脚本:

# 开启交互式对话会话
dsh chat
# 一次性执行任务,扫描当前目录代码漏洞
dsh run "扫描当前目录所有JS代码,找出安全漏洞并输出修复方案"
# 查看所有历史会话
dsh session list
# 切换指定会话
dsh session switch sess-xxxx
# 删除过期会话
dsh session rm sess-xxxx
# 导出会话记录为markdown
dsh session export sess-xxxx --format md > report.md

七、版本升级、回滚与避坑要点

升级npm全局版本:

npm install -g @deepseek-ai/dsh@latest

新版本出现兼容问题,可以指定稳定版本回滚:

npm install -g @deepseek-ai/dsh@0.1.2-rc.1

高频踩坑点汇总:

  1. Node版本不足,直接启动失败,必须保证≥22.19;
  2. 端口3080被其他程序占用,修改启动端口:dsh web --port 3081;
  3. 密钥权限泄露,禁止把密钥写进启动脚本、提交到代码仓库,优先使用环境变量;
  4. 插件版本不匹配,新版本内核不兼容旧插件,安装插件前核对版本适配说明;
  5. 沙箱权限风险,Shell插件默认可以执行服务器命令,生产环境一定要开启沙箱隔离插件,限制文件读写目录;
  6. 百炼接口地域不匹配,密钥和接口地域要保持一致,否则调用返回鉴权失败。

八、云上部署安全规范

在阿里云ECS部署,安全是重中之重。第一,Agent具备读写文件、执行Shell命令的能力,不要使用root账号运行dsh,新建普通业务账号,限制工作目录;第二,安全组最小权限原则,3080端口不要直接全网开放,搭配Nginx、身份认证插件做访问控制;第三,开启用量告警,在百炼控制台设置Token消耗阈值,防止Agent循环调用产生高额费用;第四,定期备份~/.dsh目录,里面保存会话、插件配置、凭据信息。

DeepSeek Harness凭借插件化架构,灵活性远超普通AI对话工具,既能用来做代码开发、项目重构,也能编排复杂自动化工作流。搭配阿里云ECS、计算巢、百炼Token Plan,能够低成本搭建稳定可控的私有化Agent平台。新手可以先使用npx快速体验,熟悉插件和模型调用逻辑,再部署到ECS长期运行,借助配套插件扩展能力,满足开发、运维、文档处理等多样化场景需求。

來源:阿里雲開發者社區 AI · developer.aliyun.com