Ubuntu 26.04 源码安装 DeepSeek Harness 完整教程

本教程将指导你在 Ubuntu 26.04 系统上，通过官方 GitHub 仓库源码编译并运行 DeepSeek Harness —— 一个基于 Node.js 的 AI 智能体框架。

1. 前提准备

更新系统并安装必要的基础工具：

sudo apt update
sudo apt install -y git curl

2. 安装 Node.js

DeepSeek Harness 要求 Node.js ≥ v22.19。Ubuntu 26.04 官方源已提供 v22.x，直接安装即可：

sudo apt install -y nodejs npm

若官方源版本过低，可使用 NodeSource 安装最新 LTS：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

验证安装：

node --version   # 应显示 v22.x.x 或更高

3. 安装 pnpm

DeepSeek Harness 使用 pnpm 作为包管理器，要求版本 ≥ 11。通过 npm 全局安装：

sudo npm install -g pnpm
pnpm --version   # 应显示 11.x.x 或更高

4. 克隆官方仓库并安装依赖

# 克隆仓库（带 .git 或不带均可）
git clone https://github.com/deepseek-ai/deepseek-harness.git

# 进入项目目录
cd deepseek-harness

# 安装项目依赖
pnpm install

5. 构建并启动服务

# 构建项目（这一步不可省略）
pnpm run build

# 启动 Web UI
pnpm dsh web

启动成功后，终端会显示访问地址（默认 http://127.0.0.1:3080）。
⚠️ 注意： 此终端窗口需要保持打开，关闭会导致服务终止。

6. 首次配置

1. 获取 API Key： 前往 DeepSeek 开放平台 注册并创建 API Key。
2. 填写 Key： 在浏览器访问 http://127.0.0.1:3080，进入 Settings → Models，在 DeepSeek 卡片中填入 API Key 并保存。
3. 选择工作区： 点击 Choose workspace，授予 Harness 访问指定文件夹的权限。

💡 其他安装方式（备选）

除了源码编译，还有两种更简便的方式：

• npx 一键启动： 无需克隆代码，直接运行 npx @deepseek-ai/dsh web（推荐新手使用）。
• 桌面应用： 社区封装的 .deb 或 .AppImage 文件，双击安装即可（非官方出品）。

至此，DeepSeek Harness 已在你的 Ubuntu 26.04 上成功运行。如有问题，欢迎在评论区交流！