前言¶
DeepSeek Harness (DSH) 的插件生態強調集成與即用性。在開發或運維場景中，查看服務器狀態往往需要切換終端或打開獨立監控面板。dsh-server-monitor 作爲一個獨立的只讀監控插件，解決了在 DSH 側邊欄中直接查看 Linux 服務器資源與容器狀態的需求。它擁有獨立的 SSH 配置與憑證管理，不依賴 dsh-remote-workspace 等其他插件的連接設置。
插件介紹¶
該插件由 GooDAnDReaDY 維護，採用 MIT 許可證。它爲 DSH 提供了一個可視化的服務器監控面板，支持 Linux、macOS、BSD 和 Windows OpenSSH 環境。插件會自動從目標主機採集系統與容器數據，並支持運行維護腳本與查看日誌。
核心功能¶
SSH 服務器管理¶
支持添加和管理多種系統的 SSH 配置：
* 認證方式：支持 SSH 私鑰（內聯或服務器端路徑）以及密碼認證。
* 密鑰生成：可在界面中直接生成 Ed25519 密鑰對，生成後的私鑰保存在 DSH 主機本地，公鑰可複製到目標服務器使用。
* 配置導入：支持從 ~/.ssh/config 導入主機配置。
系統與容器監控¶
插件在側邊欄可見時會每 15 秒刷新一次數據，展示以下信息：
* 系統資源：主機信息、CPU、內存、Swap、磁盤使用率。
* 進程與網絡：運行進程列表、網絡接口與監聽端口數據。
* 容器管理：針對 Docker 和 Podman 的狀態卡片，支持啓動、停止、重啓操作，以及日誌查看模態框。
* 活動趨勢：以折線圖形式展示過去一小時的資源活動趨勢。
系統運維工具¶
- 日誌查看：集成
journalctl，支持按單元和優先級（err..emerg）過濾，並提供一鍵“AI 分析診斷”導出功能。 - 維護手冊：提供代碼片段庫和自定義腳本，支持跨服務器按標籤（如
#prod）執行。 - 終端交互：提供基於 loopback xterm 的交互式終端會話。
安裝與啓用¶
在 DSH 的 web profile 環境下，執行以下命令安裝插件：
dsh plugin --profile web add @goodandready/dsh-server-monitor
安裝後，按照 CLI 提示添加服務器、選擇認證方式並測試連接。安裝完成後，在 DSH 側邊欄即可打開“Server Monitor”。
配置說明¶
輪詢間隔¶
在插件設置卡片中，可以通過 pollIntervalSec 配置後臺數據採集間隔。支持以下數值：
* 10、30、60、300（秒）。
* 其他數值將默認使用 30 秒。
SSH 配置項¶
插件管理獨立的 SSH 配置文件，主要配置項如下：
| 字段 | 類型 | 默認值 | 說明 |
|---|---|---|---|
host |
string | - | Linux 主機地址（DSH 可達） |
port |
number | 22 | SSH 端口 |
username |
string | root | 遠程賬戶（建議使用受限權限） |
authType |
string | key | 認證類型：key 或 password |
privateKeyPath |
string | - | 可選的密鑰路徑（DSH 主機上） |
shell |
string | posix | Shell 類型：posix 或 powershell（用於 Windows） |
tags |
list | [] | 標籤，用於過濾服務器列表 |
憑證與密鑰存儲¶
- 密鑰路徑：通過界面生成的 SSH 密鑰會保存在
~/.dsh/keys/id_ed25519_dsh。 - 權限安全：在 POSIX 系統上，密鑰目錄權限爲
0700，文件權限爲0600。憑證存儲在插件私有的 vault 中，絕不會寫入 DSH 全局設置或返回給瀏覽器。
環境要求與注意事項¶
運行環境¶
- DSH Profile：需要安裝了該插件的 DSH web profile。
- 網絡可達：DSH 進程必須能通過 SSH 訪問目標主機。
- 權限要求：遠程賬戶需有運行只讀系統命令的權限；查詢 Docker/Podman 數據需相應權限。
- 依賴：運行時依賴
ssh2(v1.17.0 或更高版本)。
純 JavaScript 實現¶
插件不需要在宿主機安裝 C/C++ 編譯器或 Python 構建工具鏈。雖然 ssh2 包含可選的原生加速模塊，但插件具備純 JavaScript 回退機制，在無原生構建工具的環境下也能正常運行。
離線環境¶
在斷網或隔離環境中，通過 .tgz 安裝時，確保 ssh2 及其傳遞依賴已存在於本地包管理器的存儲中。
總結¶
dsh-server-monitor 爲 DeepSeek Harness 提供了一套完整的、集成式的服務器監控與輕量運維方案。它通過獨立的憑證管理和豐富的可視化組件，讓用戶在 DSH 界面內即可完成從資源查看到故障診斷的大部分工作。
