DeepSeek Harness下载、安装、配置一篇搞定（2026整理，送常用插件）

DeepSeek Harness（简称DSH）是一款采用一切皆插件架构的开源Agent运行框架，模型、工具、技能、会话存储、沙箱、调度器、前端界面全部以插件形式实现，开发者不需要修改源码，只需要按需加载、替换插件，就能快速搭建专属AI智能体，完成代码开发、文件处理、自动化运维、多步骤复杂任务编排。在阿里云环境中，既可以在ECS云服务器手动部署，也可以直接使用计算巢模板一键部署，同时支持对接阿里云百炼Token Plan、Coding Plan，调用主流大模型服务。本文为2026最新整理完整教程，覆盖下载、多方式安装、模型配置、插件安装、公网访问、后台常驻运行，附带多款高频实用插件，所有操作命令可直接复制执行，新手也可以平稳完成部署。详情👉访问阿里云计算巢 Deepseek-Harness 社区版一键部署教程服务平台了解。

整个部署流程可概括为三步：先获取百炼 API Key，再通过计算巢一键部署（约 3 分钟），最后通过 Web UI 进行访问与使用。详情👉访问阿里云百炼大模型服务平台页面 了解。

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

一、前置环境准备（阿里云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长期运行，借助配套插件扩展能力，满足开发、运维、文档处理等多样化场景需求。