SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor · 更新于 2026-11-05

如何在 VPS 上安全部署 DeepSeek Harness

在 Linux VPS 上部署 DeepSeek Harness 时,请务必绑定 127.0.0.1 并通过 SSH 隧道访问 3080 端口。本文详解如何固定 npm 版本,并分析其插件化架构带来的安全风险,防止未经授权的访问导致系统命令被恶意执行。

DeepSeek Harness 是什么

DeepSeek Harness(dsh)是一种 Node.js agent runtime,可运行在 VPS(virtual private server)上。安全的运行方式是将其绑定到 127.0.0.1,再通过 SSH(secure shell)隧道让浏览器访问。它会在 3080 端口提供 Web UI(user interface),而不是运行在终端中。在本指南固定使用的 0.1.0-rc.6 release 中,该 Web 服务器不要求自身密码,因此公开 3080 端口后,任何找到它的人都可以获得一个以你的 Linux 用户身份读取文件和运行命令的 agent。较新的 release,从 0.2.0-rc.2 到 0.2.2-alpha.2(日期为 28 October 2026),也就是 GitHub 在 29 October 2026 列出的最新 release,会打印一个携带该进程新 token 的启动 URL,并将其换成 session cookie;但它们默认仍只监听 loopback,也仍拒绝绑定所有 interface。

DeepSeek 于 13 August 2026 以 MIT licence 发布了它,npm package 为 @deepseek-ai/dsh。项目将自身描述为 developer preview,并说明预计会发生破坏兼容性的变更。下面固定使用的版本是 August 2026 release。27 October 2026,npm 的 latest tag 指向 0.2.1-rc.2,其 next tag 指向 0.2.1-rc.4。GitHub 目前列出 0.2.1-rc.4,tag 为 dsh-v0.2.1-rc.4,发布于 28 October,修复了 ACP mode 下诊断信息泄露到 stdout 的问题;更新的 0.2.2-alpha.2 也发布于 28 October,是 GitHub 在 29 October 2026 列出的最新 prerelease。在将其复制到重要服务器之前,请先检查 repository。

整个设计贯穿着一个理念:一切都是 plugin。模型适配器、工具注册表、session log、sandbox、scheduler 以及 agent loop 本身都是加载到同一共享 context 中的 plugin,任何一个都可以替换。不存在一个 plugin 只能对其进行装饰的特权 core。这正是值得尝试该 harness 的原因,也是唯一真正的风险所在。是否值得承担这一取舍,取决于你将它与什么进行比较;它与 Claude Code 和 Omnigent 的表现对比会将这种一切皆为 plugin 的设计,与另外两种关于模型耦合、licence 以及各自需要 VPS 提供多少资源的方案并列比较。

Harness 不是模型

Harness 运行 agent 循环。推理发生在其他位置的模型中,因此除非为它提供 API(application programming interface)密钥,或提供自行托管的模型端点地址,否则整个流程无法工作。本文介绍的内容全部属于 harness 配置,而不是模型行为;在开始花费一下午排查问题来源之前,最好先厘清两者之间的界限。

请在 UI 中依次打开 Settings 和 Models 进行配置。DeepSeek 有自己的卡片;在当前版本中,其下方的 "Add model provider" 按钮会打开两种模式。"Third-party model provider" 适用于 harness 已提供目录的供应商,例如 OpenAI 和 Anthropic。你只需粘贴密钥,目录会提供端点和模型列表。"Custom model API" 是更灵活的选项:它要求填写小写的 provider ID、显示名称、base URL、API 协议、凭据以及至少一个模型。协议选择器提供 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages,因此你可以配置使用其中一种协议的网关或本地服务器;请求格式存在差异的端点还需要兼容性设置。自定义供应商也可以查询 OpenAI 兼容的 GET /models 端点,自动填充模型列表。

