首页›教程

在 Linux 上安装 DeepSeek Harness

安装兼容的 Node.js，启动本地 DSH Web UI，连接 DeepSeek，并在可丢弃文件夹中测试一次文件改动。

本页内容

开发者预览

DSH 可能随版本变化。如果本页与当前产品不一致，请以页面底部链接的官方仓库和文档为准。

开始前

需要 Linux Shell、网络连接和 DeepSeek 账号。本指南假设 DSH 与浏览器运行在同一台机器。当前上游 DSH 的 Node engine 为 ^22.19.0 || >=24.0.0。

第 1 步

安装兼容的 Node.js

如果尚未安装 Node.js，请使用已有版本管理器，或按照 nvm 官方说明操作。使用 nvm 时运行：

nvm install --lts

也可以使用 Node.js 官方下载页。当前 DSH 要求是 ^22.19.0 || >=24.0.0。

SCREEN GUIDE · 安装 Node.js

安装 Node.js

1使用已有 Node 版本管理器或 nvm 官方说明

2安装满足 DSH engine 的版本

3下一步核验 node 与 npm

不要只看“Node 22/24”大版本；npm 报 engine 错误时应核对完整版本范围。

第 2 步

打开终端

用普通用户打开常用 Shell。许多桌面发行版可以按 Ctrl + Alt + T 打开终端。

SCREEN GUIDE · 打开终端

打开终端

1打开 Terminal、Konsole 或发行版自带终端

2使用普通用户账号

3等待 Shell 提示符

终端名称会随桌面环境不同而变化。

第 3 步

核验 Node.js 与 npm

node --version

npm --version

两个命令都应输出版本号。把 Node 版本与当前 DSH 要求 ^22.19.0 || >=24.0.0 对照；“已经是 Node 22”并不代表 22.19 以前的小版本一定可用。

SCREEN GUIDE · 核验 Node.js

you@linux:~$ node --version
满足 ^22.19.0 或 >=24.0.0
you@linux:~$ npm --version
XX.X.X

DSH 的 engine 可能随版本更新；出现 engine 报错时以当前上游 package.json 为准。

第 4 步

启动 DeepSeek Harness

npx @deepseek-ai/dsh web

第一次启动可能更慢

npx 可能需要先下载 DSH 包。如果终端还没有明确报错，请保持窗口打开，等待 Web UI 地址或真正的 npm/网络错误。不要在等待期间连续启动多个 DSH。

使用 DSH 时保持这个终端进程运行；关闭进程会停止本地 Web UI。

SCREEN GUIDE · 启动 DSH

you@linux:~$ npx @deepseek-ai/dsh web
... DSH 下载/启动 ...
Web UI: http://127.0.0.1:3080

启动输出与首次启动时间可能变化，真正需要关注的是最终 URL 或准确错误码。

第 5 步

打开本地 Web UI

http://127.0.0.1:3080

本机正常启动时，DSH 通常会自动打开默认浏览器。如果没有自动打开，请手动打开终端实际打印的地址。若终端先出现 EADDRINUSE 或 EACCES，先解决端口问题。

SCREEN GUIDE · 打开 DSH

http://127.0.0.1:3080

打开 DSH

先看 DSH 是否已自动打开浏览器

没有打开时手动进入终端打印地址

保持 DSH 终端运行

页面失败时查看准确错误码

通过 SSH 启动时不自动开浏览器属于正常行为。

第 6 步

获取 DeepSeek API Key

打开 DeepSeek API Keys，登录后创建或复制一个 Key。

妥善保管 Key

不要把真实 API Key 放入截图、代码仓库、Prompt 或公开支持信息。

SCREEN GUIDE · DeepSeek API Keys

https://platform.deepseek.com/api_keys

DeepSeek API Keys

创建或复制 API Key

返回 DSH

DeepSeek 账号界面可能独立于 DSH 发生变化。

第 7 步

配置 DeepSeek

在 DSH 中打开 Settings → Models，把 API Key 粘贴到 DeepSeek 服务商卡片并保存。保存后下一次请求即可使用，不需要为此重启 DSH。

DeepSeek Harness 官方 Models 设置页 — 来自 DeepSeek Harness 模型配置文档的官方截图。

第 8 步

选择测试工作区

mkdir -p ~/dsh-test

在 DSH 中点击 Choose workspace，选择 ~/dsh-test。启动命令所在目录不会自动成为已选工作区，首次会话请明确选中可丢弃文件夹。

SCREEN GUIDE · 选择工作区

选择工作区

1点击 Choose workspace

2添加 ~/dsh-test

3选择该文件夹

4确认输入区可用

不要从重要仓库或包含敏感信息的文件夹开始。

第 9 步

运行首次任务

在这个工作区创建 README.md，内容为“Hello from DeepSeek Harness”。然后总结你做了什么改动。

SCREEN GUIDE · 首次会话

http://127.0.0.1:3080

首次会话

创建新会话

选择已配置模型

发送 Prompt

接受前阅读每项授权请求

检查 ~/dsh-test 中的 README.md

请在工作区中直接核验文件，不要只依赖聊天回答。

Linux 常见错误

nvm、node 或 npm 找不到

打开新终端或重新加载 Shell Profile。如果仍不可用，请回到所选安装方式并确认安装完成。

npm 提示 Node engine 不兼容

运行 node --version，并与当前上游要求 ^22.19.0 || >=24.0.0 对照。

npx 首次启动看起来停住

如果终端还没有明确报错，请保持窗口打开。第一次运行可能正在下载 DSH 包。

EADDRINUSE：3080 已被占用

运行 lsof -nP -iTCP:3080 -sTCP:LISTEN 找到监听进程，停止旧进程，或使用 --port 13080 启动。

127.0.0.1:3080 无法打开

确认 DSH 进程仍在运行。若 DSH 位于远程服务器，127.0.0.1 指向的是该服务器；当前官方 CLI 不应直接照搬旧教程里的 --host 0.0.0.0。

MISSING_CREDENTIAL

打开 Settings → Models，重新保存 DeepSeek API Key。

工作区出现 Permission denied

使用普通用户拥有的测试文件夹，不要选择受保护的系统目录。

查看完整问题排查步骤 →

从源码运行 DSH

仅当你要参与 DeepSeek Harness 仓库开发时才使用下面的方式。当前上游还要求 pnpm，并使用同样的 Node engine 范围。

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

下一步使用 DSH Web UI

继续 →

来源

DeepSeek Harness 仓库 · 当前 Node engine · CLI 行为参考 · Node.js 下载页 · nvm