无论您是多年编程的高级工程师，还是刚刚入门的实习生，部署请完全参考本文档操作。

​
环境说明

pig4cloud 基础环境软件百度网盘批量下载「提取密码 8888」

软件版本备注
jdk17+支持 JDK21
mysql8要求设置数据库大小写不敏感 lower_case_table_names = 1
redis7
node18不支持 node 20
maven3.8+
IDEA2023+需要安装 lombok 插件

​
项目下载

# 后端
git clone https://git.pig4cloud.com/pig/pigx-ai.git

​
一、检查 IDEA 环境

架构配置确认：如下图所示：① 点击 IDEA 右侧 Maven 面板； ② 勾选 cloud profile； ③ 点击 Maven Reload；

​
二、配置数据库

  • 参数说明
版本： mysql5.7.8+
默认字符集: utf8mb4
默认排序规则: utf8mb4_general_ci

要求设置数据库大小写不敏感
lower_case_table_names = 1
https://blog.csdn.net/fdipzone/article/details/73692929
  • 数据库脚本说明
-- 建库语句
source db/1schema.sql;
-- 核心数据库
source db/2pigxx.sql;
-- 工作流相关数据库
source db/3pigxx_flow.sql;
-- 定时任务相关数据库
source db/4pigxx_job.sql;
-- 微信公众号相关数据库
source db/5pigxx_mp.sql;
-- 配置中心数据库
source db/6pigxx_config.sql;
-- 支付模块数据库
source db/7pigxx_pay.sql;
-- 代码生成模块数据库
source db/8pigxx_codegen.sql;
-- 大模型模块数据库
source db/9pigxx_ai.sql;
-- 报表设计数据库
source db/99pigxx_bi.sql;
-- APP模块数据库
source db/999pigxx_app.sql;
-- 【特别说明】大屏设计器：pigxx_report，自动创建表没有 DML SQL
  • 关于系统账号密码说明
系统作用账号密码
pigx-ui用户登录admin/123456
pigx-registernacos 注册配置中心nacos/nacos
pigx-sentinel-dashboardsentinel 流量保护sentinel/sentinel
pigx-monitor服务监控pigx/pigx
pigx-bi-platform报表设计平台pigx/pigx

​
三、配置本地 hosts

必须按此步骤配置，禁止修改代码中配置成固定 IP

win 配置方法 | mac 配置方法 | 懒人建议：使用 switchhost 快速切换 host

梯子、VPN 等软件会导致 hosts 配置失效，请关闭！

127.0.0.1 pigx-register
127.0.0.1 pigx-gateway
127.0.0.1 pigx-redis
127.0.0.1 pigx-xxl
127.0.0.1 pigx-mysql
127.0.0.1 pigx-sentinel
127.0.0.1 pigx-monitor
127.0.0.1 pigx-seata

​
四、配置修改

1

nacos 数据源修改

pigx/pigx-register/src/main/resources/application.yml

# 数据源相关配置
db:
  num: 1
  user: root #只需要修改此处用户名密码
  password: root #只需要修改此处用户名密码
2

启动 PigxNacosApplication

pigx/pigx-register/src/main/java/com/alibaba/nacos/PigxNacosApplication.java
3

浏览器访问 nacos

浏览器访问 http://127.0.0.1:8848/nacos 默认账号密码（nacos/nacos）

4

修改 Redis 配置

编辑【浏览器 Nacos 中】application-dev.yml 修改 redis 配置

spring:
  data:
    redis:
      password: #有密码就改，没密码删除此属性

5

修改数据库配置

编辑【浏览器 Nacos 中】修改数据库配置

序号配置文件名称备注
1pigx-upms-biz-dev.yml修改数据库链接信息、文件上传本地路径信息
2pigx-knowledge-dev.yml修改数据库链接信息
3pigx-codegen-dev.yml修改数据库链接信息
4pigx-pay-platform-dev.yml修改数据库链接信息
5pigx-flow-engine-biz-dev.yml修改数据库链接信息
6pigx-flow-task-biz-dev.yml修改数据库链接信息
7pigx-mp-platform-dev.yml修改数据库链接信息
8pigx-daemon-elastic-job-dev.yml修改数据库链接信息
9pigx-daemon-quartz-dev.yml修改数据库链接信息
10pigx-report-platform-dev.yml修改数据库链接信息、文件上传存储路径
spring:
  datasource:
    username: ${MYSQL-USER:root} #只需要修改此处用户名密码，冒号后边部分
    password: ${MYSQL-PWD:root} #只需要修改此处用户名密码，冒号后边部分
    url: jdbc:mysql://${MYSQL-HOST:pigx-mysql}:${MYSQL-PORT:3306}/.... #酌情修改此处端口，冒号后边部分

​
五、启动顺序（基础模块）

1.pigx-register/PigxNacosApplication.java
2.pigx-upms-biz/PigxAdminApplication   [注意启动完毕输出路由初始化完毕再去启动其他模块]
3.pigx-auth/PigxAuthApplication
4.pigx-gateway/PigxGatewayApplication
5.pigx-knowledge/PigxKnowledgeApplication


# 如需 Chat2SQL 功能，启动
- pigx-visual/pigx-codegen/PigxCodeGenApplication

# 如需要业务联动智能流程，启动 
- pigx-flow/PigxFlowEngineApplication
- pigx-flow/PigxFlowTaskApplication

​
六、启动前端

Node 版本 = 18

如遇 install 失败，请删除 node_modules 文件夹，尝试重新 npm install

# 查看node版本
node -v

#高版本执行切换至18
n 18.20.4

# 前端
git clone https://git.pig4cloud.com/pig/pigx-ai-ui.git

# 安装前端依赖
npm install  --registry=https://registry.npmmirror.com

# 启动
npm run dev

​
常见问题，搜索工单系统