这就是让 harness 使用同一台 VPS 上模型的方法。Ollama 在 http://127.0.0.1:11434/v1/ 提供 OpenAI 兼容的 API,API key 字段可以填写任意字符串,通常使用 ollama,因为 OpenAI 风格客户端要求该字段有值,而 Ollama 会忽略它。Ollama 自己的文档还介绍了 ollama launch dsh;如果 @deepseek-ai/dsh 不存在,该命令会安装它,并让它使用 Ollama 模型启动。因此,在依赖下面的版本固定值之前,请先确认它安装的版本。能够装入 VPS 的小型模型是否足以驱动 agent,是更难回答的问题;Ollama 与 vLLM 作为本地模型服务器的区别决定了这个答案会占用多少 RAM。

在 UI 中输入的密钥只能写入,不能读取。Harness 将其存储在 $DSH_HOME/.credentials.yaml 中,设置仅保留凭据引用;当前版本会将该引用写入活动 profile 的补丁文件 $DSH_HOME/profiles/<profile>/cordis.patch.yml(profile 为 web,用于 dsh web)。$DSH_HOME 的默认值为 ~/.dsh。请将凭据文件视为密码文件,因为它确实是密码文件:任何能读取它的人都可以消耗你的 API 预算。如果你使用的是 DeepSeek 自家的 API,这笔预算就是预先充值的余额,而已开票和已消耗的金额都不能退款,因此请在充值前先了解它的充值、开票和退款规则,其中也说明了余额显示 0 或接口返回 402 时如何排查。如果你希望直接编辑这些文件,而不是在 Settings 中逐项点击,dsh 配置文件、密钥和模型端点详解会说明每个键的作用,以及每种模式下哪些内容会离开你的服务器。

安装前的准备工作

  • 一台运行 Ubuntu 24.04 或其他当前版本 Linux 的 VPS,并可通过 SSH 访问
  • Node.js 24.9 或更高版本,因为项目的主分支和 0.2.2-alpha.2 现在都声明使用 >=24.9.0,其 CI 使用 Node 24 运行测试,并通过兼容性检查验证 Node 24.9 和 Node 26;不再包含 Node 22 的任务;截至 0.2.1-rc.4 的带标签版本仍将 Node 22.19 列为可接受版本,但这已不再是项目构建所依据的最低版本
  • 一个普通用户账户,而不是 root,因为代理会以启动进程的用户身份运行 shell 命令
  • 如果计划安装插件,需确保 pnpm 位于 PATH 中,因为插件命令会调用它
  • 在防火墙和服务商单独提供的网络防火墙上关闭端口 3080

Ubuntu 自带的 nodejs 软件包版本低于该工具所需版本,因此应通过 NodeSource 或 nvm 安装 Node,不要使用 apt install nodejs。如果 VPS 是全新部署的,优先加固 SSH 值得花十分钟,因为即将依赖的隧道,其安全性取决于后端 SSH 服务器的安全性。

在 VPS 上安装 DeepSeek Harness,并固定到一个版本

node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 web

npx下载软件包并运行其 dsh 二进制文件。web 是 --profile web 的别名,它会启动浏览器应用,进程还会输出其监听的地址。默认值为 http://127.0.0.1:3080。这些数字是绑定配置,而不是无关紧要的默认值。为什么 dsh 会输出回环地址介绍了 Harness 在您从笔记本电脑查找它之前会响应和不会响应哪些请求。

固定版本。除非运行该命令的项目已经安装了副本,否则 npx @deepseek-ai/dsh web 会解析该命令执行时 latest 标签所指向的版本;如果项目已有副本,npx 会静默使用该副本。无论哪种情况,版本都不是由您选择的,而且该项目已经发布了多个候选版本,并表示即将引入不兼容变更。0.1.0-rc.6 是此处固定的 2026 年 8 月版本。2026 年 10 月 27 日,latest 指向 0.2.1-rc.2,这是一个会输出带令牌启动 URL 的版本;next 标签则指向更新的预发布版本 0.2.1-rc.4。GitHub 现在已经提供 0.2.1-rc.4 的发行说明,并列出了更新的 0.2.2-alpha.2,因此切换到其他版本时,应先阅读代码库,再有意执行升级。固定版本意味着您今天配置的服务器下个月仍会以相同方式运行,因此升级会变成由您决定的操作,而不是事后才发现的意外。当固定版本的命令仍然启动错误的构建,或完全无法安装时,常见的 dsh 安装和版本错误介绍了如何清除 npx 缓存,以及如何检查 Node 随附的 npm。

