前言¶
DeepSeek Harness（DSH）默認只信任本機瀏覽器。它的特權接口（設置、API Key、插件管理）受瀏覽器信任圍欄保護。直接將 DSH 反代到公網後，這些頁面會全部失效。
dsh-vps 插件通過在 DSH 前面架設一個零運行時依賴的登錄網關（dsh-gate）解決這一問題。公網請求先通過 scrypt 登錄門，網關再以服務端身份完成 DSH 會話認證並透傳流量。部署完成後，你在任何地方打開瀏覽器，使用的都是官方原版的 DSH Web 界面，所有功能（設置、模型、API Key、插件市場）照常可用。
核心功能¶
- 雙模式部署：支持在 DSH 插件市場填表安裝，也支持在 VPS 上執行一鍵腳本安裝。
- 登錄與會話：採用 scrypt 口令與 HMAC 會話 Cookie。默認勾選“保持登錄”，支持 30 天內免登錄。
- 安全加固：會話 Cookie 恆爲 Secure/HttpOnly/SameSite；診斷接口僅對服務器本機與已登錄會話開放；服務以無特權的
dsh用戶運行。 - 公網訪問：通過 Caddy 自動 HTTPS 實現公網可用的原生設置頁。
- 可觀測與可恢復：提供
/gate/health接口查看崩潰原因；支持一鍵升級（帶自動備份與回滾）。 - 本地化體驗：支持中英雙語；支持手機添加到桌面；支持瀏覽器初始嚮導（管理員賬號、域名、API Key）。
安裝¶
環境要求¶
- 系統：Ubuntu 22.04+ / Debian 12+（需 root 權限）
- 資源：2C2G 以上
- 網絡：端口 80/443 需開放
安裝方式¶
方式一：在 DSH 中安裝¶
- 在 DSH 插件市場搜索
dsh-vps並執行安裝命令：dsh plugin add dsh-vps。 - 打開「設置 → VPS 部署」，填寫服務器 IP、SSH 端口、用戶名、密碼，如有域名一併填寫。
- 點擊「安裝到這臺 VPS」。安裝過程由後臺執行，頁面斷開不影響進度。
方式二：在 VPS 上執行腳本¶
在目標 VPS 上執行以下命令：
curl -fsSL https://raw.githubusercontent.com/AIcivilization/dsh-vps/main/install.sh | sudo bash -s
安裝完成後，系統會自動配置 systemd 託管、Caddy 自動 HTTPS 以及開機自啓。
使用與維護¶
獲取初始設置鏈接¶
安裝結束時會給出一條帶一次性令牌的設置鏈接。如果鏈接丟失，可在服務器上重新獲取：
sudo dsh-vps setup-url
升級與回滾¶
當 DeepSeek Harness 官方發佈新版本時，插件會提示升級。在「設置 → VPS 部署」中點擊「立即升級」即可。升級過程包含備份、自檢與自動回滾機制。
若需手動操作或回滾：
# 升級到本項目驗證過的版本
sudo dsh-vps upgrade
# 回滾到上一個版本
sudo dsh-vps rollback
結語¶
dsh-vps 是一個將 DeepSeek Harness 完整私有化部署的解決方案。它通過網關透傳與安全加固，在保留 DSH 原生界面的同時，實現了公網訪問與安全管理。
- 目錄頁：DSH Get - dsh-vps
- GitHub：AIcivilization/dsh-vps
