Ubuntu + DeepSeek Harness 远程开发环境搭建教程

写在前面

本文记录在 Windows 环境下通过 SSH 远程连接 Ubuntu 虚拟机，安装 DSH 远程开发插件并启动 DeepSeek Harness 的完整过程。适合刚开始接触远程开发、希望把开发环境从本地扩展到虚拟机的读者。

整个流程分为五步：安装 SSH、远程访问 SSH、安装 DSH 插件、启动 DeepSeek Harness 和配置远程开发。下面按顺序逐步说明。

1 安装 SSH

第一步，在 Ubuntu 虚拟机中安装并启动 SSH 服务，这样 Windows 主机才能通过 SSH 协议远程连接虚拟机。

# 1. 安装并启动 SSH 服务
sudo apt update
sudo apt install -y openssh-server
sudo systemctl enable ssh
sudo systemctl start ssh
2. 查看虚拟机 IP
ip addr show

安装完成后，执行 ip addr show 查看虚拟机 IP 地址，记下该地址，下一步远程连接时会用到。

2 远程访问 SSH

拿到虚拟机 IP 后，在 Windows 终端中通过 SSH 命令连接 Ubuntu。命令格式为 ssh 用户名@虚拟机IP，把“虚拟机IP”替换成第 1 步查询到的地址即可。

ssh 用户名@虚拟机IP
ssh fmsh@192.168.16.157

示例中连接的是用户 fmsh 位于 192.168.16.157 的虚拟机，实际使用时请替换为自己的用户名和 IP。

3 安装 DSH 插件

成功通过 SSH 连接 Ubuntu 后，下一步安装 DSH 远程开发插件，让 DeepSeek Harness 能够通过 SSH 指挥远程 Ubuntu 上的工具执行任务。

3.1 安装插件

dsh plugin add --profile web github:CJYLZS/dsh-remote-development

如果出现下面错误，表示 git 拉取失败，打开 VPN 后重试即可。

3.2 换用 -w 参数安装

如果解决 VPN 问题后仍然报错，可以更换安装命令，在末尾添加 -w 参数：

dsh plugin add --profile web github:CJYLZS/dsh-remote-development -w

3.3 验证安装结果

安装完成后，查看插件列表确认是否安装成功：

dsh plugin --profile web list

3.4 常见问题

1. DSH 插件的作用是什么？

DSH 就像一个项目经理（AI），它有一支施工队（工具集：读文件、写文件、跑命令）。

• 没有插件：施工队只在 Windows 本地干活。你虽然能打电话给 Ubuntu（SSH），但项目经理没法直接指挥那支队伍去 Ubuntu 干活。
• 安装插件：相当于给施工队配了远程遥控设备。项目经理一声令下，队伍就通过 SSH 跑到 Ubuntu 上干活，干完把结果带回来。

2. DSH 会影响 Windows 系统运行吗？

不会影响 Windows 系统的正常运行，也不会对后续在 Windows 上使用 DeepSeek Harness 造成任何负面影响。

4 启动 DeepSeek Harness

插件安装完成后，执行以下命令启动 DeepSeek Harness：

dsh web

如果当前环境是全局安装的 DSH，后续需要安装或更新时，可以使用以下全局安装命令：

npm install -g @deepseek-ai/dsh

5 配置远程开发

启动 DeepSeek Harness 后，在界面中完成远程开发配置，将 Ubuntu 虚拟机和项目工作区关联起来。

添加远程开发：

添加工作区：

6 小结

本文按照「安装 SSH → 远程访问 SSH → 安装 DSH 插件 → 启动 DeepSeek Harness → 配置远程开发」的顺序，完整记录了从本地 Windows 到远程 Ubuntu 开发环境的搭建过程。如果安装插件时遇到 git 拉取错误，优先检查网络，必要时开启 VPN 或改用 -w 参数安装。完成以上配置后，DeepSeek Harness 就能通过 SSH 指挥远程 Ubuntu 上的工具执行任务，实现本地调度、远程执行。