日常使用时,先安装一次,避免每次启动都重新解析版本。

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

第二行命令值得执行,因为启动器和 Web 应用使用的是两套独立的选项。dsh --help 显示启动器自身的选项。dsh --profile web --help 显示 Web 应用接受的选项,其中包括 --port、--host 和可重复指定的 --trusted-host。

现在确认它监听的地址。

ss -tlnp | grep 3080

本地地址列应显示 127.0.0.1:3080。如果显示 0.0.0.0:3080,则表示 UI 正在所有网络接口上监听。此时,只有防火墙可以阻止互联网访问它。您应先停止该进程,再进行其他操作。

为什么绝不能公开发布端口 3080

0.1.0-rc.6 中的 Web 服务器没有身份验证层。其配置会公开监听主机和监听端口,这就是全部暴露面。对于非回环部署,访问控制由单独的受信主机设置负责,而不是登录界面。

较新的版本增加了身份验证层。从 0.2.0-rc.2 开始,启动时会输出一个包含该进程新令牌的 URL;打开该 URL 的浏览器会收到签名会话 Cookie,随后在不带令牌的情况下重定向到同一地址。/api 前的 Host/Origin 防护只接受回环地址、监听器自身的绑定地址,以及通过 --trusted-host 指定的主机名。这是真正的凭据,但项目文档明确警告:输出的 URL 是凭据,只应与指定用户共享;普通 HTTP 会在未加密的情况下传输它。从 0.2.1-alpha.2 开始,Web 应用还可以绑定一个具体的本地地址,并通过 --tls-cert 和 --tls-key 自行提供 HTTPS。这解决了明文传输问题,但没有解决暴露问题。它让公开端口更难被滥用,但不会让公开端口变得安全。

现在再看该端口后面的内容。代理会编辑工作区中的文件并运行 shell 命令,而提供商凭据就存放在旁边的磁盘上。因此,在固定版本中,开放的端口 3080 就是一个带聊天界面的远程 shell,以启动它的用户身份运行,并附带您的 API key。攻击者不需要利用漏洞。他们只需要端口号,而扫描器会在主机上线后几小时内发现端口号。对于带启动令牌的版本,他们还需要令牌;任何能读取您的终端、服务日志或未加密流量的人都已经可以获得该令牌。

CLI(命令行界面)也遵循这一原则。从 0.1.0-rc.6 开始,它会有意不支持 --host 0.0.0.0,而是退出并报告用法错误,不会启动;较新的 0.2.2-alpha.2 在启动时仍会拒绝该选项。这种拒绝本身就是安全功能,因此不要尝试寻找能够移除它的补丁。

隧道不适用时,还有两种合理的部署方式。将该主机接入私有覆盖网络,使其只拥有您自己的设备能够路由到的地址;自托管 Headscale 控制服务器即可实现这一点。或者在端口 3080 前置一个反向代理,在请求到达该端口前完成身份验证,例如使用 Authentik 单点登录服务器执行 forward auth。前面没有身份验证的反向代理不是安全控制,而只是更长的 URL。

通过 SSH 隧道访问 Web UI

请在笔记本电脑上运行此命令,不要在服务器上运行。

ssh -N -L 3080:127.0.0.1:3080 you@your-server

-L 会在笔记本电脑上开放 3080 端口,并通过加密的 SSH 会话转发所有连接到该端口的流量。127.0.0.1:3080 部分会在服务器上解析,因此连接从回环地址到达测试工具,就像您直接坐在该机器前操作一样。-N 表示不要启动远程 shell,因为您只需要端口转发,不需要其他功能。

