📄 系统快速上手部署 👍

特别说明

首先欢迎您使用 pig4cloud，本文档对应视频页面： 📺 1.商业版环境安装 📺 2.商业版代码部署

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

环境说明

pig4cloud 基础环境软件百度网盘批量下载 「提取密码 exw7」 (opens new window)

软件	版本	备注
jdk	8/17	根据代码分支决定
mysql	8	要求设置数据库大小写不敏感 lower_case_table_names = 1 (opens new window)
redis	3.2+
node	16	不支持 node 20
maven	3.5+
IDEA	2019+	需要安装 lombok 插件 (opens new window)

一、项目下载

# 下载源代码 JDK 8 版本
git clone https://git.pig4cloud.com/pig/pigx.git

# 下载源代码 JDK 17 版本
git clone https://git.pig4cloud.com/pig/pigx.git -b jdk17

二、配置数据库

• 参数说明

版本： 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/99pigxx_bi.sql;
-- APP模块数据库
source db/999pigxx_app.sql;

• 关于系统账号密码说明

系统	作用	账号密码
pigx-ui	用户登录	admin/123456
pigx-register	nacos 注册配置中心	nacos/nacos
pigx-sentinel-dashboard	sentinel 流量保护	sentinel/sentinel
pigx-monitor	服务监控	pigx/pigx
pigx-bi-platform	报表设计平台	pigx/pigx

三、配置本地 hosts

特别说明

请务必按此步骤配置 hosts, 禁止修改代码中配置成 IP。修改完成后 逐个 ping xx 确认可以用! win 配置方法 (opens new window) | mac 配置方法 (opens new window) | 建议使用 switchhost (opens new window)

梯子、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

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

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

spring:
  redis:
    password: #有密码就改没密码留空

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

配置文件名称
pigx-upms-biz-dev.yml
pigx-codegen-dev.yml
pigx-pay-platform-dev.yml
pigx-oa-platform-dev.yml
pigx-mp-platform-dev.yml
pigx-daemon-elastic-job-dev.yml
pigx-daemon-quartz-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

IDEA service 面板可能显示不全 SpringBoot 的 Main 启动类，直接按上边模块去根目录找 Main 方法启动即可。

六、启动前端

node 版本 = 16

# 查看node版本
node -v

#高版本执行切换至16
n 16.18.1

# 下载前端源码
git clone https://git.pig4cloud.com/pig/pigx-ui.git

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

# 启动
npm run dev

七、其他模块需要时再启动

• 启动 pigx-daemon-elastic-job，部署 xxl-job-admin 参考文档

常见问题，搜索工单系统

• 常见问题列表 参考私服工单 (opens new window)
• 工单系统搜索可以解决大部分问题,注意关键词搜索
• 新建工单注意 提供日志、截图、回显步骤