部署与运行
前后端从克隆到上线的完整步骤，开箱即跑
| 类别 | 版本要求 | 说明 |
|---|---|---|
| JDK | 17+ | 后端运行环境 |
| Maven | 3.8+ | 后端构建工具 |
| MySQL | 8.0+ | 主数据库，多租户按 Schema 隔离 |
| Redis | 7.x | 缓存与分布式锁（Redisson） |
| Nacos | 2.x | 仅微服务模式需要（2.3.2 验证通过） |
| Node.js | 22.18+ / 24.x | 前端构建环境 |
| pnpm | 11+ | 前端包管理（corepack enable 自动启用） |
| Docker | 最新版 | 可选，容器化一键部署 |
第一步 · 初始化数据库
# 克隆仓库后，在 MySQL 中执行：
CREATE DATABASE bytech_platform DEFAULT CHARACTER SET utf8mb4;
CREATE DATABASE bytech_system DEFAULT CHARACTER SET utf8mb4;
# 导入表结构（sql/ 目录）
source sql/bytech_platform.sql;
source sql/bytech_system.sql;第二步 · 单体模式（推荐快速体验）
# 打包单体启动模块
mvn clean package -pl bytech-boot -DskipTests
# 一键启动（聚合全部模块，无需 Nacos）
java -jar bytech-boot/target/bytech-boot-exec.jar --spring.profiles.active=monolith第三步（可选）· 微服务模式
# 1. 先启动 Nacos + Redis + MySQL，并导入 Nacos 配置（nacos-configs/dev/ 目录）
# 2. 依次启动各服务（gateway → auth → system → platform → file → ai → job → monitor）
mvn spring-boot:run -pl bytech-gateway -Dspring.profiles.active=dev
mvn spring-boot:run -pl bytech-auth -Dspring.profiles.active=dev
mvn spring-boot:run -pl bytech-modules/bytech-system -Dspring.profiles.active=dev
mvn spring-boot:run -pl bytech-modules/bytech-platform -Dspring.profiles.active=dev
mvn spring-boot:run -pl bytech-modules/bytech-file -Dspring.profiles.active=dev
mvn spring-boot:run -pl bytech-modules/bytech-ai -Dspring.profiles.active=dev
mvn spring-boot:run -pl bytech-modules/bytech-job -Dspring.profiles.active=dev
mvn spring-boot:run -pl bytech-monitor -Dspring.profiles.active=dev启动完成后访问
http://localhost:8080，默认账号 admin / admin123。安装依赖与本地开发
# 进入前端目录（基于 Vben Admin 5.x monorepo，Vue 3 + Vite + TypeScript）
cd bytech-cloud/bytech-ui
# 启用 corepack 自动使用项目指定的 pnpm 版本（需 Node.js 22.18+ / 24.x）
corepack enable
# 安装依赖
pnpm install
# 本地开发（交互式选择要启动的子应用）
pnpm dev生产打包
# 打包全部应用（产物在各 apps/*/dist 目录）
pnpm build
# 或仅打包指定应用
pnpm run build:ele打包产出的
dist 可直接放入 Nginx 托管，或交由 docker-bytech/copy.sh 一键复制进 Docker 部署目录；接口地址在后端 .env / Nginx 反代中配置。容器化一键部署
# 1. 项目根目录打包所有模块
mvn clean package -DskipTests
# 2. 进入 docker 目录，准备部署产物
cd docker-bytech
cp .env.example .env # 修改 MySQL / Redis 密码等变量
./copy.sh # 一键复制 jar / SQL / 前端 dist
# 3. 构建镜像
docker compose build
# 4. 启动（二选一）
docker compose --profile monolith up -d # 单体模式 → http://localhost:8080
docker compose --profile microservices up -d # 微服务模式 → http://localhost:81常用运维命令
docker compose --profile monolith logs -f bytech-boot # 查看单体日志
docker compose --profile microservices ps # 查看微服务状态
docker compose --profile monolith down # 停止（保留数据卷）
docker compose --profile monolith down -v # 停止并删除数据卷两种模式对比
| 模式 | Profile | 启动内容 | 依赖 | 访问入口 |
|---|---|---|---|---|
| 单体 | monolith | bytech-boot + MySQL + Redis | 无需 Nacos | localhost:8080 |
| 微服务 | microservices | gateway / auth / system / platform / file / ai / job / monitor + xxl-job-admin + Nacos + Nginx | 需 Nacos | localhost:81 |
默认账号均为
admin / admin123，登录后请及时修改密码；端口、JVM 内存均可在 .env 中按服务器配置调整。技术交流群
部署问题、功能建议、版本更新，都在群里第一时间同步
技术交流 1 群
群号：1127999128
人气最旺
技术交流 2 群
群号：1127999128
1 群满员请加
技术交流 3 群
群号：1127999128
2 群满员请加
更多细节请查阅 Gitee 仓库文档（含十余篇设计文档）