安装概览
📘 概述
CSGHUB 是一体化 AI 研发与协作平台，支持从 模型管理 → 推理 → 微调 → 应用部署 的全流程。
为了满足不同规模与场景的部署需求，CSGHUB 提供多种安装方式：
| 部署方式 | 适用场景 | 部署复杂度 | 特点 |
|---|---|---|---|
| Helm Chart（推荐） | 生产环境 / 云原生部署 | ⭐⭐⭐⭐ | 云原生高可用，支持多节点与自动扩缩容 |
| Docker Compose | 测试、开发、单机环境 | ⭐⭐⭐ | 快速启动，轻量易用 |
🧱 组件结构
CSGHUB 包含多个核心组件与可选模块：
| 模块名称 | 类型 | 主要职责说明 |
|---|---|---|
| accounting | 核心服务 | 用户计费、算力与配额统计模块 |
| casdoor | 认证服务 | 用户登录与身份认证中心（OAuth / OIDC） |
| dataviewer | 应用服务 | 提供数据集浏览与可视化功能 |
| gitaly | 存储服务 | Git 仓库后端服务（代码与模型版本存储） |
| gitlab_shell | 辅助服务 | Git SSH 访问层，用于推送 / 拉取代码 |
| loki | 日志服务 | 集中式日志收集与查询 |
| minio | 存储服务 | 对象存储服务（模型文件、数据集、Artifacts） |
| mirror_lfs | 同步服务 | 负责 LFS（大文件）镜像同步管理 |
| mirror_repo | 同步服务 | 负责仓库镜像与远程同步 |
| nats | 消息中间件 | 事件驱动通信与异步任务消息总线 |
| nginx | 入口代理 | Web 流量与反向代理入口 |
| notification | 消息服务 | 系统通知与异步消息派发中心 |
| portal | 前端门户 | 用户交互界面（Web 控制台） |
| postgresql | 数据库 | 核心业务数据库（存储模型、用户、任务等） |
| prometheus | 监控服务 | 系统与组件性能指标采集 |
| redis | 缓存服务 | 会话缓存与消息队列缓存 |
| registry | 镜像仓库 | 存储容器镜像与模型镜像（支持 OCI） |
| rproxy | 内部代理 | 内部请求路由与统一访问代理 |
| server | 核心后端 | CSGHUB 主服务，负责调度、API、任务控制 |
| temporal | 工作流服务 | 分布式任务编排与工作流管理引擎 |
| temporal_ui | 管理控制台 | Temporal 工作流 Web 管理界面 |
| temporal_worker | 后台执行器 | 任务执行与异步流程运行节点 |
| user | 用户服务 | 用户信息、组织、权限与团队管理 |
| csgship | 编码助手后端服务 | 为 IDE 侧 CodeSouler 提供后端服务 |
🧩 结构分层
| 层级 | 组件示例 | 功能 |
|---|---|---|
| 入口层（Gateway） | nginx, rproxy | 对外访问、流量分发、反向代理 |
| 核心业务层（Core Services） | server, portal, user, accounting, notification, dataviewer | 提供主要平台功能 |
| 存储与依赖层（Storage & Infra） | postgresql, redis, minio, registry, gitaly, gitlab-shell, casdoor | 数据持久化与对象管理 |
| 任务与异步层（Workflow & Queue） | temporal, temporal_worker, nats, mirror_* | 工作流与消息调度 |
| 辅助与扩展层（Auxiliary） | loki, prometheus, temporal_ui | 认证、日志、可视化与同步功能 |
| AI 应用辅助 | csgship | 为 CodeSouler 提供后端服务 |
⚙️ 环境要求
✅ 硬件要求（最小 / 推荐）
| 资源类型 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU / 内存 | 4 cores / 8GB | 8 cores / 16GB |
| 存储空间 | 50 GB | 200 GB+ |
| 架构 | AMD64 / ARM64 | 支持 x86 与 ARM 架构 |
✅ 软件要求
| 组件 | 版本要求 |
|---|---|
| Docker Engine | ≥ 20.10 |
| Docker Compose | ≥ 2.0 |
| Kubernetes（可选） | ≥ 1.28 |
| Helm | ≥ 3.12 |
🧩 安装路径选择指南
🪄 1️⃣ 快速体验（推荐新用户）
适合快速启动 Demo 环境或功能验证
- 安装方式：Docker Compose
- 启动时间：≈ 2 分钟
- 特点：单容器部署，一键启动
- 缺点：
- 不包含 runner 服务，需要单独配置（依赖 Kubernetes 集群）
- 不包含 dataflow 服务，需要单独配置（提供 docker compose / helm chart 两种方式）
☁️ 2️⃣ 标准部署（生产推荐）
适用于生产集群、企业级部署
-
安装方式：Helm Chart
-
特点：
- 支持多节点与 HA
- 可接入外置数据库、Redis、对象存储
- 兼容云厂商（阿里云、腾讯云、AWS 等）
- 支持多节点与 HA
🌍 外置资源配置
生产环境推荐使用 外部托管资源（数据库、缓存、对象存储），以提升性能与稳定性。
| 资源类型 | 推荐方案 |
|---|---|
| PostgreSQL | 阿里云 RDS / AWS RDS / Cloud SQL |
| Redis | 阿里云 Redis / AWS ElastiCache |
| 对象存储 | 阿里云 OSS / AWS S3 / MinIO 外部集群 |
| Registry | 企业私有镜像仓库（Harbor / GitLab Registry） |
💬 支持与反馈
- 官方网站：https://opencsg.com
- GitHub Issues：https://github.com/OpenCSGs/csghub-charts/issues