在本地開發或部署模型時,區分 Docker Desktop 和 WSL 引擎、確認 vLLM 容器是否正在運行且可訪問,通常需要手動檢查。DeepSeek Harness (DSH) 的 dsh-wsl-docker 插件提供了自動化診斷能力。
插件介紹¶
這是一個 DeepSeek Harness 插件,用於診斷 WSL 環境下的 Docker 上下文,並提供 vLLM 或 OpenAI :8000 容器相關的運行狀態提示。插件由用戶 173787247 維護,採用 MIT 許可證。
核心功能¶
插件主要提供 docker_doctor 工具,支持以下三個檢查重點:
- focus=all:檢查 Docker CLI 路徑、當前上下文、服務器版本以及 NVIDIA 運行時提示。
- focus=daemon:側重於 Docker 守護進程本身的配置與環境信息。
- focus=vllm:列出運行中的容器,並篩選出類似
OpenAI/:8000命名的容器。這有助於確認本地推理端口是否處於就緒狀態。
此外,插件建議在配置 DeepSeek Harness 的 baseURL 時,將此插件與 host_reach 服務配合使用。
安裝與啓用¶
插件包含在 KIT_SET=llm 和 full 配置集中,也可以單獨安裝。
- 執行安裝命令:
dsh plugin --profile web add github:173787247/dsh-wsl-docker
- 安裝完成後,重啓
dsh web服務,並打開一個新的會話。
典型用法¶
安裝成功後,可以在命令行或工具調用中使用 docker_doctor。
- 檢查整體環境:
docker_doctor focus=all
- 側重檢查守護進程:
docker_doctor focus=daemon
- 側重檢查 vLLM 相關容器:
docker_doctor focus=vllm
適用場景與注意事項¶
此插件適合在 WSL 環境下進行本地模型部署調試的開發者使用。
- 依賴要求:需要 DeepSeek Harness 版本 ≥ 0.1.2,以及 Node.js ≥ 18。
- 模型配置:雲端的 Flash 模型(如
deepseek-flash)應在~/.dsh/settings.yaml中配置,本插件不負責此配置。 - 上游依賴:
Agent Teams是上游實驗性功能,此插件不依賴它。
結語¶
通過 dsh-wsl-docker,開發者可以快速獲取 Docker 在 WSL 環境下的運行狀態,減少排查時間。完整的源碼與故障排查文檔可參考項目倉庫。