敲敲云零代码平台本地化部署指南：从环境准备到生产上线

学习目标

• 理解两种部署方案的适用场景与技术差异
• 掌握传统部署与容器化部署的完整实施流程
• 学会诊断部署过程中的常见问题
• 了解系统优化的基本策略与安全加固方法

问题引入：企业级零代码平台的本地化困境

在数字化转型过程中，许多企业面临一个共同挑战：如何快速部署功能完善的业务系统，同时确保数据安全与定制化需求？云端SaaS平台虽然便捷，但在数据隐私、定制深度和系统集成方面往往存在局限。敲敲云作为一款开源零代码平台，提供了本地化部署的可能性，让企业可以在自己的服务器环境中搭建专属应用平台。

您是否遇到过以下情况：

• 尝试使用低代码平台却受限于云端服务的功能限制？
• 担心核心业务数据存储在第三方服务器的安全风险？
• 需要根据企业特殊流程定制系统却缺乏技术能力？

本文将通过两种截然不同的部署方案，带您一步步完成敲敲云平台的本地化搭建，无论您是技术新手还是有经验的开发者，都能找到适合自己的实施路径。

方案选型：哪种部署方式更适合您的团队？

传统本地部署 📦

核心特点：直接在物理服务器或虚拟机上安装配置所有依赖组件

技术参数卡片

• 技术门槛：中等（需了解JDK、数据库配置）
• 环境依赖：JDK7+、MySQL、Redis、Nginx
• 部署时间：15-20分钟
• 维护难度：中
• 资源占用：较高
• 灵活性：高（可深度定制）

Docker容器化部署 🐳

核心特点：通过容器打包所有依赖，实现环境一致性与快速交付

技术参数卡片

• 技术门槛：低（只需掌握基本Docker命令）
• 环境依赖：Docker Engine、Docker Compose
• 部署时间：5-10分钟
• 维护难度：低
• 资源占用：中
• 灵活性：中等（标准化配置）

适用场景决策树

flowchart TD
    A[开始部署] --> B{是否需要深度定制?};
    B -->|是| C[选择传统部署];
    B -->|否| D{是否关注环境一致性?};
    D -->|是| E[选择Docker部署];
    D -->|否| F{团队技术栈熟悉度?};
    F -->|Java/数据库| C;
    F -->|DevOps/容器技术| E;
    C --> G[开发/测试环境];
    E --> H[生产/协作环境];

💡 技术顾问提示：如果您的团队经常需要修改配置文件或定制系统功能，传统部署可能更适合；如果您追求快速上线和环境一致性，Docker方案将是更好的选择。

核心部署流程

方案A：传统本地部署（适合开发调试）

阶段一：环境准备（预计5分钟）

1.1 安装JDK环境

操作指令	预期结果
sudo apt update && sudo apt install openjdk-11-jdk -y	系统自动安装OpenJDK 11
java -version	终端显示openjdk version "11.0.x"

⚠️ 风险提示：确保系统没有安装多个JDK版本，可能导致环境变量冲突

1.2 部署MySQL数据库

# 安装MySQL 8.0
sudo apt install mysql-server -y

# 启动服务并设置开机自启
sudo systemctl enable --now mysql

# 创建数据库与用户
mysql -u root -p
CREATE DATABASE qiaoqiaoyun CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'qiaoqiaoyun'@'localhost' IDENTIFIED BY 'Qiaoqiaoyun@123';
GRANT ALL PRIVILEGES ON qiaoqiaoyun.* TO 'qiaoqiaoyun'@'localhost';
FLUSH PRIVILEGES;
exit

🔍 浮动注释：数据库字符集选择utf8mb4可以支持emoji表情和更多特殊字符，适合企业级应用需求

阶段二：项目配置（预计5分钟）

2.1 获取项目文件

# 安装Git LFS（处理大文件）
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
sudo apt install git-lfs -y
git lfs install

# 克隆仓库
git clone https://gitcode.com/jeecgboot/qiaoqiaoyun.git
cd qiaoqiaoyun

2.2 修改配置文件

使用文本编辑器打开config/application-prod.yml，修改以下配置段：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/qiaoqiaoyun?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
    username: qiaoqiaoyun
    password: Qiaoqiaoyun@123  # 替换为您设置的密码
  redis:
    host: localhost
    port: 6379
    password: ""  # 如未设置Redis密码保持为空

阶段三：系统启动（预计5分钟）

3.1 初始化数据库

# 执行SQL脚本初始化数据库
mysql -u qiaoqiaoyun -p qiaoqiaoyun < qiaoqiaoyun.sql

3.2 启动后端服务

# Linux系统
chmod +x start.sh && ./start.sh

# Windows系统
双击start.bat文件

3.3 配置Nginx前端

创建或修改Nginx配置文件：

