Linux 安装 DeepSeek Harness 指南
七个步骤，从裸终端到能用的本地控制台——Windows 用户走 WSL 路线也能到同一终点。
最近更新: 2026-10-15
Linux 是 Harness 的主场：npx 运行时、本地服务、浏览器控制台，全都和官方 README 描述的一致。整个安装只有一条命令，任何装得上 Node.js 22 的发行版都能跑。
下面每张截图都来自一次真实的安装实测（来源见页尾），终端流程另行对照了 Ubuntu 实机安装视频核实。做完最后一步，控制台就会跑在 127.0.0.1:3080，并且已接好一个可用的模型服务商。
七步在 Linux 上装好 DeepSeek Harness
- 1
先装 Node.js 22 或更高版本
Harness 是 Node.js 应用，运行时先到位。Debian/Ubuntu 用户照 nodejs.org 给的 NodeSource 一行命令装，然后用 node -v 确认。实测视频也是先查版本：22 及以上就可以。
$node -v
Node.js 官网为 Debian/Ubuntu 准备了一行式安装命令——这就是 Harness 需要的全部运行时。看视频第 1:03 - 2
从 README 复制运行命令
GitHub README 写了两条路。你要的是 Run from npm 下的一行命令：npx @deepseek-ai/dsh web。Run from source（git clone、pnpm install、pnpm build）留给想改 Harness 本体的开发者。README 还标注了 --no-open 参数——只起服务不开浏览器，SSH 场景很好用。
一条命令直接跑，一条路径克隆源码——README 把两种方式都写在明面上。看视频第 0:48 - 3
在终端运行，等首次构建
把命令粘进终端回车，npm 会问 "Ok to proceed?"，输入 y。首次运行要下载依赖并构建两三分钟，然后输出 dsh web: http://127.0.0.1:3080，并自动打开默认浏览器。之后再启动就快了，构建产物已经就位。
$npx @deepseek-ai/dsh web - 4
接受通告，DeepSeek key 可以先不填
首次启动会弹 Internal Testing Notice——Harness 还是开发者预览版，点 Continue 即可。接着它问你要 DeepSeek API key，点 Configure later 完全没问题：官方 key 以后从 Settings → Models 填，或者直接接其他服务商。
官方 DeepSeek key 填在这里——现在填或以后再来都行。看视频第 2:48 - 5
给 Harness 指定一个工作区文件夹
第一次输入提示词之前，打开 Choose workspace → Add workspace，选一个目录。Ubuntu 实测视频的建议是新建一个专用文件夹，别把整个 Downloads 交出去——Harness 会往这个文件夹里写文件，权限之后也能在 Settings 里调。
第一句提示词之前，Harness 会先问你在哪里干活——给它一个专属文件夹。看视频第 2:15
手边是 Windows？在 WSL2 里跑 dsh
不用另找机器：Windows Subsystem for Linux 能跑一个真正的 Ubuntu 环境，里面的安装命令和原生 Linux 一字不差。三条命令，Windows 电脑就能到同一个控制台。
- 8
用一条命令装好 WSL + Ubuntu
在管理员 PowerShell 里运行下面这条命令，Windows 会装好 WSL 和 Ubuntu 发行版。装完重启，Ubuntu 让你建一个 Linux 用户名和密码——从这一步起，所有命令都跑在真正的 Linux 里。
$wsl --install -d Ubuntu - 9
在 Ubuntu 里装 Node.js
进入 Ubuntu 终端，用 nodejs.org 给 Debian/Ubuntu 的同一套 NodeSource 命令。下面三条命令装好 Node.js 22 并验证——你的 Windows 机器从此有一个真正的 Linux 运行时。
$curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -$sudo apt-get install -y nodejs$node -v - 10
跑和任何 Linux 一样的命令
WSL 里的安装命令和原生 Linux 一字不差。控制台跑在 http://127.0.0.1:3080，WSL2 的 localhost 转发让 Windows 浏览器直接打开——之后本站其他教程对你同样适用。
$npx @deepseek-ai/dsh web
动手前先知道一条边界：官方桌面端面向原生 macOS 和 Windows，不支持运行在 WSL 里的 harness（讨论 #8371）。在 WSL 里就老老实实用上面的 CLI / Web UI 路线——控制台照样出现在 Windows 浏览器的 127.0.0.1:3080。
Linux 桌面客户端怎么选
先把事实说清楚：dsh 桌面应用没有官方 Linux 版——官方客户端只出 macOS 和 Windows，这个缺口用户一直在上游追问（讨论帖 #8296「Why not support GNU/Linux desktop client」）。本页教的命令行安装在哪儿都一样，所以「桌面」问题其实是「要不要用社区客户端、用哪个」。
整个梯队断层领先的头部：约 5 MB 的 Tauri 桌面版，零环境配置、自带预设插件，Windows、macOS、Linux 三平台都有包。
GitHubCodePilot 风格的桌面客户端加插件套件，覆盖 macOS、Windows、Linux——更像是完整驾驶舱，不是套壳。
GitHub加固过的 Electron 壳：在本地启动捆绑的 @deepseek-ai/dsh Web UI 并装进自己的窗口——活动部件最少的选项。
GitHub三者均为社区维护项目，与 DeepSeek 无隶属或背书关系。星数为 2026-09-29 经 GitHub API 核实的当日快照，每天都会变；装任何桌面客户端前请先校验下载文件的校验和。
「不用桌面客户端」也完全成立：浏览器里的 Web UI 就是官方界面，Linux 桌面、服务器、口袋里的手机，它都一样好使。
Linux 上安装 DeepSeek Harness：常见问题
Linux 用户在敲安装命令之前最常问的几个问题。
Ubuntu 和 WSL，该怎么选？
有 Linux 机器或双系统就用原生 Ubuntu，性能最好；日常主力是 Windows 的话，WSL2 路线完全够用，命令和本页完全一致，控制台照样在 Windows 浏览器里打开。两边装的都是同一个 Node.js 22+ 运行时，之后随时可以迁移。
在 Linux 上用必须填 DeepSeek API key 吗？
不用。首次启动会问，Configure later 可以跳过。之后在 Settings → Models 里随时填官方 DeepSeek key，或者接入 GLM、OpenRouter、Anthropic、OpenAI、本地 Ollama。
Linux 上安装要多久？
首次 npx 运行要下载依赖并构建两三分钟（两支实测视频都差不多）。之后再启动很快，包已经缓存。
Linux 安装和 macOS、Windows 有区别吗？
命令完全一样，区别只在你在哪里敲它：Linux 和 Mac 都在终端里，Windows 用 PowerShell。WSL 则把这条缝隙彻底抹平——Windows 电脑跑在 Ubuntu 里的 Harness 表现和原生 Linux 一样。
装完之后控制台在哪？
Harness 的 Web UI 跑在 http://127.0.0.1:3080，并自动用默认浏览器打开。加 --no-open 可以跳过开浏览器（SSH 远程时好用），之后手动输入地址即可。
装完之后怎么更新？
重新运行 npx @deepseek-ai/dsh web 就能拉到最新版；开发者预览版官方明说会有破坏性变更——我们的更新指南整理了经过核实的升级流程。
Linux 上安装卡住或很慢，怎么解决？
和所有平台一样：慢不等于失败。首次运行要下载完整的 dsh 包，讨论区记录过静默 8 分钟以上的首跑。先等一等；想看到进度，把安装指向 npmmirror 镜像（npm install -g --registry=https://registry.npmmirror.com @deepseek-ai/dsh），并用 npx --verbose @deepseek-ai/dsh web 启动，让日志显示每一次抓取。明确的红色报错才是真正的失败信号。
为什么插件装上的版本比刚发布的旧？
官方讨论 #9178 定位到 pnpm 11 的新行为：minimumReleaseAge 默认 24 小时，当天发布的版本会被隐藏，解析器静默回退到旧版本——旧版本随后还可能被判不兼容。装明确版本（package@version），或者确实要追新就调整 minimumReleaseAge。
有官方的 Linux 桌面客户端吗？
还没有——但 CLI 不用等它。官方桌面应用只发 Windows 和 macOS 版；Linux 上受支持的路线就是本页教程（终端里跑 harness，自带浏览器界面），外加上面列的社区客户端。请求官方推出 AppImage / deb / rpm 安装包、并适配银河麒麟、统信 UOS 等信创桌面环境的请愿已在案：discussion #9659（2 个赞，2026-10-14）。官方包出现之前，请把第三方桌面打包当社区项目对待，装什么先验证。
linux 安装 dsh 用哪条命令？需要 sudo 吗？
一条命令、不用 root：npx @deepseek-ai/dsh web（第 3 步）。它把 harness 下载进当前用户的 npm 缓存，在 http://127.0.0.1:3080 起浏览器界面——sudo 从头到尾都不参与。本指南里唯一带提权的一行，是 Debian/Ubuntu 上可选的 NodeSource 源配置（装 Node.js 本身）。哪个教程让你用 root 跑 harness，那个教程就没走官方路线。
相关教程
Linux 环境跑起来之后，接下来看什么。
来源与署名
截图全部来自 Md Al Mamun 的纯净录屏；Linux 终端流程另行对照 Programador Novato 的 Ubuntu 原生安装视频核实。每张图都深链回源视频的对应时间点。