零基础掌握敲敲云本地化部署：30分钟从环境配置到应用落地

2026-04-04 08:55:55作者：戚魁泉Nursing

一、需求定位：谁需要本地化部署敲敲云？

在企业数字化转型过程中，选择合适的应用开发平台是关键决策。敲敲云作为零代码与AI融合的开发平台，本地化部署主要解决三类核心需求：

数据安全合规：金融、医疗等行业需满足数据不出境要求，本地化部署确保敏感信息存储在企业自有服务器
定制化开发：需要深度整合企业现有系统（如ERP、OA）的场景，本地化部署提供更灵活的扩展接口
离线使用保障：网络不稳定或涉密环境下，本地化部署确保业务连续性

部署方案决策树

是否需要快速交付？ → 是 → Docker容器化部署
                  → 否 → 是否需要深度定制？ → 是 → 传统本地部署
                                              → 否 → Docker容器化部署

二、方案选型：两种部署模式的全方位评估

技术门槛双维度评估表

部署方式	新手友好度	实操复杂度	环境依赖	部署时间	维护难度	资源占用率	扩展性	适用场景
传统本地部署	★★☆☆☆	中（7/10）	JDK、MySQL、Redis、Nginx	25-30分钟	中	中	高	开发调试、定制化需求
Docker容器化部署	★★★★☆	低（4/10）	Docker Engine、Docker Compose	10-15分钟	低	低	中	生产环境、团队协作

⚠️ 风险提示：传统部署涉及多组件版本兼容性问题，建议严格按照环境要求配置；Docker部署需注意宿主机磁盘空间（建议预留至少20GB）

核心架构对比

传统部署架构（如同组装电脑）：需分别配置各个组件并手动连接

用户请求 → Nginx前端 → Java后端 → MySQL数据库
                          ↓
                      Redis缓存
                          ↓
                      AI服务模块

Docker容器化架构（类似标准化快递箱）：所有组件预打包，即插即用

┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐
│  Nginx   │  │  Java    │  │  MySQL   │  │  Redis   │
│ 容器     │──│ 容器     │──│ 容器     │  │ 容器     │
└──────────┘  └──────────┘  └──────────┘  └──────────┘
      │             │             │             │
      └─────────────┴─────────────┴─────────────┘
                    共享网络

三、实施步骤：分阶段部署指南

A方案：传统本地部署（适合深度定制）

1. 环境预检阶段

兼容性检测清单：

操作系统：Ubuntu 20.04+/CentOS 7.6+（不支持Windows Server）
JDK：11.0.10+（必须64位）
MySQL：8.0.23+（需开启innodb引擎）
Redis：6.2.5+（开启持久化）
硬件：4核CPU/8GB内存/50GB SSD

预检命令：

# 检查JDK版本
java -version  # 需显示"11.0.x"

# 检查MySQL状态
systemctl status mysql  # 需显示"active (running)"

# 检查Redis连接
redis-cli ping  # 预期返回"PONG"

2. 核心部署阶段

步骤1：获取项目文件

# 安装Git LFS处理大文件
sudo apt install git-lfs -y  # 用于下载超过100MB的JAR包
git lfs install  # 初始化Git LFS

# 克隆项目代码
git clone https://gitcode.com/jeecgboot/qiaoqiaoyun.git
cd qiaoqiaoyun  # 进入项目目录

步骤2：配置数据库

# 创建专用数据库用户
mysql -u root -p  # 登录MySQL，会提示输入密码

# 执行以下SQL命令（复制整段粘贴）
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  # 退出MySQL

步骤3：修改配置文件

# 使用nano编辑配置
nano 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  # Redis服务器地址
    port: 6379  # Redis端口

💡 优化建议：生产环境建议开启Redis密码认证，在配置中添加password: "your_redis_password"

步骤4：初始化数据库与启动服务

# 导入初始数据
mysql -u qiaoqiaoyun -p qiaoqiaoyun < qiaoqiaoyun.sql  # 会提示输入数据库密码

# 启动后端服务
chmod +x start.sh  # 赋予执行权限
./start.sh  # 启动服务，首次启动需30-60秒

步骤5：配置Nginx前端

# 创建Nginx配置文件
sudo nano /etc/nginx/sites-available/qiaoqiaoyun