然后在本地浏览器中打开 http://127.0.0.1:3080。对于带有启动令牌的版本,请改为打开服务器打印的完整启动 URL,并保留令牌;通过 SSH 启动测试工具时,它仍会打印启动信息,但不会尝试替您打开浏览器。如果笔记本电脑上的 3080 端口已被占用,请更改左侧的端口号:ssh -N -L 3180:127.0.0.1:3080 you@your-server,然后浏览到 http://127.0.0.1:3180;对于包含令牌的 URL,也应采用相同方式修改端口。左侧的端口号属于本地,右侧的端口号属于服务器,因此只需修改左侧的端口号。

将其保存到 ~/.ssh/config,以后不要再手动输入。

Host dsh
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  LocalForward 3080 127.0.0.1:3080

之后,ssh -N dsh 会启动隧道。浏览器报告连接被拒绝,通常表示隧道已建立,但远端没有进程监听该端口,因为无论测试工具是否运行,SSH 都会转发该端口。使用上面的 ss 命令检查服务器。如果您还打算在同一台 VPS 上运行其他接入 DeepSeek 的 Web 应用,在 VPS 上自托管 MoneyPrinterTurbo采用了同样只绑定 127.0.0.1 再通过 SSH 隧道访问的做法,并介绍了不便使用隧道时如何改用 Caddy 加上密码。

注销后保持 harness 运行

npx 命令会随 shell 一起退出。systemd 用户服务可以持续运行,并在 harness 崩溃或系统重启后将其重新启动。这里的单元配置刻意保持精简;如果您希望让 harness 在单独的受限账户下运行、在单元中固定版本,并记录可实际搜索的日志,请参阅dsh 的无头 systemd 配置,其中对此有完整说明。

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger 很重要,因为用户服务通常会在最后一个会话结束时停止。如果没有它,关闭隧道后 harness 会立即退出。使用 command -v dsh 输出的绝对路径,并将其写入单元文件,因为 systemd 不会搜索登录 shell 设置的 PATH。

[Unit]
Description=DeepSeek Harness web UI
After=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

WorkingDirectory 并非可有可无。dsh 进程会将启动它时所在的目录作为默认文件系统位置,因此服务从错误目录启动时,会将 agent 指向错误的文件夹。不过,该目录只是默认位置:全新的 Web UI 在您通过 Choose workspace 添加工作区之前不会选定任何工作区,项目指南要求您添加启动 dsh 时所在的目录。该指南没有版本标记,而相同的表述已经存在于 0.1.0-rc.7 中;这是 pin 之后四天发布的最早标记版本,因此固定到该版本时也应能看到相同内容。将单元的工作目录设置为项目目录,然后在 UI 中选择该工作区。

systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dsh

拒绝启动的单元几乎总是使用了错误的 ExecStart 路径,或二进制文件不接受当前的 Node 版本;journalctl --user -u dsh -n 50 会说明具体是哪一种。在包含启动令牌的版本中,日志还会记录带令牌的启动 URL,并且每次重启都会生成一个新的 URL。同样的方法也适用于让 VPS 上的任意编码 agent 持续运行,其故障模式也完全相同。

插件允许执行的操作

