dsh-vps

dsh-vps

把 DeepSeek Harness 装进你的 VPS：一条命令，公网可达，界面原样

Your DeepSeek Harness on your own VPS — one command, reachable from anywhere, native UI intact

简体中文 · English

---

> 这是 DSH 的 VPS 部署工具：把带登录界面的原版 DSH 装到你自己的 VPS 上，之后在任何地方用浏览器访问。 两种装法任选其一：

① 在自己电脑上的 DSH 里填表安装：插件市场搜索 dsh-vps 安装（或执行 dsh plugin add dsh-vps），打开「设置 → VPS 部署」，填服务器 IP、SSH 端口、用户名，选登录方式（密码 / 私钥 / 本机密钥），有域名再填域名，点「安装到这台 VPS」。

② 在 VPS 上执行一键安装命令：

curl -fsSL https://raw.githubusercontent.com/AIcivilization/dsh-vps/main/install.sh | sudo bash -s

有域名、在国内网络时，在末尾追加参数，例如 bash -s -- --domain dsh.example.com --mirror cn，详见下方[安装](#安装)。

---

简介

[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）默认只认本机浏览器：它的特权接口（设置、API Key、插件管理）受浏览器信任围栏保护，直接反代到公网后这些页面全部失效。

dsh-vps 用一个零运行时依赖的登录网关（dsh-gate）架在 DSH 前面：公网请求先过 scrypt 登录门，再由网关以服务端身份完成 DSH 会话认证并透传。你在任何地方打开浏览器，用的都是官方原版的 DSH Web 界面，设置、模型、API Key、插件市场该有的都有。

DeepSeek Harness (DSH) trusts the operator's own browser only: its privileged interfaces — settings, API keys, plugin management — sit behind a browser-trust fence, and a plain reverse proxy to the public internet leaves those pages dead.

dsh-vps puts a zero-dependency login gateway (dsh-gate) in front of DSH: public requests pass a scrypt login gate first, then the gateway performs DSH session authentication server-side and proxies the rest. You open a browser anywhere and get the stock DSH web interface — settings, models, API keys and the plugin marketplace all working.

---

能力一览

| 能力 | 说明 |

| --- | --- |

| 两种装法 | 在自己电脑上的 DSH 里填表、点一下安装（Mac / Windows / Linux）；或在 VPS 上执行一条 curl \| bash。装完即 systemd 托管、开机自启 |

| 登录门 | scrypt 口令 + HMAC 会话 Cookie + 登录限流；「保持登录」默认勾选，30 天内免登录；「设置 → VPS 部署 → 本机状态」里可修改密码（需当前密码，改后其他设备自动退出） |

| 添加到手机桌面 | 「设置 → VPS 部署 → 本机状态」里扫码，在手机上把 DSH 当作应用添加到主屏幕，全屏打开、像原生应用一样使用 |

| 浏览器初始向导 | 管理员账号、域名、DeepSeek API Key、预置插件，全程在浏览器里填完 |

| 中英双语 | 登录页、初始向导、启动等待页按浏览器语言显示中文或英文，右上角可手动切换并记住；DSH 内的「VPS 部署」页与升级提示条跟随 DSH 的语言设置 |

| 一次性启动令牌 | 向导只对持有令牌的人开放，链接随安装输出，dsh-vps setup-url 可重取，设置完成即作废 |

| 预置插件一键装 | 向导内置 3 款：本产品的设置页 dsh-vps（必装），以及插件市场与 VPS 管理（默认勾选、可取消）；后台装完自动重启生效 |

| 自动 HTTPS | Caddy 自动签发并续期证书；向导里改域名即时热加载 |

| 公网可用的原生设置页 | 设置、模型、API Key、权限策略在公网域名下照常读写 |

| 插件市场可用 | 市场里浏览/安装插件，点「立即重启」直接生效 |

| 会话自愈 | DSH 首启与插件安装需要几十秒，页面自动等待，就绪后自动进入 |

| 跟随官方一键升级 | DSH 出新版本时页面提示，在「设置 → VPS 部署」里点一下升级；升级走备份 → 自检 → 失败自动回滚，也可随时手动回滚 |

| 可观测与可恢复 | 本机 /gate/health 直接给出崩溃原因与连续崩溃次数；dsh-vps backup 保留最近 3 份 |

| 收紧的暴露面 | 会话 Cookie 恒为 Secure/HttpOnly/SameSite；诊断接口只对服务器本机与已登录会话开放；服务以无特权的 dsh 用户运行并受 systemd 沙箱约束 |

---

截图

展开查看 12 张原图（DSH 里的「VPS 部署」页 → 安装 → 向导 → 设置完成 → 登录 → DSH 界面 → 设置 → 插件市场）

| 在 DSH 里填表安装到 VPS | 从 VPS 卸载 | VPS 上的「本机状态」 |

| :---: | :---: | :---: |

| | | |

| 安装完成 | 初始设置向导 | 向导已填写 |

| :---: | :---: | :---: |

| | | |

| 设置完成 | 登录门 | 登录 |

| :---: | :---: | :---: |

| | | |

| DSH 原生界面 | 设置（公网域名下可用） | 插件市场 |

| :---: | :---: | :---: |

| | | |

---

环境要求

• Ubuntu 22.04+ / Debian 12+（root）
• 2C2G 以上，端口 80/443 开放
• 有域名即可自动 HTTPS（先把 A 记录解析到本机）；暂无域名也能先用公网 IP + 自签证书

---

安装

方式一：在自己电脑上的 DSH 里填表安装

Mac、Windows、Linux 上的 DSH 都可以：

1. 在 DSH 里装上插件 dsh-vps：插件市场搜索安装，或执行 dsh plugin add dsh-vps

2. 打开「设置 → VPS 部署」，填服务器 IP、SSH 端口、用户名，选登录方式；有域名（A 记录已解析到服务器）再填上域名，服务器在国内就勾上「服务器在国内」