单机部署与 docker-compose 部署

想在单台机器/本地把平台跑起来(生产或开发调试)时,先读这篇选子文档

02-部署安装 / 部署方式 / 单机与docker-compose
单机部署docker-compose本地部署本地开发本地调试k8s单机rancherstart.shistio-ingressgateway域名访问nginx代理https前端构建镜像升级

单机部署与 docker-compose 部署

本目录覆盖在“单台机器 / 本地”把 CubeStudio 跑起来的两条路径:

  1. 单机 k8s 部署(生产形态):在机器上起一个 k8s 集群(不熟 k8s 可用 rancher),再用 start.sh 把平台部署到 k8s 上。这种方式能跑真实的 pipeline / notebook / 推理任务。
  2. docker-compose 本地部署(开发 / 体验形态):只起前端、后端、mysql、redis 四个容器,适合二次开发调试与功能体验;真实任务调度仍需连接一个 k8s 集群。

部署前请先确认机器规格、操作系统、k8s 版本等前置要求:部署总览与前置要求

子文档目录(TOC)

文档 内容
01-单机k8s部署.md 单机 / 已有 k8s / 隔离内网 三类场景;start.sh 部署;非 80 端口、域名访问、内外网 IP、nginx 反向代理、HTTPS、内网穿透;部署后排查清单
02-docker-compose本地部署.md 本地机器环境准备(win/mac/linux);docker-compose 起前后端 + mysql + redis;镜像构建与拉取;连接远端 k8s 与 minio
03-本地开发与调试.md PC 非 docker(conda + IDE 断点)调试;前端(frontend / vision / visionPlus)本机开发与容器内编译;前后端镜像升级;常见问题 Q&A

选哪条路径

  • 只想看看平台长什么样、改后端代码做二次开发 → 走 02 / 03(docker-compose)。
  • 要在机器上真正部署一套能调度任务的平台 → 走 01(单机 k8s 部署)。

镜像名 / 端口 / 环境变量等以源码(install/docker/install/kubernetes/)为准,本目录文档仅供导航与上手。

最后更新 2026-07-04完整文档以官方仓库为准:GitHub Wiki