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 情境很好用。
一條指令直接跑，一條路徑 clone 原始碼——README 把兩種方式都寫在明面上。看影片第 0:48 - 3
在終端機執行，等首次建置
把指令貼進終端機按 Enter，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 原生安裝影片查證。每張圖都連回來源影片的對應時間點。