# 配置内容（复制以下内容）
server {
    listen 80;
    server_name localhost;
    root /data/web/disk1/git_repo/jeecgboot/qiaoqiaoyun/dist;
    index index.html;
    
    location / {
        try_files $uri $uri/ /index.html;  # 支持前端路由
    }
    
    location /api {
        proxy_pass http://localhost:8080;  # 代理后端API
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

# 启用配置并重启Nginx
sudo ln -s /etc/nginx/sites-available/qiaoqiaoyun /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置是否有误
sudo systemctl restart nginx

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

1. 环境预检阶段

兼容性检测清单：

Docker Engine：20.10.0+
Docker Compose：2.0.0+
内核版本：Linux 5.4+
硬件：2核CPU/4GB内存/30GB磁盘

预检命令：

# 检查Docker是否安装
docker --version  # 需显示"20.10.x"或更高版本

# 检查Compose是否安装
docker compose version  # 需显示"v2.x.x"

2. 核心部署阶段

步骤1：安装Docker环境

# 一键安装Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh  # 自动安装最新版Docker

# 配置用户权限（避免每次使用sudo）
sudo usermod -aG docker $USER  # 将当前用户加入docker组

⚠️ 风险提示：执行完上述命令后需注销并重新登录，权限才能生效

步骤2：获取项目与启动服务

# 克隆项目代码
git clone https://gitcode.com/jeecgboot/qiaoqiaoyun.git
cd qiaoqiaoyun  # 进入项目目录

# 启动所有服务（后台运行）
docker compose -p qiaoqiaoyun up -d  # -p指定项目名称，-d表示后台运行

步骤3：查看服务状态

# 检查容器运行状态
docker compose ps  # 应显示4个容器：javax、mongo、mysql、nginx

# 检查服务日志
docker compose logs -f javax  # 查看后端服务日志，看到"Started QiaoqiaoyunApplication"表示成功

💡 优化建议：生产环境建议修改docker/.env文件自定义端口和密码，避免使用默认配置

四、效果验证：部署成功的五个关键检查点

1. 服务可用性验证

# 检查前端响应
curl -I http://localhost  # 预期返回"HTTP/1.1 200 OK"

# 检查后端API
curl http://localhost/api/jeecg-boot/sys/login  # 预期返回JSON格式的登录接口信息

2. 系统登录验证

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

3. 核心功能测试流程

进入工作台 → 点击"新建应用" → 选择"空白应用"
拖拽添加"单行文本"、"数字"、"日期"三个控件
点击"保存" → "发布"，生成应用表单
填写表单并提交，验证数据是否成功保存

4. AI功能可用性

进入"AI工作流"模块
输入提示词"创建客户信息管理表"
验证AI是否能生成包含常用字段的表单结构

5. 性能基准测试

# 查看系统资源占用
docker stats  # Docker部署使用此命令
# 或
top  # 传统部署使用此命令

# 正常指标：CPU使用率<40%，内存占用<3GB

五、进阶优化：从可用到好用的关键步骤

安全加固措施

数据库安全：

-- 登录MySQL执行
SET GLOBAL validate_password.policy=STRONG;  # 启用强密码策略
ALTER USER 'qiaoqiaoyun'@'localhost' PASSWORD EXPIRE INTERVAL 90 DAY;  # 密码90天过期

网络安全：

# 配置防火墙
sudo ufw allow 80/tcp  # 只开放HTTP端口
sudo ufw allow 443/tcp  # 如果配置HTTPS
sudo ufw deny 3306/tcp  # 禁止外部直接访问数据库

性能优化配置

JVM参数调优（传统部署）：

# 编辑start.sh文件
nano start.sh

# 修改JAVA_OPTS行
JAVA_OPTS="-Xms1024m -Xmx2048m -XX:+UseG1GC -XX:MaxGCPauseMillis=200"

💡 优化原理：G1GC收集器适合中等内存应用，200ms停顿时间平衡响应速度和吞吐量

数据库优化：

-- 添加常用索引
CREATE INDEX idx_form_data_create_time ON form_data(create_time);
CREATE INDEX idx_process_instance_status ON process_instance(status);

监控与维护

日志管理：

# 设置日志轮转（传统部署）
sudo nano /etc/logrotate.d/qiaoqiaoyun

# 添加以下内容
/data/web/disk1/git_repo/jeecgboot/qiaoqiaoyun/logs/*.log {
    daily
    rotate 15
    compress
    delaycompress
    missingok
}

定期备份：

# 创建备份脚本
nano /opt/backup_qiaoqiaoyun.sh

# 脚本内容
#!/bin/bash
BACKUP_DIR="/data/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR

# 备份数据库
mysqldump -u qiaoqiaoyun -p'Qiaoqiaoyun@123' qiaoqiaoyun > $BACKUP_DIR/qiaoqiaoyun_$TIMESTAMP.sql

# 保留最近30天备份
find $BACKUP_DIR -name "qiaoqiaoyun_*.sql" -mtime +30 -delete