NAS 部署 DeepSeek Harness:一句话,AI 帮你从零到部署上线
DeepSeek Harness:
一套模块化开源框架,给予 Agent 理解环境、使用工具,并在真实场景中持续工作的能力。

核心功能
多模型兼容:统一接口接入 DeepSeek、OpenAI 等各类大模型,轻松切换模型
内置工具集:支持操作文件、运行 Shell 命令、联网搜索、代码执行
插件化架构:所有能力都是插件,按需启用、自定义开发扩展
多智能体并行:单进程同时运行多个独立 Agent,任务互不干扰
完整执行日志:记录全部推理与工具调用过程,方便调试排查
权限沙箱管控:限制 AI 操作范围,降低本地执行命令的安全风险
自带 Web 交互界面:开箱即用网页控制台,也支持无界面后台运行
TIP:官方目前还没有出桌面端,不过有第三方的了

安装
Docker Compose(非官方)
services:
deepseek-harness:
image: 1panel/deepseek-harness:latest
container_name: deepseek-harness
ports:
- 8443:8443
environment:
- DSH_HOME=/data/dsh
- DSH_TELEMETRY_DISABLED=1
- HTTPS_ACCESS_HOST=192.168.31.90
- DSH_AUTH_USERNAME=admin
- DSH_AUTH_PASSWORD=adminadmin123
volumes:
- ./data:/data/dsh
- ./workspace:/workspace
restart: always
参数说明(更多参数建议去看文档)
DSH_HOME(环境变量):DSH 数据目录
DSH_TELEMETRY_DISABLED(环境变量):关闭遥测
HTTPS_ACCESS_HOST(环境变量):HTTPS 访问域名
DSH_AUTH_USERNAME(环境变量):Web 用户名
DSH_AUTH_PASSWORD(环境变量):Web 访问密码(至少 12 位)
/data/dsh(路径):存放配置和数据目录
/workspace(路径):初始化工作目录
使用
浏览器中输入 https://NAS的IP:8443 就能看到界面,注意是 HTTPS 不是 HTTP

TIP:有可能会提示不是私密连接,点击显示隐藏进入即可

输入用户名和密码(admin/adminadmin123)

DeepSeek Harness 目前的 0.1 版本仍处在面向 Harness 开发者进行测试的阶段,还有许多地方需要持续改进和打磨

如果你是用 DeepSeek 官方模型,填写 API 密钥即可,也可以稍后再配置

整体 UI 界面非常简约,点击左下角设置

特别注意,如果不是按本教程部署的,先查看是否正常显示(正在加载预设,或者不可用,就是有问题)

TIP:为了截图更好效果,这里我切换成深色主题

添加模型
接下来就是添加模型了,用中转站的选择“添加自定义提供方”

填写提供方的信息

填写完成,点击添加获取模型,最后创建就完成了

这样就创建好了,其他配置可以先不用管,回到主界面先试试效果

点击对话窗口,需要先创建工作区

创建项目
下面演示生成一个贪吃蛇的项目

如果是自定义模型的,先选择模型

输入需求,就可以让 AI 开始工作了

TIP:底下有任务列表,很清晰看到进行到哪一步

顶部有一个“轨迹”功能,能看到用户输入,AI 和工具直接的工作流

经过几次断联,终于跑完了(还是建议买官方模型,跑起来稳定很多)

访问页面端口,就能看到贪吃蛇项目了(这里端口我是重新映射)

测试了一下,全部功能都正常

TIP:不清楚是不是设置问题,项目并没有保存在 workspace 目录,而是 /data/dsh 下的 home 文件夹里面

除了标准模型,还有 PTC 模型、极简模型和创作模式可以选择,建议大家上手体验一下

安装插件
接下来说一下插件,这也是 DeepSeek Harness 最重要的部分。项目已经内置集成有很多个插件了,不过要打造完整形态还得靠社区插件

截至发文时,已经支持 3k+ 个相关插件
https://github.com/topics/dsh-plugin

目前插件第一名是 Open Design,主要是前端页面设计的
https://github.com/nexu-io/open-design

不过最吸引我的,还得是这个界面皮肤

演示一下怎么样安装插件,先创建一个新目录,将权限放开就不用各种授权了,输入让 AI 安装就行(因为是从 Github 拉取,需要有良好网络)

如果执行完还是不行,直接让 AI 修复

TIP:执行任务最重要的还是模型提供商是否稳定,不然很容易中途中断;另外一点就是网络条件,这点我就不细说了,懂得都懂。

最后成功安装好了,这个界面谁看了不迷糊

插件列表也能找到上面安装的插件

扩展
下面说一下配置问题,让 DeepSeek Harness 更好用
改用 host 模式后,AI 创建的项目可以随意绑定端口,直接打开网页就能访问效果
network_mode: host
如果你免登录访问,可以删除 Caddy 的 basic_auth 参数
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile
可直接映射下面 Caddyfile 文件
{
admin off
auto_https disable_redirects
default_sni {$CADDY_ACCESS_HOST}
skip_install_trust
}
https://{$CADDY_ACCESS_HOST}:8443 {
tls internal
encode zstd gzip
header {
X-Content-Type-Options "nosniff"
Referrer-Policy "same-origin"
-Server
}
reverse_proxy 127.0.0.1:3080 {
header_up Host 127.0.0.1:3080
header_up Origin http://127.0.0.1:3080
}
}
总结
DeepSeek Harness 是 DeepSeek 官方的开源 Agent 框架,给 AI 配上文件操作、命令执行、联网搜索等工具,让它能在真实环境里持续干活。实测让它生成一个贪吃蛇项目,从建代码到跑测试都完成了,效果超出预期;插件生态也丰富,截止发文已经超过 3K+ 的插件了。
不过目前还在开发者预览版,任务中断后工作区残留文件、安装插件导致启动失败等问题不少。适合喜欢折腾的 AI 玩家和开发者尝鲜,普通用户建议等更稳定版本和官方桌面版。
综合推荐:⭐⭐⭐⭐(国内版 Codex,潜力很大)
使用体验:⭐⭐⭐(还需观望,目前官方没提供桌面版)
部署难易:⭐⭐⭐⭐(坑很多,认真看教程)︎
作者声明本文无利益相关,欢迎值友理性交流,和谐讨论~
