dsh-vps

dsh plugin --profile web add dsh-vps

<div align="center">

<img src="assets/logo.png" width="128" alt="dsh-vps 标志">

dsh-vps

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

<p><strong>Your DeepSeek Harness on your own VPS — one command, reachable from anywhere, native UI intact</strong></p>

<p>

<a href="LICENSE"><img src="https://img.shields.io/github/license/AIcivilization/dsh-vps" alt="MIT 许可证"></a>

<a href="https://www.npmjs.com/package/dsh-vps"><img src="https://img.shields.io/npm/v/dsh-vps" alt="npm 版本"></a>

<img src="https://img.shields.io/badge/platform-Ubuntu%2022.04%2B%20%2F%20Debian%2012%2B-blue" alt="平台：Ubuntu 22.04+ / Debian 12+">

<img src="https://img.shields.io/badge/DeepSeek%20Harness-%E5%AE%98%E6%96%B9%E6%9C%80%E6%96%B0%E7%89%88-4176E6" alt="DeepSeek Harness 官方最新版">

<img src="https://img.shields.io/badge/runtime%20dependencies-0-brightgreen" alt="运行时依赖：0">

<img src="https://img.shields.io/badge/Docker-not%20required-orange" alt="无需 Docker">

<img src="https://img.shields.io/github/stars/AIcivilization/dsh-vps?style=social" alt="star">

<a href="https://awesome-dsh-plugin.com/p/AIcivilization/dsh-vps/"><img src="https://img.shields.io/badge/Listed_on-awesome--dsh--plugin-1677ff?style=flat-square" alt="已收录于 awesome-dsh-plugin"></a>

<a href="https://dshget.com/plugins/AIcivilization/dsh-vps"><img src="https://img.shields.io/badge/Listed_on-DSH_Get-1677ff?style=flat-square" alt="已收录于 DSH Get"></a>

</p>

<p><strong>简体中文</strong> · <a href="README.en.md">English</a></p>

</div>

---

这是 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（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 沙箱约束

---

截图

<p align="center">

<img src="docs/demo.gif" alt="全流程演示：安装 → 设置向导 → 登录 → DSH 界面 → 插件市场" width="1000">

</p>

<details>

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

<br>

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

 ·  · 

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

 ·  · 

设置完成 · 登录门 · 登录

 ·  · 

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

 ·  · 

</details>

---

环境要求

• 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 记录已解析到服务器）再填上域名，服务器在国内就勾上「服务器在国内」

3. 点「安装到这台 VPS」

• 登录方式三选一：密码；私钥（粘贴或选择云厂商给的 .pem / 自己的 id_ed25519，可带口令）；本机密钥（一键生成专用密钥，复制公钥或那行命令到云厂商控制台的网页终端执行一次，~/.ssh 里已有的密钥也会一并尝试）。服务器关掉了密码登录（重装系统后常见）时用后两种
• 密码、私钥只用这一次，不保存；本机密钥的私钥只留在这台电脑上
• 页面实时显示安装日志，完成后直接给出设置向导的链接
• 安装在服务器上后台运行，中途关掉页面或网络断开都不影响
• 需要本机有 OpenSSH 客户端：Mac、Linux 自带；Windows 10/11 在「设置 → 系统 → 可选功能」里添加「OpenSSH 客户端」

方式二：在 VPS 上执行一键安装命令

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

国内网络加 --mirror cn（Node 与 DSH 走 npmmirror）：

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

还没有域名？去掉 --domain 即可，按公网 IP 访问：

curl -fsSL ht

…(truncated)