先说点实在的。我最早是在自己笔记本上跑 DeepSeek Harness 的装插件、调智能体编排都挺顺手可一旦合上盖子下班任务就跟着断了想让同事一起用还得折腾内网穿透。后来干脆把它搬到腾讯云上配合 dsh-market 插件市场统一管理插件整体体验顺畅了很多。这篇教程就把我在腾讯云环境下安装 DeepSeek Harness 并搭好 dsh-market 插件市场的完整过程写出来从服务器配置选择、安全组放行到插件搜索安装、模型接入和多智能体编排尽量每一步都说到位。适合想用云服务器跑 Harness、又不想一遍遍查资料的新手也适合本地已经跑通、准备迁移上云的朋友参考。1. 为什么把 Harness 放到腾讯云上跑1.1 本地部署会遇到的三道坎DeepSeek Harness 本身是个本地优先的工具装在本机跑没有任何问题但真用起来会有几个绕不开的痛点。第一是“关机即失联”。我经常晚上写好一批智能体任务让它们凌晨自动执行本地电脑一休眠任务就断了第二天醒来发现啥也没跑。把服务放到云服务器上7乘24小时在线编排任务才能真正“无人值守”。第二是“访问不方便”。本地跑起来之后如果你在办公室想连家里的服务要么搞内网穿透要么忍受各种奇怪的网络问题。腾讯云服务器有固定公网IP浏览器直接访问公网地址加端口就行手机、平板、办公电脑都能连。第三是“依赖环境太乱”。Harness 会依赖 Python、Node、Git还有一堆插件各自带着自己的依赖。把这些都堆在个人电脑上指不定哪天和别的开发环境打架。云服务器随时可以重置系统折腾坏了大不了重来心理负担小得多。1.2 服务器配置怎么选如果你的用途主要是跑 Harness 的编排逻辑、调用 DeepSeek 官方 API那对服务器性能要求真不高。我建议直接给结论第一台服务器选2核4G、带宽5Mbps、系统盘50G起步。这个配置跑 Harness 本体、挂几个插件、日常处理多智能体任务完全够用。腾讯云的轻量应用服务器或者CVM都行轻量服务器更便宜管理界面对新手更友好CVM的扩展性更好后面想加GPU实例、调整网络配置更方便。那什么情况下需要更高配置呢如果你打算在服务器上直接加载本地模型比如通过 Ollama 跑 7B 级别的小模型2核4G就明显不够了推理速度会很感人。这种情况建议4核16G以上最好用带GPU的实例不然一个请求可能要等几十秒甚至更久。我的建议是本地模型放在自己电脑上玩云服务器专心负责 Harness 的编排和调度两边通过 API 互通性价比最高。1.3 安全组和端口规划这一步很多人第一次搞的时候会卡很久明明服务启动成功了外网就是访问不了。核心原因通常在腾讯云的安全组上。腾讯云有两层访问控制容易搞混。CVM用的是安全组轻量应用服务器用的是防火墙但作用类似默认只放行了22端口SSH其他端口一律不让外面进来。所以你启动 Harness 的 Web UI 之后必须手动放行对应端口。以我自己为例我规划了三个端口端口用途说明22SSH登录默认已放行8000Harness Web UI浏览器访问界面用11434Ollama API如果服务器上要跑本地模型才需要在腾讯云控制台找到你的实例进入“防火墙”或“安全组”页面添加入站规则来源填0.0.0.0/0表示允许所有IP访问协议端口填TCP:8000保存之后生效是秒级的。如果你不想让所有人都能访问 UI可以把来源限制为你自己的家庭宽带IP但家庭宽带的IP一般会变到时候又要改规则。我图省事直接放开了然后在 Harness 前面再加一层带密码的访问控制。2. 环境准备干净服务器需要补齐的基础工具2.1 系统初始化与基础工具安装我第一次上腾讯云的时候选了 Ubuntu 22.04 LTS因为Python 3.10是系统自带的社区资料也最多踩坑的概率最低。登录服务器之后第一件事是更新软件源并装基础工具。用 SSH 连接上服务器然后执行sudo apt update sudo apt upgrade -y sudo apt install -y git curl wget unzip python3 python3-venv python3-pipGit 用来拉取项目代码和插件仓库curl 和 wget 用来下载安装包Python 是 Harness 的运行基础。如果你的服务器是 CentOS 或者其他发行版用对应的包管理器yum 或者 dnf替换掉 apt 即可但我不太推荐 CentOS因为 Python 版本普遍偏老后面装依赖容易遇到坑。如果你的 Ubuntu 版本比较旧Python 版本低于 3.10我建议直接换官方源升级系统或者用源码编译安装新版 Python但说实话没必要折腾直接新建一台 Ubuntu 22.04 的机器最快。2.2 Python 环境用 venv 还是 Conda很多新手上来就想装 Anaconda 或者 MiniConda觉得这样管理环境方便。我不反对但云服务器上我更推荐直接用 Python 自带的venv模块。原因很简单Harness 的依赖其实不复杂一个虚拟环境完全够用。Conda 装起来体积好几 GB而且默认源在国外国内服务器下载慢得让人崩溃。venv 是 Python 内置的零额外安装用完就删干净利落。后面如果需要给 Harness 装各种插件插件的依赖也统一装到这个 venv 里不会污染系统 Python。如果你已经装了 Conda也不影响用conda create -n harness python3.10创建环境也能跑只是我个人的体会是 venv 更轻量、更好维护。如果你想换国内 pip 源强烈建议下载速度快很多执行这条命令pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple实测在腾讯云上用清华源装依赖速度比默认源快十倍不止。2.3 把安装包传到服务器的几种方式环境准备好之后需要把安装包传到服务器上。这一步有不少新朋友卡住这里把常用的几种方式都列一下。第一种直接用腾讯云控制台的 WebShell。控制台页面里点击“登录”进入网页版终端后很多版本的 WebShell 自带“上传文件”按钮直接把本地下载好的压缩包传上去就行适合一次性上传。缺点是传大文件偶尔会断重新传就好。第二种用 SCP 命令这个我平时用得最多。在本地电脑上执行scp -i ~/.ssh/tencent.pem ./dsh-server-linux-amd64.tar.gz ubuntu你的公网IP:/home/ubuntu/Windows 用户如果不想敲命令用 WinSCP 或者 Xftp图形界面上传逻辑一样。第三种直接在服务器上git clone。如果你要装的是开源项目直接克隆仓库是最省事的。Harness 的官方代码托管在 GitHub服务器上先装好 Git然后克隆对应仓库。注意国内网络访问 GitHub 偶尔不稳定如果 clone 到一半断开重试几次或者把仓库先下载到本地电脑再通过前面两种方式传上去。3. DeepSeek Harness 主体安装与验证3.1 下载与目录规划Harness 的安装包分桌面版和服务器版云服务器上我们用的是命令行版。下载地址以官方 GitHub Releases 页面为准选择对应 Linux 架构的版本。下载完成之后我习惯把 Harness 安装在/opt/deepseek-harness目录下而不是直接放在用户目录。这样做的理由是/opt是 Linux 系统约定放第三方软件的目录权限清晰后续用 root 启动服务时不会因为目录权限问题各种奇葩报错。如果你有洁癖也可以放在~/deepseek-harness但注意后面配置 systemd 服务时工作目录和用户权限要对应改好。解压安装包sudo mkdir -p /opt/deepseek-harness sudo tar -xzf dsh-server-linux-amd64.tar.gz -C /opt/deepseek-harness cd /opt/deepseek-harness解压后目录里一般有bin、config、plugins、docs这几个子目录bin 目录下就是 Harness 的主命令通常叫dsh。3.2 创建虚拟环境并安装依赖Harness 的有些插件依赖 Python 包为了隔离环境建议在 Harness 根目录下建立一个 venvcd /opt/deepseek-harness sudo python3 -m venv .venv然后根据安装包里的requirements.txt安装核心依赖。如果安装包没有附带这个文件通常在代码仓库的根目录下能找到source .venv/bin/activate pip install --upgrade pip pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple这一步是大多数报错的重灾区。常见的坑是requirements.txt 里某个包拉不下来、某个包编译不过去、或者因为网络问题下载超时。给三个救急建议换国内 pip 源速度快很多如果某个包编译失败安装系统依赖再试比如sudo apt install build-essential下载超时就重试pip 有时需要多试两次。3.3 首次启动与配置依赖装好之后先把基础配置写好。Harness 会读取~/.dsh/config.yaml作为默认配置首次启动时如果没有这个文件它会自动生成一个样例配置。启动命令我建议显式指定监听地址和端口cd /opt/deepseek-harness source .venv/bin/activate dsh serve --host 0.0.0.0 --port 8000这里有一个很多新手容易踩的坑不指定--host 0.0.0.0默认监听在127.0.0.1也就是只有服务器本机能访问外网再怎么放行安全组也没用。遇到 Web UI 打不开的情况第一件事检查监听地址是不是0.0.0.0。启动成功后命令行会打印一行访问地址比如http://0.0.0.0:8000。这时候你在本地浏览器输入http://你的公网IP:8000就能看到 Harness 的界面了。如果打不开先去看安全的组设置再确认防火墙有没有开最后检查监听地址这三步能解决九成的访问问题。3.4 版本升级与回退技巧Harness 迭代很快我遇到过几次升级之后插件不兼容的情况。这里分享一个特别有用的经验升级前先备份~/.dsh目录。cp -r ~/.dsh ~/.dsh.bak升级版本最简单的方式是去 GitHub Releases 页面下载新版本重复解压覆盖如果用 pip 安装的执行pip install --upgrade deepseek-harness如果你遇到新版不稳定想回退到指定版本比如网上很多人提到的 v0.1.5-rc.2可以这样操作pip uninstall deepseek-harness pip install deepseek-harness0.1.5rc2注意一下版本号的写法rc2在 pip 里是rc2而不是-rc.2直接搜pip index versions deepseek-harness可以看到完整版本列表。如果你用的是官方二进制安装包那就去 Releases 页面找到对应历史版本重新下载安装。备份目录在回退之后要恢复回去否则插件配置全部被初始化之前辛辛苦苦调好的智能体编排就全白费了。4. dsh-market 插件市场初始化、搜索与安装4.1 dsh-market 到底是什么如果你用过 VS Code 或者 Chrome就很好理解 dsh-market 了。Harness 本体只提供框架和基础能力真正好用的搜索、网页抓取、记忆管理、定时任务、绘图这些功能都通过插件的形式提供。dsh-market 就是给 Harness 用的“插件商店”通过它你可以搜索、安装、卸载插件甚至可以打包自己的插件分享给别人。我最初在本地用 Harness 的时候插件都是手动从 GitHub 下载然后解压到目录里版本一多就乱套了。后来上了 dsh-market一条命令就能管理所有插件省心不少。4.2 初始化插件市场源安装 Harness 之后dsh-market 的 CLI 可能已经内置也可能需要主动安装以你的 Harness 版本为准。验证方法dsh market --help如果提示没有这个命令去官方文档找 market 插件的安装包安装到 Harness 的插件目录即可。初始化市场源就是告诉 Harness 去哪里拉取插件列表。命令类似dsh market registry add official https://market.example.com/index.json这里的地址是示例实际以官方文档公布的市场地址为准。添加完成后可以查看已连接的源dsh market registry list如果你自己搭了插件源或者想把某台内网机器作为离线源可以再添加一个本地地址比如dsh market registry add local /opt/plugin-repo/index.json4.3 搜索、安装、卸载插件的完整命令市场源配置好之后插件操作就很顺了。先用搜索命令看看有哪些插件可用dsh market search web这条命令会把插件名称、简介、版本号列出来。我自己的习惯是先搜索过滤出我关心的关键词再决定装哪个不建议一上来就装一大堆。安装插件dsh market install plugin-name安装完成后用下面的命令确认是否安装成功dsh market list卸载插件dsh market remove plugin-name定期同步插件源dsh market update这一套命令用下来插件的全生命周期就覆盖了。重点提醒插件安装时如果报依赖错误通常是缺 Python 包或者 Node 运行时日志里会明确提示缺什么照着装就行。4.4 插件目录结构与手动打包插件用 dsh-market 安装的插件默认存放在~/.dsh/plugins/插件名/目录下。每个插件目录里必须有一个manifest.json用来描述插件的元数据。一个简单的 manifest 长这样{ name: hello-agent, version: 0.1.0, description: 一个示例插件, entry: main.py, requires: [requests] }如果你想写一个自己的插件只需要建一个目录放好 manifest.json 和入口文件然后用命令打包dsh market pack ./hello-agent打包后会生成一个.dshx文件这个文件就是可安装的插件包你可以放到自己的静态服务器上作为私有插件源也可以分享给朋友用。手动安装一个本地插件包的命令是dsh market install ./hello-agent.dshx说实话插件开发门槛不算高有 Python 基础就能上手。后面如果你们团队里有人写了一个好用的内部工具打包成 Harness 插件分发下去效率提升非常明显。5. 接入模型与多智能体编排让 Harness 真正干活5.1 连接 Ollama 本地模型Harness 本身不内置大模型它需要对接外部模型或 API。最常见的组合是 Harness 对接 Ollama 跑本地模型。在服务器上安装 Ollama 的方式这里不展开装好之后拉取一个模型ollama pull qwen2.5:7b然后在 Harness 的config.yaml里配置 Ollama 作为模型后端model: provider: openai-compatible base_url: http://127.0.0.1:11434/v1 api_key: ollama model: qwen2.5:7b thinking_mode: false这里解释一下为什么provider是openai-compatibleOllama 提供了兼容 OpenAI 格式的 APIHarness 可以用同一套协议对接不同后端换模型只需要改 base_url 和 model 名称不用改代码。配置好之后重启 Harness在界面里直接问一个问题如果能正常回答就说明模型连接成功了。5.2 配置 DeepSeek API 的思考模式如果你不想折腾本地模型直接用 DeepSeek 官方 API 是最省事的方案国内服务器访问延迟极低效果也稳定。在 DeepSeek 开放平台申请 API Key然后在 Harness 配置里改一下模型提供方model: provider: deepseek api_key: sk-你的密钥 base_url: https://api.deepseek.com/v1 model: deepseek-chat thinking_model: deepseek-reasoner thinking_mode: true这里有个细节值得注意deepseek-chat是普通对话模型响应快deepseek-reasoner是深度思考模型适合复杂推理、代码分析这些场景。Harness 的thinking_mode开启后可以指定一个思考模型专门处理需要深度推理的子任务然后让主模型负责最终回复。我的使用经验是日常聊天和简单任务用thinking_mode: false速度更快复杂任务比如多轮推理、长文档分析开启思考模式效果提升非常明显。5.3 多智能体编排的配置技巧Harness 最吸引我的就是多智能体编排能力。简单说你可以定义多个不同角色的智能体每个智能体有自己的模型、系统提示词和工具然后通过流程把这些智能体串起来完成一个复杂任务。举个例子我想写一篇行业调研文章拆成两个智能体agents: researcher: model: deepseek-chat system_prompt: 你是资深行业研究员擅长搜索和总结信息 tools: [web_search, web_fetch] writer: model: deepseek-chat system_prompt: 你是文案策划善于把零散信息组织成结构清晰的文章 tools: [markdown_render, note_save] flows: research_write: steps: - agent: researcher - agent: writer配置好之后触发流程dsh flow run research_write --input 2025年AI编程工具趋势Harness 会先让 researcher 去搜索资料把结论整理好再交给 writer 生成最终文章。整个过程不需要我手动切换工具还是很方便的。这里分享一个取舍插件不要装太杂尤其是要让智能体自动选择工具时工具太多会导致模型决策变慢还可能选错工具。宁可少而精先把核心流程跑通再慢慢加能力。6. 腾讯云环境下常见问题排查实录6.1 Web UI 公网访问不了这个问题的出现频率最高按顺序排查就好。第一步看监听地址。执行ss -tlnp | grep 8000如果看到127.0.0.1:8000说明进程只监听了本机Harness 启动时要加--host 0.0.0.0。第二步看安全组和防火墙。腾讯云控制台的防火墙规则只是第一层服务器内部的ufw或iptables规则也不能漏检查sudo ufw status如果开了 ufw执行sudo ufw allow 8000/tcp放行。第三步直接用 curl 在服务器本地测试curl http://127.0.0.1:8000如果能返回内容说明服务正常问题在公网链路重点检查安全组。如果 curl 卡住说明 Harness 本身没起来看启动日志。6.2 下载安装包慢或超时GitHub 下载偶尔慢这是很多人会遇到的问题。我的处理办法是先在本地电脑上下载安装包再用 scp 上传到服务器这样最稳。或者把 GitHub 仓库导入到国内的代码托管平台再从那里 clone。另外下载依赖时pip 和 npm 都尽量配置国内源速度差距很大。我之前没配源的时候装一个 requirements.txt 可能要二十分钟配了清华源之后两分钟搞定。6.3 插件安装失败的常见原因插件安装失败我遇到过的原因基本就三种一是 registry 地址不对服务器连不上插件源二是插件依赖的系统和 Harness 版本不兼容三是插件依赖的第三方包缺了。第一种执行dsh market registry list检查源状态换官方源或者自建本地源。第二种去插件的 manifest.json 看要求字段确认 Harness 版本是否满足要求。如果不满足要么升级 Harness要么换一个版本兼容的插件。第三种报错日志里会写明缺哪个依赖比如ModuleNotFoundError: requests就在 Harness 的 venv 里手动装一下再重启。6.4 进程守护与开机自启用nohup dsh serve启动的服务SSH 一断开进程可能就没了长期跑服务必须用 systemd 守护。在/etc/systemd/system/dsh.service里写[Unit] DescriptionDeepSeek Harness Afternetwork.target [Service] Userubuntu WorkingDirectory/opt/deepseek-harness ExecStart/opt/deepseek-harness/.venv/bin/dsh serve --host 0.0.0.0 --port 8000 Restartalways RestartSec5 [Install] WantedBymulti-user.target然后执行sudo systemctl daemon-reload sudo systemctl enable --now dsh以后服务崩了会自动拉起重启服务器也会自动启动查看日志用journalctl -u dsh -f。这里还有一个细节ExecStart里要写 venv 里的绝对路径不要直接写dsh否则 systemd 找不到命令。这个坑我踩过当时折腾了好久才反应过来。6.5 腾讯云服务器需要什么浏览器看到有不少人在搜索“腾讯云服务器用什么浏览器”这里专门说明一下。如果你用的是 Linux 云服务器默认没有图形桌面也不需要装浏览器。Harness 的 Web UI 是通过你本地的浏览器访问的服务器只是个“后台服务”不负责渲染界面。只有当你买的服务器是带图形界面的 Windows Server或者你自己装了 Ubuntu 桌面环境才需要在服务器内打开浏览器访问。但说实话没有必要白白浪费服务器资源。记住一个原则服务器上只跑服务访问服务用本地浏览器。最后再分享两个小经验。第一配置好 Harness 之后随手把~/.dsh目录打包备份到对象存储插件配置和智能体编排都不会丢换机器迁移的时候特别方便。第二插件真不用贪多先把搜索、记忆、定时任务这几个高频插件装好跑通一两个完整流程再按需扩展。我在云上跑了大半年最值钱的感觉就是“让 Harness 7乘24小时在线跑任务”那种第二天早上起来看到所有智能体已经把昨晚交代的活儿干完的感觉是真的爽。