SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

DeepSeek Harness VPS 私有部署與 SSH tunnel 設定

在 Linux VPS 安裝 DeepSeek Harness,固定 npm 版本,了解 plugin 權限與風險,並透過 SSH tunnel 安全存取 port 3080 web UI,避免公開 agent。

DeepSeek Harness 是什麼

DeepSeek Harness(dsh)是可在 VPS(虛擬專用伺服器)上執行的 Node.js agent runtime。安全的執行方式,是將它綁定至 127.0.0.1,再讓瀏覽器透過 SSH(安全殼層)tunnel 連線。它會在 3080 埠提供 web UI(使用者介面),不必在 terminal 中操作。在本指南鎖定的 0.1.0-rc.6 release 中,該 web server 不會自行要求密碼。因此,公開 3080 埠後,任何找到它的人都能取得一個 agent,並以你的 Linux 使用者身分讀取檔案及執行命令。較新的 release 為 0.2.0-rc.2 至 0.2.2-rc.2,也就是截至 2026 年 11 月 12 日 GitHub 列出的最新 release,啟動時會輸出一個帶有該程序新 token 的 URL,並將其替換為 session cookie。但這些版本預設仍只監聽 loopback,也仍拒絕綁定所有介面。

DeepSeek 以 MIT 授權條款發布此專案,npm package 為 @deepseek-ai/dsh。專案將自身描述為 developer preview,並明確表示預期會有破壞相容性的變更。下方鎖定的版本是 2026 年 8 月的 release。2026 年 11 月 12 日,npm 的 latest tag 指向 0.2.2-rc.1。GitHub 列出的較新 prerelease 為 0.2.2-rc.2,tag 為 dsh-v0.2.2-rc.2,於 2026 年 11 月 11 日發布。將任何內容複製到重要主機前,請先檢查 repository。

整個設計都圍繞著一個概念:所有元件都是 plugin。model adapter、tool registry、session log、sandbox、scheduler 以及 agent loop 本身,都是載入同一個 shared context 的 plugin,任何一項都可以替換。這裡沒有由 plugin 只負責擴充功能的特權核心。這使 harness 值得嘗試,也正是唯一真正的風險所在。這項取捨是否適合,取決於你拿它與什麼比較;比較它與 Claude Code 和 Omnigent 的表現會將這種一切皆為 plugin 的設計,與另外兩種在 model coupling、授權條款及各自需要多少 VPS 資源方面的方案並列比較。

Harness 不是模型

Harness 負責執行代理程式迴圈。推理是在其他地方的模型中進行,因此在提供 API(application programming interface)金鑰或自行託管的模型端點位址之前,任何功能都無法運作。本文所有內容都是 harness 設定,而不是模型行為;在花一個下午排查問題來源之前,先釐清兩者之間的界線會比較有效率。

請在 UI 中依序開啟 Settings 和 Models 進行設定。DeepSeek 有自己的卡片;在目前版本中,卡片下方的「Add model provider」按鈕會開啟兩種模式。「Third-party model provider」涵蓋 harness 已提供目錄的供應商,例如 OpenAI 和 Anthropic。您只要貼上金鑰,目錄就會提供端點和模型清單。「Custom model API」則是較有用的選項:它需要小寫的 provider ID、顯示名稱、base URL、API 通訊協定、認證資訊,以及至少一個模型。通訊協定選擇器提供 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini API,因此您可以設定使用其中一種通訊協定的 gateway 或本機伺服器;若端點的 request 格式不同,則需要相容性設定。自訂供應商也可以查詢 OpenAI-compatible GET /models 端點,自動填入模型清單。

