DeepSeek Harness 在 Ubuntu 服务器上的安装指南

本指南记录在远端 Ubuntu 服务器上安装 DeepSeek Harness 的完整流程，包括使用 nvm 安装 Node.js、通过 npm 安装 DeepSeek Harness，以及通过 VS Code 端口转发访问其 Web 界面。

环境要求

• 远端 Linux 服务器（Ubuntu）
• 服务器具备外网访问能力，可下载 GitHub 与 npm 的安装包
• 本地通过 SSH 已连接到远端服务器，并使用 VS Code 进行远程开发

一、安装 Node.js（使用 nvm）

1. 安装 nvm

执行以下命令，从 GitHub 下载并运行 nvm 的安装脚本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

安装脚本会自动完成以下操作：

• 将 nvm 源码克隆到 /home/park/.nvm 目录
• 将 nvm 及相关 bash 补全的加载配置追加到 /home/park/.bashrc 文件

安装结束后，脚本会打印如下提示：需要关闭并重新打开终端以启用 nvm，或运行提示中给出的命令让 nvm 在当前会话中立即可用：

=> Close and reopen your terminal to start using nvm or run the following to use it now:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \\. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \\. "$NVM_DIR/bash_completion" # This loads nvm bash_completion

2. 安装指定版本的 Node.js

本例使用 Node.js 22.23.2 版本：

nvm install 22.23.2

安装成功后，nvm 会自动将 22.23.2 设为默认 alias，并输出当前使用的 Node 与 npm 版本：

Now using node v22.23.2 (npm v10.9.8)
Creating default alias: default -> 22.23.2 (-> v22.23.2)

3. 验证 Node.js 与 npm 版本

node -v
# v22.23.2

npm -v
# 10.9.8

二、安装 DeepSeek Harness

使用 npm 全局安装 DeepSeek Harness 的命令行工具 @deepseek-ai/dsh：

npm install -g @deepseek-ai/dsh

三、验证安装版本

dsh –version
# 0.1.1-rc.2

出现版本号即表示 DeepSeek Harness 已安装成功。

四、启动 Web 服务

在服务器上启动 DeepSeek Harness 的 Web 界面：

dsh web

服务启动后默认监听在 http://127.0.0.1:3080：

dsh web: http://127.0.0.1:3080

五、通过 VS Code 端口转发访问 Web 界面

由于服务只在服务器的本机回环地址（127.0.0.1）监听，远端浏览器无法直接访问。可通过 VS Code 的端口转发功能，将服务器的 3080 端口通过 SSH 加密隧道映射到本地，从而解决 crypto.randomUUID 不工作等与浏览器环境相关的问题。

1. 打开端口面板

在 VS Code 底部面板中找到 端口（Ports）标签页。如果找不到，可通过命令面板（Ctrl+Shift+P）输入并执行 Ports: Focus on Ports View 打开。

2. 添加转发规则

在端口面板中点击 Forward a Port 按钮，在输入框中填入远程服务器的端口号：3080，按回车确认。

VS Code 会自动将服务器的 3080 端口映射到本地同样的端口上。

3. 开始访问

在本地浏览器中打开 http://127.0.0.1:3080 即可使用。所有数据都会通过 SSH 加密隧道传输，既安全又能解决浏览器环境中 crypto.randomUUID 不工作的问题。