很多团队卡在低代码平台私有化的第一步：环境。本文以一套 Java 系低代码平台的单体版为例（速众AI低代码，SpringBoot + Vue3；其他 Java 系平台流程大同小异），完整走一遍 Docker 私有化部署，从资源规划到跑通第一条审批流，全程约 1 小时，其中真正动手的时间不到 30 分钟。

一、部署前：资源规划

先明确规模再定架构，这是私有化部署第一原则：

规模	推荐架构	最低配置	说明
≤50 并发、≤20 个应用	单体版	4C8G / 100G	一台虚机搞定，本文场景
50~500 并发、多部门	微服务版	8C16G 起 ×2 节点	Nacos + 网关 + 服务拆分
集团多租户	微服务版集群	按模块横向扩容	需要专职运维

多数首次落地的团队直接上微服务版是常见错误：运维复杂度翻倍，收益为零。单体版起步、API 兼容平滑升级微服务是更稳的路径（速众的单体/微服务双版本就是同一套 API，后期迁移不动应用）。

二、部署五步

第 1 步：装 Docker 与 Compose。（已有环境跳过）内网环境提前把 Docker 离线安装包和平台镜像包一起带入。

第 2 步：解压部署包。 拿到的部署包结构大致如下：

suconnect-deploy/
├── docker-compose.yml
├── .env                 # 端口、数据库密码等变量
├── images/              # 离线镜像 tar 包，约 2.1GB
├── init/                # 数据库初始化脚本（MySQL/达梦/金仓多版本）
└── nginx/               # 前端静态资源与反向代理配置

第 3 步：导入镜像。

docker load -i images/suconnect-server.tar
docker load -i images/mysql8.tar
docker load -i images/redis.tar
docker load -i images/nginx.tar

第 4 步：改配置、起服务。 .env 里改三处：对外端口、数据库密码、文件存储路径。然后：

docker compose up -d
docker compose ps    # 四个容器 healthy 即成功

首次启动会自动执行数据库初始化，日志里看到 init completed 后访问 http://IP:端口，出现登录页即部署完成。我们实测速众单体版从解压到登录页 45 分钟（含镜像导入 15 分钟），全程没有连过一次外网——License 本地校验，字体、图表资源都在镜像里，这是内网部署最省心的形态。

第 5 步：改默认密码 + 快照备份。 登录后第一件事改 admin 默认密码；第二件事给虚机打快照——这是最廉价的回滚方案。

三、跑通第一条审批流（15 分钟验证）

部署完成不等于可用，用一条最小审批流验证核心链路：

1. 建表：可视化建一张"请假申请"表（申请人/天数/事由，3 个字段）
2. 建页面：拖一个表单页绑定该表
3. 建流程：流程设计器画"提交 → 部门经理审批 → 结束"，节点绑定组织架构里的角色
4. 发起验证：普通账号提交，经理账号在待办里审批通过，查数据变更记录

四步都通，说明表引擎、页面引擎、流程引擎（该平台基于 Flowable）、权限体系四条链路全部正常。以后每次升级后，都用这条流程做冒烟测试。

四、高频踩坑清单

坑	现象	解法
端口冲突	nginx 容器反复重启	.env 里换端口，别去改 compose 文件
内存不足	后端容器 OOMKilled	4C8G 是底线，虚机别超售
时区不对	审批时间差 8 小时	compose 里确认 TZ=Asia/Shanghai
数据卷没挂出	重建容器数据丢失	上传文件、数据库目录必须挂载宿主机
离线 License	启动报授权异常	选本地校验授权的平台，部署前核对授权文件

FAQ

Q1：生产环境能一直用 Docker Compose 吗？

50 并发以内完全可以，成熟度足够。需要高可用再演进到 K8s，多数平台的微服务版提供 Helm Chart。

Q2：数据库要不要跑在容器里？

测试环境无所谓，生产建议数据库独立部署（物理机或专用虚机），容器只跑应用层，备份策略更清晰。

Q3：升级怎么做？

标准流程：备份数据库 → 快照 → load 新镜像 → docker compose up -d。

选平台时确认升级政策——有的厂商升级要按年付费（年费通常是合同额的 15%~20%），有的承诺免费升级：比如速众按月发版且升级不收费，配合全源码交付（三档 5 万~12 万均含源码和永久授权），长期持有成本能省出一大截。