這就是將 harness 指向同一台 VPS 上模型的方法。Ollama 會在 http://127.0.0.1:11434/v1/ 提供 OpenAI-compatible API,而 API key 欄位可填入任意字串,通常使用 ollama,因為 OpenAI-style client 要求必須有值,而 Ollama 會忽略該值。Ollama 官方文件也說明了 ollama launch dsh;如果 @deepseek-ai/dsh 尚未安裝,該指令會先安裝,然後使用 Ollama 模型啟動它。因此,在依賴下方的 pin 之前,請先確認它安裝的版本。能在 VPS 上運作的小型模型是否足以驅動代理程式,是更難回答的問題;Ollama 與 vLLM 作為本機模型伺服器的差異,會決定這個答案需要消耗多少 RAM。

在 UI 中輸入的金鑰只能寫入,無法讀回。Harness 會將金鑰儲存在 $DSH_HOME/.credentials.yaml,而設定中只保留認證資訊參照;目前版本會將該參照寫入使用中 profile 的 patch 檔案 $DSH_HOME/profiles/<profile>/cordis.patch.yml(profile 為 web,用於 dsh web)。$DSH_HOME 預設為 ~/.dsh。請將認證資訊檔案視為密碼檔案,因為它確實是密碼檔案:任何能讀取該檔案的人,都可以使用您的 API 額度。如果您想直接編輯這些檔案,而不是透過 Settings 操作,dsh 設定檔、金鑰與模型端點操作說明會說明每個金鑰的用途,以及各模式下哪些內容會離開您的主機。

安裝前的準備事項

  • 執行 Ubuntu 24.04 或其他目前版本 Linux 的 VPS,並具備 SSH 存取權限
  • Node.js 24.9 或更新版本,因為專案的主要分支與 0.2.2-alpha.2 現在都宣告需要 >=24.9.0,其 CI 會測試 Node 24,並對 Node 24.9 和 Node 26 進行相容性檢查,且不再設定 Node 22 的工作;截至 0.2.1-rc.4 的標記版本仍將 Node 22.19 列為可接受版本,但這已不再是專案建置所依據的最低版本
  • 一般使用者帳戶,而非 root,因為 agent 會以啟動程序的使用者身分執行 shell 命令
  • 若計畫安裝 plugins,請確保 pnpm 位於 PATH 中,因為 plugin 命令會透過 shell 呼叫它
  • 在防火牆及供應商獨立的網路防火牆上關閉連接埠 3080

Ubuntu 24.04 內建的 nodejs 套件版本早於 harness 所需版本,因此在該版本上,請改用 NodeSource 或 nvm 安裝 Node,不要使用 apt install nodejs。Ubuntu 26.10 的官方套件庫列出 Node 24.19.0,已高於 Node 24.9 的最低要求。如果 VPS 是全新建立的,先強化 SSH,再進行其他設定 值得花十分鐘處理,因為你即將依賴的 tunnel,其安全性取決於後端 SSH 伺服器。

在 VPS 上安裝 DeepSeek Harness,固定使用單一版本

node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 web

npx 會下載套件並執行其中的 dsh 二進位檔。web 是 --profile web 的別名,會啟動瀏覽器應用程式,而該程序會輸出其監聽中的位址。預設值為 http://127.0.0.1:3080。這些數值是繫結設定,不是僅供美觀的預設值;dsh 為何輸出迴路位址 說明了在你從筆記型電腦尋找它之前,該 harness 會回應以及不會回應哪些內容。

固定版本。除非執行所在的專案已經安裝一份副本,否則 npx @deepseek-ai/dsh web 會解析你執行指令當下 latest 標籤所指向的版本;若已有副本,npx 會靜默使用該副本。無論哪種情況,版本都不是由你選擇,而該專案已經發布數個 release candidate,並表示即將進行破壞性變更。0.1.0-rc.6 是此處固定使用的 August 2026 版本。在 12 November 2026,latest 指向 0.2.2-rc.1;這個版本會輸出包含 token 的啟動 URL。GitHub 列出較新的 prerelease 0.2.2-rc.2,因此改用其他版本時,應先閱讀該 repository,再刻意進行升級。固定版本表示今天設定的主機下個月仍會以相同方式運作,升級會成為你主動做出的決定,而不是事後才發現的意外。若固定版本的指令仍啟動錯誤的 build,或完全無法安裝,請參閱常見的 dsh 安裝與版本錯誤,瞭解如何清除 npx cache,以及確認 Node 隨附的 npm 版本。