插件是一个模块,可向共享上下文提供服务、类型化事件和可逆效果。扩展点最值得仔细阅读:

  • 在 ctx.llm 上注册模型提供程序
  • 在 ctx.tools 上添加面向模型的工具
  • 提供 ctx.shell 背后的 shell 后端
  • 提供文件系统访问或策略,实现于 ctx.fs
  • 在 ctx.commands 上注册人工命令
  • 通过 ctx.jobs 运行后台任务
  • 使用 ctx.sandbox 后端封装生成的进程
  • 通过 agent/* 和 tools/* 事件拦截请求和工具调用
  • 扩展持久会话状态
  • 通过 ctx.agents 驱动 UI

请从攻击者的角度理解这份列表。插件可以提供文件系统层和 shell 层,还可以介入模型发出的每次工具调用。插件与这些扩展点之间没有权限确认对话框,因为插件只是普通的 Node 代码,与其他所有代码在同一进程中加载。安装插件就等于以 agent 的权限运行陌生人的代码,而 agent 的权限就是您的 Unix 用户权限。

这与将 MCP 服务器连接到 VPS 上的 agent 时所做的信任决策相同,其中 MCP 表示模型上下文协议。这也是为什么在 VPS 上安全运行编码 agent时,首先要考虑它运行所使用的账户,而不是模型本身;这也解释了npm 供应链攻击为何会严重影响服务器:安装步骤就是入侵发生的步骤,而且不会弹出任何提示。

插件的来源

插件位于配置集中。配置集是存储在 $DSH_HOME 下的命名组合,默认位置为 ~/.dsh;每个配置集目录都包含它所安装的非树内插件。

CLI 会将您的参数直接转发给 pnpm,并将配置集目录作为工作目录来管理这些插件。

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

由于参数会原样传递给 pnpm,add、remove、update 和 why 的行为与任何 pnpm 项目中的行为相同,插件可以是 npm 包,也可以是 GitHub 引用。pnpm 必须先位于 PATH 中。在 Node 24 上,corepack enable pnpm 会将其放入 PATH。Node 25 停止随附 Corepack,因此在 Node 25 及更高版本上应改用 npm install -g pnpm 安装它。

插件发现通过 GitHub topic 实现。插件作者会将 dsh-plugin topic 添加到自己的仓库,浏览该 topic 即可查找现有插件。Topic 是作者应用于自己仓库的标签。没有人审核或签署它,topic 页面按 stars 排名,而 stars 衡量的是受欢迎程度,不是安全性。

当前的 0.2.1 版本还包含一个实验性的 Custom plugin markets bundle。在 Plugins 下启用后,Discover 标签页会允许您添加 market。Market 是从您提供的 URL 获取的 JSON 索引文件。该 harness 不提供自己的索引,只检查文件格式,不检查 market 声称的标题、作者或来源;任何位于网络路径上的人都可以改写通过明文 http: 提供的索引。Market 是他人编写的目录,不是审查结果。

遵循以下四点即可控制风险。安装前先阅读源代码,因为大多数插件都很小,十分钟内即可读完。固定使用确切版本或 commit,不要跟踪分支。在您愿意重建的 VPS 上,以不拥有其他资源的用户运行该 harness。为 agent 使用独立的 API key,并设置独立的消费限额,不要使用生产服务所用的 key。阅读插件并想了解哪些文件承载风险时,dsh 插件审查指南会介绍 manifest、入口点以及插件注册的扩展点。

如果您希望在选定方案前比较设计,Omnigent 多 agent harness以不同结构解决同一问题;启用插件后,其中的权衡会变得清晰。如果您最终决定在同一台服务器上保留两个或三个 harness,而不是选出一个,则将所有 harness 放在一个自托管 API 后面可以免去每个端口配置一个隧道,但需要额外运行一个服务,并在第一天就将其绑定到 loopback、设置真正的密码。

首先出现的问题

Node 版本过旧。 项目的主分支和 0.2.2-alpha.2 要求 Node 24.9 或更高版本,其 CI 会测试 Node 24,并在 Node 24.9 和 Node 26 上执行兼容性检查,但不会在 Node 22 上测试。直到 0.2.1-rc.4 的旧版标签仍将 Node 22.19 列为可用版本,但项目已不再针对该版本构建。旧运行时会在启动时失败,因为代码使用了该运行时不支持的语法和 API。首先运行 node --version。

3080 端口已被占用。 可能是第二个 harness、残留进程,或同样使用 3080 的其他应用。使用 ss -tlnp | grep 3080 查找占用进程,然后停止它,或使用 dsh web --port 3180 在其他端口启动 harness。--port 属于 Web 应用,因此应放在 web 之后。

浏览器无法通过隧道连接。 确认你访问的是 127.0.0.1,而不是服务器的公网地址,因为转发端口只存在于你的笔记本电脑上。然后确认 harness 正在服务器上监听,因为无论远端是否有程序响应,SSH 都会建立端口转发。

dsh plugin 立即失败。 该命令是 pnpm 的封装,因此如果缺少 pnpm 二进制文件,命令会在任何插件工作开始前停止。在 Node 25 及更高版本中,这是默认状态,因为 Node 不再随附 Corepack。

agent 无法看到你的项目。 新打开的 Web UI 在你添加工作区之前不会选择任何工作区,添加之前会话编辑器也无法使用。进程仅将其启动目录作为默认文件系统位置,因此如果某个单元的 WorkingDirectory 是你的主目录,该单元就会将 agent 指向你的主目录。在 UI 中选择工作区,或修正该单元并重新加载。

FAQ

在 3080 端口公开 DeepSeek Harness Web UI 是否安全?

不安全。在固定使用的 0.1.0-rc.6 中,Web 服务器没有自身的登录机制,后面的 agent 会以启动该进程的用户身份编辑文件和运行 shell 命令,而你的 provider API key 存储在同一磁盘上。从 0.2.0-rc.2 开始,包括 0.2.1-rc.2、npm 于 27 October 2026 标记为 latest 的 release 以及更新的 0.2.2-alpha.2 prerelease,启动时打印的 URL 会携带一个启动 token,浏览器会用它换取 session cookie;但该 URL 本身就是 credential,而普通 HTTP 会以未加密方式发送它,因此建议不变。将监听器保持在 127.0.0.1,通过 SSH 隧道访问。私有 overlay network,或在请求到达该端口前对每个请求进行身份验证的 reverse proxy,也可以使用。截至 version 0.1.0-rc.6,CLI 会拒绝 --host 0.0.0.0 并以 usage error 退出,0.2.2-alpha.2 仍会拒绝它;这说明了作者对这种做法的态度。

我需要 DeepSeek API key,还是可以使用本地模型?

两者都可以,因为 harness 是 runtime,而不是 model。在 Settings,然后进入 Models,你可以将 key 粘贴到 DeepSeek card 或 catalog provider 中,也可以选择 "Add model provider",再选择 "Custom model API",并提供一个支持 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages 的 base URL。本地 Ollama server 在 http://127.0.0.1:11434/v1/ 响应,并接受 API key 字段中的任意字符串。Key 会写入 $DSH_HOME/.credentials.yaml,其默认值为 ~/.dsh/.credentials.yaml。

安装 DeepSeek Harness plugin 后,该 plugin 实际获得什么?

运行 harness 的 account 所拥有的权限。Plugin 是加载到同一进程中的 Node code,扩展点包括 shell backend、filesystem layer、tool registry,以及包裹每次 tool call 的 events。除非 plugin 自己提供 sandbox,否则没有任何机制能将 plugin 与这些接口隔离。安装前请阅读 source,并以不拥有任何重要资源的用户身份运行 harness。

我应该安装哪个版本?它会持续正常工作吗?

请安装确切版本,例如 npx @deepseek-ai/dsh@0.1.0-rc.6 web。这是此处固定使用的 August 2026 版本。27 October 2026,latest 指向 0.2.1-rc.2,next 指向 0.2.1-rc.4;29 October 2026,GitHub 列出 0.2.1-rc.4 和更新的 0.2.2-alpha.2,后者发布于 28 October,且 0.2.2-alpha.2 要求 Node 24.9 或更高版本。项目将自身称为 developer preview,并表示预计会发生破坏兼容性的变更,因此未固定版本的命令可能每天表现不同。升级前请检查 repository,并预计在版本仍以 0 开头期间,config keys 和 plugin interfaces 可能发生变化。

这篇文章对您有帮助吗?