一句话答案

有台常年开着的机器、代码不方便往外放、还想用手机随时打开——值得，半小时能跑起来。

只有一台笔记本，或者只是想看看它长什么样——不值得，用官方网页版就行。

中间那一大片灰色地带，看下面三笔账。

你搜的那三个词，其实是三种东西

搜 deepseek harness 下载 的人想找一个软件，搜 deepseek harness docker 的人已经知道要自己跑，搜 deepseek harness 插件 的人已经在用了。三拨人想要的不是同一件事。

它本身是 DeepSeek 开源的 AI Agent 运行时：管会话、工具、权限和网页界面，模型调用走你自己的 API Key。它不带模型权重，也不是推理服务器。

所以「装」的对象是承载它的那层壳。壳有三种做法：

三条都能用。区别是最后一行：出问题的时候，你手里有没有那堆文件。

第一笔账：钱

自建这件事，硬件往往比软件贵。按常见配置估：

一年两三百块，换一个「随时能开、数据在自己盘上」的入口。这个价不算贵，但也不是零成本——真正贵的是第二笔账。

第二笔账：时间

装一次大概半小时：拉镜像、写 Compose、起容器、登录、选目录、填 Key。

之后是长期的：

• 换版本：改一行标签，docker compose up -d，五分钟。
• 备份：停容器，打包 data/，两分钟。忘了备份，等于把登录状态和会话都押在这块盘上。
• 出事：登录不上、页面转圈、反代挂了——这类问题没有固定耗时，可能十分钟，也可能一晚上。

如果你一年都不会打开它第二次，这笔账是亏的。真正常用的判断标准很简单：过去一个月，你有没有十次以上「想找个地方让 AI 帮我改点东西」的念头。

第三笔账：风险

这笔账最容易被忽略，因为它不出现在账单上。

DeepSeek Harness 不是聊天框。它能读文件、写文件、执行命令、联网。你把它架起来，等于在自己机器上开了一个能动手的远程入口。

四件事必须做，少一件都别上公网：

1. 别把容器端口裸映射到 0.0.0.0。 只在本机或内网监听，公网走反代。带网页界面的 shell 挂在公网上，被发现只是时间问题。
2. 入口必须有登录。 这也是选带 Caddy 登录层的镜像（比如 moelin/deepseek-harness）而不是裸跑的原因——省得自己写一层认证。
3. 只挂一个专用目录。 给它一个 workspace/ 就好，别把 ~/.ssh、生产配置、整个 /var/lib/docker 挂进去。它能改的东西，就是它可能改坏的东西。
4. 给它单独的 API Key。 出事能单独吊销，不影响你其他服务；顺手设个额度上限。

做完这四条，风险是可控的。不做，就是把家门钥匙挂在门口。

门槛不在 Docker，在那台常开的机器

很多人卡住的不是命令，是「我没地方跑」。

• 笔记本：合盖就断，定时任务跑一半没了，不建议。
• NAS：能跑 Docker 就行，amd64 和 arm64 都有镜像，群晖、威联通都行。这是最合适的一类机器——本来就 24 小时开着。
• 云服务器：最省事，注意别买最小配置还要跑编译。
• 软路由 / 迷你主机：够用，注意磁盘别用 U 盘。

如果这四样里一样都没有，先解决机器，再谈部署。

想试的话，15 分钟够走完一圈

不用一上来就想架构。最短路径是先跑起来，验证四件事：

1. 能不能登录（用户名密码那一层通不通）
2. 能不能选到目录（挂载对不对）
3. 能不能发一条消息（API Key 通不通）
4. 重启容器后，登录状态还在不在（/data 挂没挂）

第四件事最关键。没挂 /data 的部署，第一次重启就把登录状态和会话一起丢了，很多人是在第二天早上才发现。

docker pull docker.xuanyuan.run/moelin/deepseek-harness:0.2.1-rc.3
cd /www/wwwroot/deepseek-harness-moelin && docker compose up -d
# 浏览器打开 http://服务器IP:56789/ ，账号 admin + 你自己设的密码

完整的 Compose 文件、九个步骤的截图、报错对照表，在这篇部署手册里，这里不重复贴。

登录进去之后，第一件事不是提问，是选工作区。「主目录」对应容器里的 /workspace，也就是你挂的那个目录——仓库得先放进去，界面里才看得见。

五个一眼能看出的误区

这五条踩中任何一条，都不算部署成功，只是「这次能打开」。

一分钟决策表

延伸阅读