Lilishop多商户商城
1 硬件 & 软件环境
测试环境最低配置（Docker Compose 单机）
- CPU ≥4 核
- 内存 ≥16G（ES 非常耗内存，低于 16G 容易 OOM 崩溃）
- SSD 硬盘 ≥100G
- 操作系统：CentOS7.6 / Ubuntu20.04
生产环境推荐
- 单体版：4 核 8G 以上，MySQL 主从，Redis 持久化；可多实例集群 + Nginx 负载均衡
- 微服务版：Nacos、MySQL、RocketMQ、ES、应用服务分离独立服务器
软件版本清单
- JDK17（推荐）
- MySQL8.0
- Redis6+
- Elasticsearch7.x
- RocketMQ4.x
- Docker & Docker Compose
- Maven3.6+、Node.js16+、HBuilderX（打包 Uni-app 移动端）
- Nginx
2 服务器初始化操作（Linux）
# 测试环境关闭防火墙（生产环境不要关闭，按需放行端口）
systemctl stop firewalld
systemctl disable firewalld
setenforce 0
sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
yum update -y
3 方式 A：Docker Compose 一键部署（推荐测试演示）
Step1 安装 Docker & Docker Compose
yum install docker -y
systemctl start docker
systemctl enable docker
# 安装compose
curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose -v
Step2 拉取 Lilishop 项目代码与 docker 配置
git clone https://gitee.com/beijing_hongye_huicheng/lilishop.git
cd lilishop
# 进入docker目录
cd docker
Step3 修改环境配置 .env
修改关键参数：数据库账号密码、Redis 密码、ES 内存配置、服务器 IP 地址（不能写 127.0.0.1，容器之间无法互通）
ES 目录权限必须设置 777，否则 ES 容器反复重启
Step4 一键拉起全部中间件
docker-compose up -d
等待 5~10 分钟全部容器启动，执行docker ps查看容器状态。
Step5 初始化数据库
项目内置 SQL 脚本，进入 MySQL 容器，导入初始化脚本，自动创建平台、商家、买家相关数据表。
# 脚本目录 doc/sql
mysql -u root -p lilishop < lilishop_init.sql
Step6 后端服务启动
docker-compose -f docker-compose-application.yml up -d
单体版直接启动；微服务版本按顺序启动网关、认证、商品、订单、用户、营销、IM 等服务。
Step7 前端打包部署
- 平台管理端、商家后台 Vue 项目
#进入前端目录
npm install
npm run build
输出 dist 静态资源，上传服务器，Nginx 托管静态页面，反向代理 /api 转发后端接口。
2. Uni-app 移动端：HBuilderX 打开项目，打包 H5、编译微信小程序。
Step8 访问系统地址
- 平台管理后台：http:// 服务器 IP:8888
- 商家管理后台：http:// 服务器 IP:8889
- PC 买家商城：http:// 服务器 IP:10000
- API 文档：http://IP: 端口 /doc.html
4 方式 B：单体源码本地 Jar 包部署（生产可用）
- Git 拉取源码，Maven 打包
git clone https://gitee.com/beijing_hongye_huicheng/lilishop.git
cd lilishop
mvn clean package -DskipTests
- 上传 jar 包到服务器，新建目录
mkdir -p /usr/local/lilishop/logs
- 修改
application.yml配置文件，填写 MySQL、Redis、ES、RocketMQ 连接信息 - 启动服务
nohup java -jar lilishop.jar > /usr/local/lilishop/logs/lilishop.log 2>&1 &
生产环境建议配置 systemd 托管，服务异常自动重启。
5 系统网页初始化配置（后台操作）
- 使用默认管理员账号登录平台后台，修改初始密码
- 初始化顺序：
① 平台基础设置、商城名称、域名、短信配置
② 类目、品牌管理，配置类目佣金比例
③ 入驻商家配置，开启商家入驻，新增商家账号
④ 支付配置（微信、支付宝密钥）
⑤ 文件存储配置（OSS/MinIO）
⑥ 营销基础参数、分销规则、积分规则 - 商家账号登录商家后台，维护店铺信息，发布商品，提交平台审核
- C 端 H5 / 小程序访问，测试加购、下单、支付、售后全流程
6 对接 Y-OMS-WMS-TMS 履约中台
完整业务链路：
C 端用户 Lilishop 下单付款 → Lilishop 订单事件推送订单 API 至 Y-OMS → OMS 库存校验、分仓策略分配仓库 → OMS 下发 WMS，仓库 PDA 收货拣货复核打包 → WMS 出库推送 TMS 生成运单 → TMS 承运商调度，物流轨迹回调回写 Lilishop 前台展示物流信息。
对接要点：
- Lilishop 开放订单 Webhook，新订单、订单状态变更实时推送至 OMS；
- 关闭商城原生发货流程，发货、物流状态由履约中台回调更新；
- SKU 库存双向同步，WMS 真实库存定时回写到 Lilishop 商品库存；
- 售后退货事件同步，退货入库完成后回传商城更新售后状态。
7 运维 & 备份方案
- MySQL 每日定时全量备份 + binlog 增量备份，备份保留 7~30 天；
- Redis 开启 RDB+AOF 持久化，防止缓存丢失；
- Elasticsearch 定期索引优化，日志切割，防止磁盘占满；
- RocketMQ 监控消息堆积，大促重点监控消费速度；
- 服务器监控：CPU、内存、磁盘、Java 进程；
- 发布流程：测试环境验证 → 数据库备份 → 生产滚动发布；
- 安全策略：禁止公网直接暴露 MySQL、Redis、ES 端口，定期修改数据库密码。
8 常见部署坑点
- Elasticsearch 内存不足，容器反复重启；ES 挂载目录权限不足（必须 777）；
- 服务器 IP 填写 127.0.0.1，容器之间网络不通，中间件连接失败；
- RocketMQ 磁盘空间不足，消息停止消费，订单卡住；
- MySQL 字符集非 utf8mb4，无法保存 emoji 表情；
- Nginx 反向代理跨域配置错误，前端无法调用后端接口；
- 支付回调公网域名不可访问，无法接收微信 / 支付宝回调；
- IM 客服服务未启动，买家商家在线聊天功能失效；
- 商品审核流程忘记开启，商家商品前台无法展示。
9 业务人员使用简要说明
- 平台运营：登录平台后台，审核商家、审核商品、设置平台佣金、配置平台营销活动、监控全平台订单，处理买卖家售后纠纷，资金结算管理。
- 商家运营：商家后台维护店铺，发布商品等待平台审核，处理订单、打印面单、审核售后、管理店铺营销、申请资金提现。
- C 端买家：小程序 / H5/PC 浏览商品、购物下单、支付、查看物流、发起售后、参与分销、直播间购物。
- 权限建议：平台超级管理员、平台运营、平台财务、商家管理员、商家客服分开分配角色权限。