使用WSL的ubuntu虚拟机配置deepseek harness

1. 安装WSL

首先确保开启CPU虚拟化

打开Windows终端，安装WSL

wsl --install

wsl --install --web-download
#提高使用国内网络的下载速率

如果提示重启电脑才能继续，那就重启电脑

wsl默认安装ubuntu

安装好ubuntu后需要填写ubuntu用户名称和密码

看到命令行颜色变了表示进入到系统里了

WSL2为默认版本

wsl --set-default-version 2

可以查看WSL可以虚拟机情况

wsl -l

2. 安装Node.js

# 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 代替重启 shell
\. "$HOME/.nvm/nvm.sh"

# 下载并安装 Node.js：
nvm install 24

# 验证 Node.js 版本：
node -v # Should print "v24.19.0".

# 验证 npm 版本：
npm -v # Should print "11.17.0".

3. 安装C++ 编译工具，避免node-pty编译失败

DeepSeek Harness 依赖 node-pty 原生模块，安装时需要编译 C++ 代码。如果缺少 make、g++ 等工具，会直接报错

sudo apt update
sudo apt install build-essential

4. 安装deepseek harness

全局安装

npm install -g @deepseek-ai/dsh

如果遇到了 allow-scripts 警告，因为 npm 默认阻止了依赖包中的安装脚本（如 node-pty 的编译脚本），导致安装不完整，可以执行以下命令

npm install -g --allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs @deepseek-ai/dsh

验证安装

dsh --version

5. 启动web服务

普通用户下直接运行

dsh web

终端显示 dsh web: http://127.0.0.1:3080。在 Windows 宿主机浏览器访问该地址，即可打开 Harness 界面，首次使用需配置 API Key。

拓展：root 用户也能使用 dsh

查找普通用户的 npm 全局路径

npm config get prefix
# 输出类似 /home/your-username/.nvm/versions/node/v24.19.0

将 bin 目录添加到 root 的 PATH

su root   # 输入 root 密码（如未设置，先用 sudo passwd root 设置）
echo 'export PATH=/home/your-username/.nvm/versions/node/v24.19.0/bin:$PATH' >> /root/.bashrc
source /root/.bashrc

验证并启动

dsh --version   # 成功
dsh web         # 以 root 身份启动，监听 3080

注意：root 用户的数据目录为 /root/.dsh，与普通用户的 /home/your-username/.dsh 隔离。如需共用配置，可复制或软链接

​