日常使用時,請先安裝一次,不要在每次啟動時重新解析版本。

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

第二行值得執行,因為 launcher 與 web app 使用不同的 flag 集合。dsh --help 會顯示 launcher 自身的選項。dsh --profile web --help 會顯示 web application 接受的 flags;--port、--host 以及可重複指定的 --trusted-host 都在其中。

現在確認它監聽的位址。

ss -tlnp | grep 3080

本機位址欄應顯示 127.0.0.1:3080。若顯示 0.0.0.0:3080,表示 UI 正在所有介面上監聽,因此它與網際網路之間只剩防火牆提供隔離;在進行其他操作前,應先停止該程序。

為何絕對不能公開發布連接埠 3080

0.1.0-rc.6 中的 Web 伺服器沒有驗證層。其設定只公開監聽主機與監聽連接埠,這就是全部的暴露面。對非迴路部署而言,存取控制是另一項受信任主機設定,不是登入畫面。

較新的版本加入了驗證機制。從 0.2.0-rc.2 起,啟動時會輸出一個包含該程序新 token 的 URL;開啟該 URL 的瀏覽器會收到簽署的工作階段 cookie,並在移除 token 後重新導向至相同位址。位於 /api 前方的 Host/Origin 過濾機制只接受迴路位址、監聽器自身的繫結位址,以及你透過 --trusted-host 指定的主機。這是真正的憑證,但專案文件也警告,輸出的 URL 是只能提供給預定使用者的憑證,而純 HTTP 會在未加密的情況下傳送它。從 0.2.1-alpha.2 起,Web 應用程式也能繫結至一個特定的本機位址,並透過 --tls-cert 與 --tls-key 直接提供 HTTPS。這能解決明文傳輸問題,但無法解決暴露問題。它會提高濫用公開連接埠的難度,但不代表你可以發布該連接埠。

接著考慮該連接埠後方的功能。代理程式會編輯工作區中的檔案並執行 shell 命令,而你的提供者憑證也會與它一同儲存在磁碟上。因此,在固定的版本中,開放連接埠 3080 等同於一個具備聊天介面的遠端 shell;它以啟動程序的使用者身分執行,並附帶你的 API key。這不需要任何 exploit。攻擊者只需要連接埠號碼。若是具備啟動 token 的版本,攻擊者還需要 token;但任何能讀取你的終端機、服務日誌或未加密網路流量的人,都已經可以取得它。

CLI(命令列介面)也反映了這項限制。截至 0.1.0-rc.6,它刻意不支援 --host 0.0.0.0,而是顯示使用方式錯誤後結束,不會啟動;較新的 0.2.2-alpha.2 仍會在啟動時拒絕該選項。這項拒絕是安全功能,因此不要試圖尋找移除它的修補程式。

隧道不適用時,還有另外兩種合理的部署方式。將該主機置於私有 overlay network,讓它只取得自有裝置能路由到的位址;自行代管 Headscale 控制伺服器即可提供這種方式。或者,在前方放置 reverse proxy,在請求抵達連接埠 3080 前先完成驗證,例如使用 Authentik 單一登入伺服器執行 forward auth。前方沒有驗證機制的 reverse proxy 不是安全控制措施,只是較長的 URL。

透過 SSH tunnel 存取 web UI

請在 laptop 上執行,不要在 server 上執行。

ssh -N -L 3080:127.0.0.1:3080 you@your-server

-L 會在 laptop 上開啟 3080 埠,並透過加密的 SSH session 轉送所有連入該埠的連線。127.0.0.1:3080 部分會在 server 上解析,因此連線會從 loopback 抵達 harness,效果就像您直接坐在該機器前操作。-N 表示不要啟動 remote shell,因為您只需要 port forwarding,不需要其他功能。

