dshcloud Vibe 项目

项目简介

dshcloud 是一个完全开源的自托管平台，专注于为 DeepSeek Harness（以下简称 dsh）提供多用户、多实例的隔离运行环境。开发者 eskim2001 在频繁使用 dsh 的创造模式时，经常需要将 dsh 改造成不同用途的应用分享给朋友，由此萌生了将 dsh 云端化的想法——每个 Workspace 独立运行、数据持久化、互不干扰，通过浏览器即可从任意设备访问。dshcloud 采用容器化架构，将每个用户的工作空间封装为独立 Docker 容器，配合 Docker Compose 可在个人 VPS 或服务器上快速部署，目前处于早期开发阶段，适合技术用户评估与搭建私有 AI 工作站。

核心功能

1. Workspace 隔离管理 每个 Workspace 运行在独立 Docker 容器中，拥有独立的存储卷和资源配额，涵盖 CPU、内存、进程数和磁盘容量上限。用户可在管理界面自由创建、启动、停止、重建和删除 Workspace，单个账号可拥有多个独立空间，满足同时运行多个 dsh 改造版本的需求，数据文件、插件和会话记录在版本升级后完整保留。

2. 邀请制多用户体系 平台采用管理员邀请制，管理员生成邀请链接添加成员，无公开注册入口，从源头控制用户范围。每个用户只能查看和操作自己名下的 Workspace，无法访问他人空间，实现多租户隔离，避免数据泄露风险。

3. 四层访问安全控制 Workspace 的服务端口仅绑定宿主机回环地址（127.0.0.1），外部访问必须经过 Traefik 入口网关。流量需依次通过三项校验：归属认证、签名验证和认证服务校验，兼顾便捷性与安全性。

4. 零停机版本升级机制 从 GHCR 同步 dsh 版本目录，管理员可发布稳定版本并配置默认版本。用户升级时系统自动创建快照，升级失败可一键回滚，实现零停机更新。

5. 可视化控制台 管理界面提供账号状态总览、资源配额可视化、用量采样数据图、Workspace 日志实时流等功能，支持全局 Workspace 状态监控与用户配额管理。

6. 中英双语与主题切换 界面支持简体中文与 English 一键切换，提供浅色与深色两种主题模式，并内置 ⌘K 命令菜单方便键盘操作者快速导航。

技术实现

dshcloud 的后端架构围绕 Docker 和 Traefik 构建。底层存储层支持 XFS 文件系统 + pquota 或 Loopback 镜像两种配额模式，兼顾灵活性与生产级需求。容器编排采用 Docker Compose v2，所有服务（Web 控制台、认证服务、Traefik 网关、数据库）通过 Compose 网络互通，Workspace 容器由平台统一调度。

访问控制方面，Traefik 集成 forward-auth 中间件，每次外部请求先转发至平台认证服务进行归属校验，通过后签发临时凭证再路由至对应 Workspace 容器，支持 Let's Encrypt 自动 HTTPS。版本升级基于 Docker 卷快照实现一致性备份，升级失败自动从快照恢复。前端使用 Next.js 构建，支持 SSR 渲染和国际化配置，主题切换基于 CSS 变量实现热切换。

快速上手

第一步：准备服务器环境 准备一台 Linux 主机（x86-64 或 arm64），安装 Docker 和 Docker Compose v2，开放 80 和 443 端口，确保宿主机可配置磁盘配额（推荐 XFS + pquota，或由安装脚本自动创建 Loopback 镜像），确保可访问 GHCR。

第二步：一键部署 执行官方安装脚本： curl -fsSL https://raw.githubusercontent.com/eskim2001/dshcloud/main/scripts/install.sh | bash 脚本自动完成环境检测、目录创建、网络配置、数据库初始化并启动全部服务，安装完成后访问 https://console.你的域名 进入控制台。

第三步：邀请成员 首次登录后创建管理员账号，点击管理后台「用户管理」→「邀请」生成邀请链接，发送给团队成员。被邀请人通过链接注册后获得普通用户权限，可在配额范围内自主创建多个 Workspace。

第四步：创建 Workspace 登录控制台点击「新建 Workspace」，填写子域名前缀、选择 dsh 版本、设置资源配额，系统自动拉取镜像并初始化容器。完成后访问 https://子域名前缀.你的域名 即可进入 dsh 工作界面。

第五步：版本升级与回滚 在 Workspace 设置页面点击「版本升级」，系统自动执行快照；若升级后异常，点击「回滚到快照」即可在数秒内恢复，全程无需手动备份数据。

适用人群

dshcloud 面向以下用户：AI 开发者与研究者，需要频繁切换 dsh 版本、同时维护多个不同配置的实验环境；技术团队负责人，希望为团队成员提供隔离的 AI 工作站；独立开发者，需要将自己定制的 dsh 场景快速分享给非技术朋友或客户；以及隐私敏感用户，不愿将工作数据托管到第三方云服务，希望完全掌控自己的 AI 运行环境和数据资产。