server {
    listen 80;
    server_name localhost;
    root /path/to/qiaoqiaoyun/dist;  # 替换为实际路径
    index index.html;
    
    location / {
        try_files $uri $uri/ /index.html;
    }
    
    location /api {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

重启Nginx服务：sudo systemctl restart nginx

✅ 部署成功标志：后端启动日志显示"Started QiaoqiaoyunApplication"

方案B：Docker容器化部署（推荐生产环境）

阶段一：环境准备（预计3分钟）

1.1 安装Docker环境

操作指令	预期结果
curl -fsSL https://get.docker.com -o get-docker.sh	下载Docker安装脚本
sudo sh get-docker.sh	安装Docker引擎
sudo usermod -aG docker $USER	当前用户获得Docker管理权限
sudo apt install docker-compose-plugin -y	安装Docker Compose

⚠️ 风险提示：执行完usermod命令后需要注销并重新登录才能生效

1.2 验证Docker安装

docker --version       # 验证Docker引擎版本
docker compose version # 验证Docker Compose版本

💡 技术顾问提问：您的服务器是否需要通过代理访问互联网？如果是，需要额外配置Docker代理。

阶段二：自动化部署（预计5分钟）

2.1 获取项目代码

git clone https://gitcode.com/jeecgboot/qiaoqiaoyun.git
cd qiaoqiaoyun

2.2 配置环境变量（可选）

如果需要自定义端口或密码，可以编辑docker/.env文件：

MYSQL_PORT=3306
MYSQL_ROOT_PASSWORD=rootpassword
QIAOQIAOYUN_PORT=8080

2.3 启动服务集群

# 一键启动所有服务
docker compose -p qiaoqiaoyun_start up -d

# 查看服务状态
docker compose ps

✅ 部署成功标志：docker compose ps显示所有服务状态为"Up"

容器化架构解析

容器化部署就像快递打包，将应用及其所有依赖（数据库、缓存、前端等）分别打包成标准集装箱（容器），然后通过统一的调度系统（Docker Compose）协调运行。

flowchart TB
    subgraph 主机系统
        subgraph Docker引擎
            A[nginx容器<br>前端服务]
            B[javax容器<br>后端服务]
            C[mysql容器<br>关系型数据库]
            D[mongo容器<br>文档数据库]
        end
    end
    A <--> B
    B <--> C
    B <--> D
    A --> 外部用户

系统验证与优化

部署验证五步法

1. 服务状态检查

# 检查后端服务日志
docker logs -f qiaoqiaoyun_start_javax_1

# 检查前端响应
curl -I http://localhost

预期结果：日志显示服务启动成功，curl命令返回HTTP/1.1 200 OK

2. 登录验证

   • 访问地址: http://服务器IP或域名
   • 默认账号: admin/123456
   • 首次登录需修改密码（要求：8位以上含大小写字母+数字）

3. 功能测试

   • 创建应用：工作台 → 新建应用 → 空白应用
   • 设计表单：添加文本、数字、日期等字段
   • 提交测试数据并验证保存功能

4. AI功能验证

   • 进入"AI工作流"模块
   • 使用"智能表单生成"功能
   • 输入提示词生成测试表单

5. 性能监控

# 查看容器资源占用
docker stats

正常指标：CPU使用率<30%，内存占用<2GB

常见问题诊断

数据库连接失败

症状：后端服务启动失败，日志显示Could not create connection to database server

解决方案：

# 检查MySQL容器状态
docker exec -it qiaoqiaoyun_start_mysql_1 mysql -u root -p

# 验证数据库用户权限
SELECT user,host FROM mysql.user WHERE user='qiaoqiaoyun';

确保数据库用户具有正确的主机访问权限和数据库权限

前端页面空白

症状：访问页面显示空白，浏览器控制台报404错误

解决方案：

# 检查Nginx配置
docker exec -it qiaoqiaoyun_start_nginx_1 nginx -t

# 重启Nginx服务
docker compose restart nginx

确认Nginx配置中的前端文件路径是否正确映射

系统优化策略

新手优化 🌱

1. JVM内存调整 修改start.sh文件中的JVM参数：

   JAVA_OPTS="-Xms1024m -Xmx2048m -XX:+UseG1GC"
   

2. 数据库索引优化

   CREATE INDEX idx_application_create_time ON application(create_time);
   

进阶优化 ⚡

1. 安全加固

   # 设置MySQL密码策略
   mysql -u root -p
   SET GLOBAL validate_password.policy=STRONG;
   
   # 配置防火墙
   sudo ufw allow 80/tcp
   sudo ufw allow 443/tcp
   sudo ufw deny 3306/tcp
   

2. AI服务配置 编辑config/application-prod.yml：

   ai:
     openai:
       api-key: "your_api_key"
       base-url: "https://api.openai.com/v1"  # 国内用户可替换为国内模型地址
   

总结与后续步骤

通过本文介绍的两种部署方案，您已经掌握了敲敲云零代码平台的本地化部署能力。传统部署方案适合需要深度定制的开发环境，而Docker容器化部署则更适合生产环境的快速交付。

下一步行动建议：

1. 根据您的实际需求选择合适的部署方案
2. 完成基础部署后进行安全加固
3. 尝试创建第一个应用并测试核心功能
4. 制定数据备份策略确保系统安全

随着业务发展，您可能还需要探索：

• 多节点高可用部署
• 自动化备份与恢复方案
• 系统监控与告警机制

现在，您已经拥有了一个功能完备的企业级零代码平台，开始构建您的第一个业务应用吧！

附录：部署环境检查清单

硬件要求

• CPU：至少2核
• 内存：至少4GB
• 磁盘：至少20GB可用空间
• 网络：能够访问互联网（用于下载依赖）

软件依赖

• 传统部署：JDK 11+、MySQL 8.0+、Redis 5.0+、Nginx
• Docker部署：Docker Engine 20.10+、Docker Compose 2.0+

网络要求

• 开放端口：80（HTTP）、443（HTTPS，可选）
• 数据库端口默认不对外暴露，仅内部访问