最近我在折腾 DeepSeek Harness这个和 Claude Code、Codex 同类的 AI 编程代理工具最吸引我的是它的插件体系。默认装上之后功能已经很全但真正让它好用起来的是 dsh-market一个集中分发 DeepSeek Harness 插件的市场类似 VSCode 的扩展商店。这篇文章我完整记录一下怎么在腾讯云服务器上从零安装 DeepSeek Harness把 dsh-market 插件市场配置好然后装几个高频插件跑通整个流程。整个过程用的是我自己实测过的方式国内服务器、国内镜像源、命令行操作跟着走就行。1. 项目背景与整体思路1.1 DeepSeek Harness 到底是个什么工具先说清楚这个东西的定位。DeepSeek Harness 不是一个聊天窗口而是一个面向开发者的 AI 代理运行框架。你可以把它理解成 Claude Code 或 Codex CLI 的同生态产品但它的侧重点在“可编排”和“可扩展”。它提供了命令行界面也有桌面端还支持通过 Web 界面远程操作基本覆盖了日常开发中使用 AI 的几种主流姿势。我最初注意到它是因为这个工具把“多智能体编排”做成了第一等公民。你可以定义多个不同职责的智能体比如一个负责代码生成、一个负责代码审查、一个负责写测试然后让它们按流程协作。这种设计在本地开发里已经很好用放到云服务器上运行更有价值——你不需要开着本地电脑随时随地通过 SSH 或 Web 界面就能把任务丢给这套系统执行。但真正让 DeepSeek Harness 从“能用”变成“好用”的是它的插件机制。类似 VSCode 没有插件市场之前功能再强也只是编辑器一旦有了插件生态能做的事就指数级增加。dsh-market 就是这个插件生态的集散地。1.2 为什么我把这套东西放在腾讯云上我自己最开始是在本地机器上跑的 DeepSeek Harness后来才迁到腾讯云主要原因有三个。第一是稳定性和长驻问题。我经常要跑一些耗时的任务比如让智能体批量重构代码、生成文档、跑测试本地机器一关屏幕或者断网任务就断了。放到云服务器上任务可以通过 tmux 或 systemd 挂在后台无论本地网络怎么折腾都不影响执行。第二是网络环境。DeepSeek 官方 API 在国内访问速度本身就不错但如果你本地网络波动大或者你同时要调用多个国内云厂商的模型服务直接从本地直连的效果不如从腾讯云服务器中转。尤其是我后面接了 Ollama 本地模型直接把模型跑在同一台云服务器上延迟低到可以忽略。第三是价格和上手门槛。腾讯云轻量应用服务器新用户折扣力度很大2 核 4G 配置跑 DeepSeek Harness 加几个插件完全够用一个月成本比一杯咖啡贵不了多少。加上它的防火墙、安全组、快照功能都在控制台里点点就能配对刚接触云服务器的开发者非常友好。1.3 搭建方案的整体拆解这套安装流程我拆成五个阶段每个阶段对应下文的一个章节你可以按顺序执行腾讯云服务器初始化购买实例、配置安全组、SSH 登录。基础环境安装系统更新、Node.js、pnpm、Git、Python 等运行时依赖。DeepSeek Harness 主程序安装通过 npm 或官方脚本安装 CLI并完成初始化配置。大模型接入配置 DeepSeek API或接入自建的 Ollama 本地模型。dsh-market 插件市场安装与验证添加插件源、安装插件、跑通第一个实际任务。2. 腾讯云环境准备从零开始初始化服务器2.1 服务器选型与登录准备选服务器的时候不用追求高配。DeepSeek Harness 本身是一个 Node.js 应用日常跑任务主要吃内存CPU 反而需求不极端。我实测下来 2 核 4G 的轻量应用服务器跑一个主智能体加两三个辅助智能体再开 Web 界面内存占用大约在 1.5G 到 2G 之间。如果你打算在同一台机器上跑 Ollama 本地大模型建议直接上 4 核 8G 或更高因为加载 7B 参数模型光模型文件就要占 4G 以上内存。操作系统我建议选 Ubuntu 22.04 LTS不要选 CentOS。DeepSeek Harness 官方对 Debian/Ubuntu 系的支持最完善安装依赖时 apt 包最全遇到问题搜解决方案也最容易命中。部分云厂商提供的 CentOS 镜像默认软件源版本偏老装 Node 20 这类新运行时需要额外折腾。实例创建好之后先把 root 密码重置好然后确认防火墙规则。腾讯云轻量服务器控制台里有独立的防火墙入口默认只放行了 22 端口后面如果要用 Web 界面远程访问需要额外加一条规则放行对应端口这个我在 4.3 节会细说。SSH 登录命令很简单Windows 用户直接用 PowerShell 或 Windows Terminal 里的 ssh 命令即可macOS 和 Linux 用户在终端里操作一样ssh root你的服务器公网IP首次登录会提示确认指纹输入 yes 回车然后输入密码。如果连接不上优先检查控制台防火墙是不是放行了 22 端口以及服务器是否处于运行状态。2.2 系统更新与基础软件包安装登录服务器后第一件事是更新系统软件源和已安装软件包避免因为系统库版本太旧导致后面安装依赖时出现兼容性问题。sudo apt update sudo apt upgrade -y更新可能需要几分钟取决于云服务器的网络状况。更新完之后把后面会用到的几个基础工具一次性装好sudo apt install -y curl wget git vim unzip build-essential ca-certificates这里解释一下每个工具的用途curl 和 wget 用于下载安装脚本和文件git 用于从 GitHub 拉取代码或安装部分插件unzip 用来解压 release 包build-essential 提供编译工具链部分 npm 原生模块在安装时需要用到 gcc 和 make少了它可能编译失败。装完之后顺手验证一下版本确保系统处于可用状态git --version curl --version python3 --version如果 python3 没装或版本比较旧后面再补一步 apt install python3 python3-venv python3-pip 即可。2.3 安装 Node.js 环境选对版本比选新更重要DeepSeek Harness 是 Node.js 应用对运行时版本有要求。根据我踩过的坑它至少需要 Node 18推荐使用 Node 20 LTS。Node 16 及以下的版本在安装时大概率会报引擎不匹配的错误硬装上去也会在运行时出现各种莫名其妙的异常。安装 Node 20 我推荐直接使用 NodeSource 官方源。在 Ubuntu 22.04 上这样操作curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs安装完成后验证node -v npm -v如果你以后需要在多个 Node 版本之间切换比如热词里有“怎么退回到 v0.1.5-rc.2”这类版本回退需求更推荐用 nvm 来管理curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 20 nvm use 20用 nvm 的好处是切换版本非常方便一条 nvm use 18 就能切换适合需要同时维护多个项目的开发者。2.4 配置国内镜像源这一步直接决定安装速度Node.js 装好之后我建议立刻把 npm 的 registry 切到国内镜像否则后面安装 DeepSeek Harness 时下载速度会非常感人。这一步尤其重要腾讯云服务器在国内直接访问 npm 官方源经常只有几十 KB 每秒切到 npmmirror 之后基本上能跑满带宽。npm config set registry https://registry.npmmirror.com npm config get registry验证一下输出是 npmmirror 的地址就说明配置成功。全局工具也用镜像源安装就快很多比如装 pnpmnpm install -g pnpm pnpm -vpnpm 在管理 DeepSeek Harness 插件依赖时比 npm 更干净不会在全局目录留下大量冗余包。而且 pnpm 支持从同一个 registry 源读取依赖源配置好了之后插件安装速度同样有保障。到这里服务器的基础环境就绪了。接下来开始装主角。3. DeepSeek Harness 与 dsh-market 安装全流程3.1 安装 DeepSeek Harness 主程序DeepSeek Harness 提供了多种安装方式我在腾讯云上实测最稳妥的是 npm 全局安装。命令非常直接sudo npm install -g deepseek-harness/cli装完之后确认一下dsh --version如果系统提示找不到 dsh 命令检查 npm 全局 bin 目录是否在 PATH 中。使用 NodeSource 安装的 Node.js全局 bin 目录通常是 /usr/bin 或 /usr/local/bin一般不需要额外配置。除了 npm 方式你还可以去 GitHub 官方仓库下载对应 Linux x64 架构的 release 压缩包解压后把二进制文件放入 /usr/local/bin。这种方式适合海外网络环境下使用国内服务器我更推荐 npm 镜像源方案速度优势太明显了。关于版本这里多说一句如果你不追求最新功能建议先装稳定版不要一上来就装 rc 版本rc 版本可能存在未修复的问题。装好以后如果遇到 bug 又想回退在 npm 安装时指定版本号即可sudo npm install -g deepseek-harness/cli0.1.5-rc.23.2 初始化配置与大模型接入主程序装好后输入 dsh init 开始初始化。这个命令会引导你完成基础配置包括选择默认模型提供商、填写 API Key、设置工作目录等。如果你使用 DeepSeek 官方 API核心配置就这么几条dsh config set provider deepseek dsh config set api-key sk-你的API密钥 dsh config set model deepseek-chatAPI Key 到 DeepSeek 开放平台后台创建创建后记得第一时间填到配置里。配置信息默认保存在当前用户目录下的 .dsh 配置文件中权限是 600其他用户读不到安全性没问题。如果你想接的不是官方 API而是自己部署的本地模型下一步是安装 Ollama 并拉取模型。在腾讯云服务器上装 Ollama 一条命令curl -fsSL https://ollama.com/install.sh | sh然后拉取一个轻量模型验证流程推荐 deepseek-r1:7bollama pull deepseek-r1:7b接着把 DeepSeek Harness 的模型提供商切到 ollamadsh config set provider ollama dsh config set base-url http://localhost:11434 dsh config set model deepseek-r1:7b这样 DeepSeek Harness 就会通过本地 Ollama 服务跑模型不消耗 API 额度也没有网络延迟。配置完可以跑一句简单的对话验证直接输入 dsh 进入交互模式输入“你好”回车能正常回复说明整个链路通了。3.3 安装 dsh-market 插件市场主程序配置好之后接下来就是重头戏安装 dsh-market 插件市场。它的作用相当于在 DeepSeek Harness 内部打开一个插件仓库你可以像在应用商店里一样搜索、浏览、安装社区贡献的插件。dsh-market 的安装方式依赖当前的插件管理命令在 v0.1.x 版本中添加插件市场的命令大致如下具体以你的版本的帮助输出为准dsh plugin add dsh-market dsh plugin sync dsh plugin list执行 dsh plugin add dsh-market 时工具会从默认的插件源索引中拉取 dsh-market 的注册信息。dsh plugin sync 是做一次同步把市场里的最新插件列表拉取到本地。dsh plugin list 查看当前已经安装的插件。如果你的网络环境访问默认插件源缓慢可以在配置文件中手动指定插件市场源地址。配置文件通常位于 ~/.dsh/config.json找到与 registry 相关的字段填入可用的国内加速地址或者填入你本地离线包提供的源地址。修改后重新执行 dsh plugin sync 即可。3.4 用 dsh-market 安装第一个插件并跑通调用链插件市场安装成功后进入 DeepSeek Harness 交互界面输入以下命令浏览可用插件/plugin list --remote这个命令会列出 dsh-market 里的所有可用插件包括插件名、版本、简介、作者和下载量。找到你想装的插件直接安装/plugin install 插件名我第一个装的插件是代码规范检查类插件。原因很实际DeepSeek Harness 生成的代码质量虽然不错但代码风格偶尔会和项目现有规范冲突有了这个插件AI 生成完代码后会自动跑一遍 lint 并在终端提示修正建议省了我在 review 阶段反复打磨格式的功夫。安装完成后插件的命令会注册到 DeepSeek Harness 的命令体系中。比如这个插件注册了 /lint 命令你在某个项目目录下输入/lint它就会读取项目里的 ESLint 或 Prettier 配置对当前文件做一次检查并给出可执行的修改建议。整个链路跑通之后你再去装其他插件就轻车熟路了。4. 腾讯云上的完整实操记录4.1 从 SSH 到插件市场可用的完整命令流这里我把整个过程串成一条命令线方便你对照操作。以下是我在一台全新 Ubuntu 22.04 腾讯云轻量服务器上从空白环境跑到插件市场可用的完整流程你直接逐条复制执行即可。# 1. 系统更新 sudo apt update sudo apt upgrade -y # 2. 安装基础工具 sudo apt install -y curl wget git vim unzip build-essential ca-certificates # 3. 安装 Node.js 20 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs # 4. 配置 npm 国内镜像源 npm config set registry https://registry.npmmirror.com # 5. 安装 pnpm sudo npm install -g pnpm # 6. 安装 DeepSeek Harness sudo npm install -g deepseek-harness/cli # 7. 验证主程序 dsh --version # 8. 初始化 dsh init # 9. 配置 DeepSeek API dsh config set provider deepseek dsh config set api-key sk-你的密钥 dsh config set model deepseek-chat # 10. 安装 dsh-market 插件市场 dsh plugin add dsh-market dsh plugin sync dsh plugin list # 11. 进入交互界面安装插件 dsh /plugin list --remote /plugin install 插件名这里面有几个细节值得注意。第一步的 apt upgrade 最好不要跳过我遇到过跳过升级后装 npm 原生模块编译失败的案例后来补了系统更新才解决。第六条安装主程序如果报权限错误记得加 sudonpm 全局安装到系统目录需要 root 权限。第十条 dsh plugin sync 如果输出的下载进度条长时间不动按 CtrlC 中断检查镜像源配置后再重试。4.2 让 DeepSeek Harness 在后台常驻直接在 SSH 终端里运行 dsh一旦断开连接任务就中断了所以在云服务器上使用必须考虑后台运行方案。我这里分享两个实用方案按需选择。方案一是 tmux最简单直接。先安装 tmux然后新建一个会话运行 dshsudo apt install -y tmux tmux new -s dsh dsh进入交互界面后按 CtrlB 然后按 D就能让会话在后台挂着。下次想回到这个会话执行 tmux attach -t dsh 即可。如果你关掉终端或者断网会话里的任务不受影响。这个方案适合临时跑任务。方案二是 systemd 服务适合让 DeepSeek Harness 作为常驻服务稳定运行。新建一个服务文件sudo vim /etc/systemd/system/dsh.service内容如下注意把 User 和路径改成你自己服务器的实际情况[Unit] DescriptionDeepSeek Harness Service Afternetwork.target [Service] Typesimple Userroot WorkingDirectory/root ExecStart/usr/bin/dsh --web Restartalways RestartSec10 EnvironmentNODE_ENVproduction [Install] WantedBymulti-user.target保存后执行sudo systemctl daemon-reload sudo systemctl enable dsh sudo systemctl start dsh通过 systemctl status dsh 可以查看服务状态journalctl -u dsh -f 实时查看日志。用 systemd 管理的好处是服务器重启后服务会自动拉起非常省心。4.3 Web 界面远程访问与安全组配置DeepSeek Harness 的桌面版和 Web 界面是我用得比较多的入口毕竟不是所有操作都想在命令行里敲。在云服务器上开启 Web 界面常用参数是 --web默认监听端口一般是 8080如果你的版本端口不同以帮助输出为准dsh --web --port 8080开启之后本地浏览器访问 http://服务器公网IP:8080 就能看到界面。但这一步通常会被卡住原因就是腾讯云防火墙没放行端口。在腾讯云轻量服务器控制台找到“防火墙”菜单点击“添加规则”应用类型选自定义协议选 TCP端口填 8080来源建议限定为自己的 IP比如格式你本地公网IP/32这样比直接放行 0.0.0.0/0 安全不少。如果你在服务器上还开了 ufw也需要放行对应端口sudo ufw allow 8080/tcpWeb 界面体验下来日常操作足够流畅插件安装、任务查看、智能体对话都能在界面里完成。要注意的是为了安全生产环境建议通过 Nginx 反向代理并配置 HTTPS至少也要在防火墙层面对来源 IP 做限制不要让端口裸奔在公网上。4.4 在腾讯云上配置 Ollama 本地模型的思考模式接本地模型是我觉得在腾讯云上最有价值的玩法。云服务器本身有足够资源跑中小规模的模型把 Ollama 直接部署在同一台机器上DeepSeek Harness 调模型完全走内网既省 API 费用也不会频繁抖动。部署 Ollama 之后拉起推理服务ollama serve默认监听 11434 端口。然后按我在 3.2 节里写的方式把 DeepSeek Harness 的 provider 换成 ollamabase-url 指向 http://localhost:11434。这里有一个关键点如果 Ollama 和 DeepSeek Harness 部署在同一台机器上base-url 必须写 localhost 而不是公网 IP否则会白白多走一层网络延迟翻倍。DeepSeek Harness 提供了“思考模式”相关配置项用来让模型在回答前先生成内部推理过程再给出结论。在交互模式里可以用命令开启或者在配置文件里设置 fields。我用 deepseek-r1:7b 测试开启思考模式后的回答质量明显比直接输出好尤其在代码重构和逻辑推理类任务上提升非常明显。代价是生成时间变长7B 模型在 4 核 CPU 上完成一次完整推理大约需要十几秒起步。如果觉得慢换更大的模型效果更好但需要更大内存8G 内存的服务器建议最多跑 7B再往上就要开始吃 swap 了。5. 常见问题与排查技巧实录5.1 安装卡住的几个常见原因我在安装和帮朋友排查的过程中遇到最多的问题是依赖安装失败或超时总结下来主要是三个方面的原因第一个是 Node.js 版本过旧。症状是 npm install 时报 engine 不匹配或者运行 dsh 时直接报错。解决办法很简单node -v 确认版本低于 18 就升级。升级后如果还报错把全局 node_modules 清掉重新装。第二个是 npm 源问题。症状是安装进度条长时间停在某个包不动最后报 ECONNRESET 之类的网络错误。先执行 npm config get registry 确认是不是默认源再按 2.4 节切到国内镜像。注意如果之前装失败过node_modules 里可能有缓存残留建议手动删掉重装sudo npm uninstall -g deepseek-harness/cli sudo npm cache clean --force sudo npm install -g deepseek-harness/cli第三个是权限不够导致的写入失败。npm 全局安装时如果不用 sudo大概率会遇到 EACCES 错误。要么全程加 sudo要么把 npm 全局目录改成用户可写。我个人的习惯是直接加 sudo 安装省事。5.2 dsh-market 插件市场加载超时或列表为空插件市场安装成功但执行 dsh plugin list --remote 时列表为空或者加载转圈好久才有结果这个问题在腾讯云上比较容易碰到。核心原因还是插件市场源服务器的连通性不够稳定。第一招在配置文件里检查插件市场的 registry 地址是否可访问。你可以先手动 curl 一下插件源的地址确认能返回 JSON 数据。如果返回超时就换一个可用的源地址或者使用离线包方式安装。离线包安装也是热词里反复出现的场景很适合网络受限的环境。在 GitHub 仓库的 release 页面下载 dsh-market 相关的离线包文件上传到服务器然后通过插件管理命令指定本地路径安装dsh plugin install ./dsh-market.离线包文件第二招检查是否在防火墙层面阻断了插件源的端口。部分插件源会使用非 443 端口腾讯云防火墙默认只放行少数端口容易漏掉。解决方法是把插件源端口加到防火墙规则里。第三招如果列表能加载但下载插件时总失败多半是插件文件托管在 CDN 上国内访问速度不稳定。可以尝试切换到另一个镜像源或者直接把插件仓库 git clone 下来手动安装。5.3 模型 API 连接报错的排查思路这部分比较“玄学”因为报错信息五花八门但根因往往就那几类。最常见的是 401 Unauthorized说明 API Key 写错了或者格式不对。检查 dsh config get api-key确认没带多余空格也没有把 sk- 前缀漏掉。第二个常见问题是模型名写错导致 404模型名必须严格匹配模型服务商提供的名称多一个字符都不行。第三个是网络无法连接到模型服务地址配置了自定义 base-url 的情况下先 curl 一下这个地址确认连通性。如果你用的是 Ollama还容易遇到一个坑Ollama 服务没启动或者端口被占用。执行 ollama ps 看模型是否加载执行 curl http://localhost:11434 确认服务在响应。如果报 connection refused检查 ollama serve 是否还在后台或者把它注册成 systemd 服务。5.4 腾讯云服务器上特有的几个坑最后单独说一下在腾讯云环境里容易出现的问题这些问题在本地电脑上基本遇不到。第一个是系统盘空间不足。轻量服务器默认系统盘容量不大装完 Node.js、pnpm、Ollama 模型文件之后很容易告警。Ollama 的模型文件默认存在 /root/.ollama/models动辄好几个 G。先 df -h 看磁盘占用如果空间紧张把模型目录迁移到数据盘或者删掉不用的模型释放空间。大模型文件清理后真的能腾出好几个 G这个动作很多人会忘记。第二个是时区问题。腾讯云新服务器默认可能是 UTC 时区日志里的时间比北京时间慢 8 小时。看日志排查问题时会被误导建议直接改成本地时区sudo timedatectl set-timezone Asia/Shanghai第三个是访问 Web 界面时浏览器相关的问题热词里也有“腾讯云服务器用什么浏览器”这样的搜索。其实服务器上不用装浏览器你是在本地电脑的浏览器里访问服务器 IP 的 Web 界面。推荐使用 Edge 或 Chrome 等 Chromium 内核浏览器对 Web 界面里的终端组件支持最完整。如果界面出现加载不全或白屏先按 CtrlShiftR 强制刷新再不行就清掉该域名的缓存。第四个是 swap 配置。2G 内存的机器跑 DeepSeek Harness 加 Web 界面会比较吃力尤其是同时加载多个智能体任务时内存直接拉满导致卡死。提前配置 swap 能缓解这个问题sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo /swapfile none swap sw 0 0 | sudo tee -a /etc/fstab配了 swap 之后机器稳定很多但也要明白 swap 再怎么配也只是兜底长期重度使用还是建议加内存。写在最后的几点心得这套流程我前后在不同机器上跑过好几遍最后留下几个实际操作中的体会。第一dsh-market 刚装上后不要贪多先装两三个高频使用的插件用熟再逐步扩展。插件装多了反而增加维护成本有些插件之间还会互相依赖冲突卸载的时候能折腾半天。第二配置好插件市场之后建议定期执行一次 dsh plugin update 更新插件。社区插件迭代速度很快旧版本可能适配不了新版主程序保持更新能省去不少排查兼容性的时间。第三如果你也打算在腾讯云上长期使用强烈建议把整个服务器的配置流程写成一个初始化脚本存着下次新开一台机器跑一遍脚本就能还原环境。我自己就是这么干的后面帮同事开新环境十分钟就能交付一套能用的 DeepSeek Harness 加 dsh-market。最后再分享一个小技巧在 dsh-market 里装插件之前先在远程列表里看看插件的最近更新时间和下载量优先选更新活跃、用户量大的插件。那些半年没更新、下载量个位数的插件大概率是作者练手项目装上了反而可能引入不稳定因素。希望这份教程能帮你少走一些弯路。有问题的话多翻翻 DeepSeek Harness 官方 GitHub 仓库的 issues很多我上面没提到的边缘情况那边都有现成的解决方案。