接著在本機瀏覽器中開啟 http://127.0.0.1:3080。如果使用支援 launch token 的 release,請改為開啟 server 顯示的完整 startup URL,並保留 token;harness 透過 SSH 啟動時仍會顯示 startup line,但不會代您開啟瀏覽器。如果 laptop 上的 3080 埠已被使用,請修改左側的數字:ssh -N -L 3180:127.0.0.1:3080 you@your-server,然後瀏覽 http://127.0.0.1:3180;若 URL 包含 token,也要用相同方式修改其中的 port。左側數字是本機使用的 port,右側數字屬於 server,因此只需修改左側數字。

請將它儲存在 ~/.ssh/config 中,之後不要再手動輸入。

Host dsh
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  LocalForward 3080 127.0.0.1:3080

完成後,ssh -N dsh 會啟動 tunnel。瀏覽器顯示 connection refused,通常表示 tunnel 已建立,但遠端沒有程式在監聽,因為 SSH 不論 harness 是否執行,都會轉送該 port。請使用上方的 ss command 檢查 server。

在登出後讓 harness 持續執行

npx 指令會隨著 shell 結束。systemd user service 可以持續執行,並在 harness 當機或重新開機後將其重新啟動。此處的 unit 刻意保持精簡;如果您希望 harness 使用獨立且受限的帳號執行,在 unit 中固定版本,並產生可實際搜尋的日誌,dsh 的無頭 systemd 設定會完整說明相關作法。

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger 很重要,因為 user service 通常會在最後一個工作階段結束時停止。因此,如果沒有設定它,關閉 tunnel 的瞬間 harness 就會停止。將 command -v dsh 輸出的絕對路徑填入 unit,因為 systemd 不會搜尋登入 shell 建立的 PATH。

[Unit]
Description=DeepSeek Harness web UI
After=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

WorkingDirectory 並非裝飾性設定。dsh 程序會將啟動時所在的目錄作為預設檔案系統位置,因此 service 若在錯誤的位置啟動,agent 就會指向錯誤的資料夾。不過,該目錄只是一項預設值:新的 Web UI 在您於 Choose workspace 下新增工作區前,不會選取任何 workspace,而專案指南要求您新增啟動 dsh 時所在的目錄。指南沒有版本標記,且 0.1.0-rc.7 中已經有相同文字,因此固定版本也應會顯示這項說明。將 unit 的目錄設為專案目錄,然後在 UI 中選取該 workspace。

systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dsh

拒絕啟動的 unit 幾乎總是使用了錯誤的 ExecStart 路徑,或二進位檔不接受目前的 Node 版本;journalctl --user -u dsh -n 50 會指出其中是哪一項。在包含 launch token 的版本中,journal 也是顯示含 token 啟動 URL 的位置,而且每次重新啟動都會產生新的 URL。相同模式也適用於讓 VPS 上的任何 coding agent 持續執行,而失敗原因也相同。

允許插件執行的操作

