DSH(DeepSeek Harness)的理念是“一切皆插件”。當需要將本地文件系統或工作區共享給其他設備時,@weibaohui/dsh-webdav-server 是一個實用的解決方案。該插件將一個共享目錄變成 WebDAV 服務器,使其可以被 Windows、macOS、Linux 以及 iOS 的“文件”應用掛載爲本地磁盤。
核心功能¶
- 多平臺掛載:提供標準的 WebDAV 接口,支持 Windows、macOS、Linux 以及 iOS/iPadOS 原生文件應用直接掛載。
- 獨立服務:擁有獨立的監聽端口(默認 19087)和認證機制,與 DSH 網頁界面及其他插件完全隔離。
- 雙重認證模式:支持“獨立令牌”和“複用 user-management 賬號”兩種認證方式。
- 只讀與軟鏈接:支持開啓只讀模式,並支持跟隨軟鏈接。
- 熱更新:配置變更(如端口、令牌、根目錄)後,插件每 3 秒比對指紋自動重建監聽器,無需重啓 DSH。
- 可視化配置:共享根目錄、監聽地址、端口、令牌等均在設置頁可視化配置,並內置三平臺掛載指南。
安裝與啓用¶
安裝該插件後,重啓 DSH 即可使用。
dsh plugin add github:weibaohui/dsh-webdav-server
安裝完成後,進入 設置 → WebDAV 服務器 頁面。
基本用法¶
- 在設置頁確認服務運行中(默認已啓用)。
- 複製設置頁裏的局域網地址(默認
http://<你的IP>:19087/)和訪問令牌。 - 在另一臺電腦或設備上,按照設置頁提供的“掛載指南”進行連接:
- 用戶名:任意填寫(如
dsh)。 - 密碼:填入上述複製的訪問令牌。
- 用戶名:任意填寫(如
認證模式¶
該插件提供兩種認證模式,可在設置頁一鍵切換:
- 獨立令牌(默認):用戶名任意,密碼固定爲訪問令牌。零依賴,開箱即用。首次啓動自動生成,可隨時在設置頁重新生成。
- user-management 賬號:複用
user-management插件的登錄用戶名和密碼。- 注意:開啓兩步驗證(TOTP)的賬號無法掛載(Basic 認證不支持動態碼);被禁用的賬號拒絕掛載;密碼修改後,已驗證的舊憑據最多再有效 5 分鐘。
平臺掛載指南¶
設置頁內置了針對主流系統的掛載步驟,地址和憑據會自動代入。
macOS¶
在 Finder 中按 ⌘K(前往 → 連接服務器),輸入 http://<ip>:19087/,連接後用戶名任意,密碼填令牌。或使用終端執行 open http://<ip>:19087/ 直接喚起連接窗口。
Windows¶
- 打開文件資源管理器,點擊“映射網絡驅動器”,文件夾填
http://<ip>:19087/,勾選“使用其他憑據”,用戶名任意,密碼填令牌。 - 若 Win11 23H2+ 映射無反應,需以管理員身份執行以下命令啓用 WebClient 服務:
sc config WebClient start= auto && net start WebClient
- 若使用 HTTP 明文連接,需修改註冊表
HKLM\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel爲2(DWORD)並重啓服務;若大文件拷貝失敗,需修改FileSizeLimitInBytes爲4294967295。
Linux¶
使用 davfs2 掛載:
sudo apt install davfs2
sudo mkdir -p /mnt/dsh
sudo mount -t davfs http://<ip>:19087/ /mnt/dsh
# 用戶名任意,密碼 = 令牌
免交互配置:將 http://<ip>:19087/ dsh <令牌> 寫入 /etc/davfs2/secrets,並設置權限 chmod 600。
iOS / iPadOS¶
直接打開“文件”App,點擊右上角“連接服務器”,輸入地址和令牌即可。
配置與持久化¶
配置數據存儲在宿主服務的 ~/.dsh/settings.yaml 的 dsh-webdav-server 節下。插件默認共享根目錄爲 ~/.dsh/dsh-webdav-server/share,目錄不存在時會自動創建。
注意事項¶
- 安全風險:根目錄指向哪裏,掛載者就能讀寫到哪裏。建議不要將整個
HOME目錄指出去,公開目錄建議開啓只讀模式。 - 依賴檢查:若使用
user-management模式,該插件未安裝或用戶庫損壞時會自動回退到令牌認證。 - 兼容性:大文件傳輸可能受限於系統或客戶端配置。
生態位置¶
該插件屬於 DSH 插件生態的一部分,由社區維護。更多細節可查看 GitHub 倉庫。