前言¶
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