插件是可在共用內容中提供服務、具型別事件與可逆效果的模組。以下擴充點值得仔細閱讀:

  • 在 ctx.llm 註冊模型提供者
  • 在 ctx.tools 新增供模型使用的工具
  • 提供 ctx.shell 背後的 shell 後端
  • 在 ctx.fs 提供檔案系統存取或政策
  • 在 ctx.commands 註冊使用者命令
  • 透過 ctx.jobs 執行背景工作
  • 使用 ctx.sandbox 後端包裝產生的程序
  • 透過 agent/* 和 tools/* 事件攔截請求與工具呼叫
  • 擴充持久化的工作階段狀態
  • 透過 ctx.agents 驅動 UI

請用攻擊者的角度閱讀這份清單。插件可以提供檔案系統層與 shell 層,也可以介入模型發出的每次工具呼叫。插件與這些介面之間沒有權限確認對話框,因為插件只是載入至相同程序中的一般 Node 程式碼。安裝插件等於以 agent 的權限執行陌生人的程式碼,而 agent 的權限就是 Unix 使用者的權限。

這與將 MCP 伺服器連接至 VPS 上的 agent 時所做的信任決策相同,其中 MCP 是模型內容協定。這也是為什麼在 VPS 上安全地執行 coding agent時,應先確認它所使用的帳號,而不是先處理模型;同樣也說明了npm 供應鏈攻擊為何會對伺服器造成嚴重影響:安裝步驟就是遭到入侵的時點,而且不會出現任何提示。

插件的來源

插件位於 profile 中。profile 是儲存在 $DSH_HOME 下的具名組合,預設為 ~/.dsh。每個 profile 目錄都會保存其安裝的 out-of-tree 插件。CLI 會將你的引數直接轉送給 pnpm,並以 profile 目錄作為工作目錄。

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

由於引數會原封不動傳給 pnpm,因此 add、remove、update 和 why 的行為與任何 pnpm 專案相同。插件可以是 npm 套件,也可以是 GitHub 參照。pnpm 必須先存在於 PATH 中。在 Node 24 上,corepack enable pnpm 會將它放入 PATH。Node 25 已停止隨附 Corepack,因此在 Node 25 和更新版本上,請改用 npm install -g pnpm 安裝。

插件的探索透過 GitHub topic 運作。插件作者會將 dsh-plugin topic 加到自己的 repository,瀏覽該 topic 即可尋找現有插件。topic 是作者套用至自己 repository 的標籤。沒有人審查或簽署這些標籤,而 topic 頁面會依 stars 排序;stars 反映的是熱門程度,不是安全性。

目前的 release 也包含實驗性的 Custom plugin indexes bundle。前往 Plugins 啟用後,Discover 分頁會讓你新增 index。index 是從你提供的 URL 擷取的 JSON 檔案。此 harness 不提供自己的 index,只會檢查檔案格式,不會驗證市集宣稱的標題、作者或來源;若 index 透過純 http: 提供,網路路徑上的任何人都能改寫它。市集是他人撰寫的目錄,不是審查結果。

四個習慣可以讓管理維持在可控範圍內。安裝前先閱讀原始碼,因為大多數插件都小到能在十分鐘內讀完。固定使用確切版本或 commit,不要追蹤 branch。在你願意重建的 VPS 上,以不擁有其他資源的使用者執行 harness。為 agent 提供專用 API key,並設定獨立的支出上限,與 production 服務使用的 key 分開。當你開始閱讀插件,想知道哪些檔案承載風險時,dsh 插件的審查流程會依序說明 manifest、entry point,以及插件註冊的 extension point。

如果你想先比較設計再決定採用哪一種,Omnigent multi-agent harness 以不同結構處理相同問題。插件開始運作後,各項取捨會變得明顯。如果你最後決定在同一台主機上保留兩或三個 harness,而不是選出唯一方案,將所有 harness 放在一個自架 API 後方可以省去每個連接埠各自建立 tunnel 的需求,但代價是多一個必須繫結至 loopback,並在第一天就設定真正密碼的服務。

最先出問題的項目

Node 版本太舊。 專案的主要分支與 0.2.2-alpha.2 需要 Node 24.9 或更新版本,而其 CI 會測試 Node 24,並在 Node 24.9 與 Node 26 上執行相容性檢查;Node 22 則沒有測試。直到 0.2.1-rc.4 為止的較舊標記版本仍將 Node 22.19 列為可接受版本,但專案已不再針對該版本建置。較舊的執行環境會在啟動時失敗,因為程式碼使用了該環境不支援的語法與 API。請先執行 node --version。

連接埠 3080 已被占用。 可能是第二個 harness、殘留程序,或其他同樣使用 3080 的應用程式。使用 ss -tlnp | grep 3080 找出占用者,然後停止它,或使用 dsh web --port 3180 在其他位置啟動 harness。--port 屬於 Web 應用程式,因此要放在 web 之後。

瀏覽器無法透過 tunnel 連線。 確認你瀏覽的是 127.0.0.1,而不是伺服器的公開位址,因為轉送的連接埠只存在於你的筆電上。接著確認伺服器上的 harness 正在監聽,因為 SSH 不論遠端是否有服務回應,都會建立轉送。

dsh plugin 立即失敗。 此命令是 pnpm 的 wrapper,因此找不到 pnpm binary 時,會在任何 plugin 工作開始前停止。Node 25 及更新版本預設會是這種狀態,因為 Node 不再隨附 Corepack。

agent 看不到你的專案。 新建立的 Web UI 在你新增 workspace 前不會選取任何 workspace,session composer 也會保持無法使用。程序只會將啟動時所在的目錄作為預設檔案系統位置,因此若 unit 的 WorkingDirectory 是你的家目錄,agent 就會以你的家目錄作為目標位置。請在 UI 中選取 workspace,或修正 unit 後重新載入。

FAQ

將 DeepSeek Harness Web UI 暴露在連接埠 3080 上是否安全?

不安全。在固定的 0.1.0-rc.6 中,Web 伺服器沒有自己的登入機制,後方的代理程式會以啟動程序之使用者身分編輯檔案並執行 shell 命令,而 provider API key 也儲存在同一個磁碟上。從 0.2.0-rc.2 開始,包括 0.2.2-rc.1、npm 在 12 November 2026 發布的 latest,以及較新的 0.2.2-rc.2 預發布版本,啟動時顯示的 URL 都會帶有啟動 token,瀏覽器會以此換取工作階段 cookie;但該 URL 是憑證,透過未加密的 HTTP 傳送,因此建議不變。讓 listener 保持在 127.0.0.1,並透過 SSH tunnel 存取。也可以使用私有 overlay network,或讓 reverse proxy 在請求到達該連接埠前先驗證每一個請求。截至 version 0.1.0-rc.6,CLI 會拒絕 --host 0.0.0.0 並以使用方式錯誤結束,0.2.2-alpha.2 也仍會拒絕該參數。這反映了作者對此作法的看法。

我需要 DeepSeek API key,還是可以使用本機模型?

兩者皆可,因為 harness 是 runtime,不是模型。在 Settings 中進入 Models,即可將 key 貼到 DeepSeek card 或 catalog provider;也可以選擇 "Add model provider",再選擇 "Custom model API",並提供支援 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 或 Gemini API 的 base URL。本機 Ollama 伺服器會在 http://127.0.0.1:11434/v1/ 回應,API key 欄位則可接受任意字串。Key 會儲存在 $DSH_HOME/.credentials.yaml,預設值為 ~/.dsh/.credentials.yaml。

安裝 DeepSeek Harness plugin 後,plugin 實際取得了什麼?

執行 harness 的帳號所具備的權限。Plugin 是載入同一個程序的 Node 程式碼,而 extension point 包括 shell backend、filesystem layer、tool registry,以及包裝每次 tool call 的事件。除非 plugin 自行提供 sandbox,否則沒有任何機制能讓 plugin 與這些介面隔離。安裝前請先閱讀原始碼,並以不擁有任何重要資料的使用者執行 harness。

我應該安裝哪個版本?它會持續正常運作嗎?

請安裝精確版本,例如 npx @deepseek-ai/dsh@0.1.0-rc.6 web。這是本文固定使用的 August 2026 版本。在 12 November 2026,npm 的 latest tag 指向 0.2.2-rc.1;GitHub 列出的較新預發布版本是 0.2.2-rc.2,於 11 November 發布,而目前的 CLI 需要 Node 24.9 或更新版本。此專案將自身定位為 developer preview,並表示預期會有破壞相容性的變更,因此未固定版本的命令可能每天都有不同的行為。升級前請檢查 repository,並預期在版本仍以 0 開頭期間,config key 與 plugin interface 可能會變動。

這篇文章對您有幫助嗎?