ShopXO企业级商城
1 硬件 & 软件环境
测试环境最低配置
- CPU：2 核
- 内存：2G
- SSD 硬盘 ≥30G
- 系统：CentOS7.9 / Ubuntu20.04
生产环境推荐
- CPU ≥4 核，内存 ≥4G；开启 Redis 缓存、Swoole；大流量可多实例 + Nginx 负载均衡
- 数据库 MySQL8.0，定期备份
软件版本清单
- PHP 8.0+（v6.1.0 以上版本要求），开启扩展：fileinfo、redis、curl、gd、pdo_mysql
- MySQL5.7 / MySQL8.0
- Redis（可选，性能优化）
- Nginx 1.18+
- 宝塔面板（可选，简化运维）
2 方式 A：宝塔面板一键部署（新手首选）
Step1 服务器初始化，安装宝塔
# CentOS安装宝塔命令
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec
安装完成，记录面板地址、账号密码，登录宝塔后台。
Step2 在宝塔安装环境
软件商店安装：Nginx、PHP8.1、MySQL8.0，安装 PHP 扩展：redis、fileinfo、curl、gd。
Step3 创建网站站点
- 网站 → 添加站点，绑定域名，创建数据库，记录数据库账号密码
- 网站根目录：
/www/wwwroot/域名目录
Step4 下载 ShopXO 源码上传
- Gitee 或者官网下载最新 ShopXO 源码
- 压缩包上传网站根目录，解压
- 设置目录权限：
runtime目录权限 755，public 为网站运行入口目录
Step5 访问安装向导
浏览器访问域名，自动跳转安装页面
- 环境检测，确认 PHP、扩展全部通过
- 填写数据库信息（刚才宝塔创建的数据库账号密码）
- 设置商城管理员账号密码
- 提交安装，系统自动导入数据库
Step6 后端 & 前端部署
- 后台管理地址：
域名/admin，使用管理员账号登录 - Uni-app 移动端源码：HBuilderX 打开项目，打包 H5、编译小程序，配置接口域名。
3 方式 B：Linux Nginx 手动源码部署（无宝塔）
Step1 服务器基础配置
# 测试环境关闭防火墙，生产不要关闭
systemctl stop firewalld
systemctl disable firewalld
setenforce 0
sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
yum update -y
Step2 安装 Nginx、PHP8.1、MySQL8.0、Redis
# 安装mysql，创建数据库
CREATE DATABASE shopxo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Step3 下载源码、解压、配置 Nginx
mkdir -p /usr/local/shopxo
cd /usr/local/shopxo
git clone https://gitee.com/zongzhige/shopxo.git
Nginx 站点配置，根目录指向 public，配置伪静态规则（ThinkPHP 伪静态）。
Step4 目录权限
chmod -R 755 /usr/local/shopxo/runtime
Step5 浏览器访问域名，执行在线安装向导，填写数据库，完成初始化。
4 系统网页初始化配置（后台操作）
- 登录商城后台，修改默认管理员密码
- 初始化顺序：
① 商城基础配置：商城名称、域名、短信、邮箱
② 商品分类、品牌管理
③ 支付配置：微信、支付宝密钥
④ 文件存储配置：本地 / OSS
⑤ 开启对应插件（多商户 / 进销存等，需要先安装插件包）
⑥ 营销基础参数、积分、优惠券配置 - 新增商品，维护 SKU、库存，发布商品
- C 端 H5 / 小程序访问，测试加购、下单、支付、售后流程
5 对接 Y-OMS-WMS-TMS 履约中台
完整业务链路：
C 端用户 ShopXO 下单付款 → ShopXO 订单事件调用 API 推送订单到 Y-OMS → OMS 库存校验、分仓策略分配仓库 → OMS 下发 WMS，仓库 PDA 收货拣货复核打包 → WMS 出库推送 TMS 生成运单 → TMS 承运商调度，物流轨迹回调回写 ShopXO 前台。
对接要点：
- ShopXO 开放订单 API/Webhook，新订单、订单状态变更实时推送至 OMS；
- 关闭商城原生发货流程，发货、物流状态由履约中台回调更新；
- SKU 库存双向同步：WMS 真实库存定时回写到 ShopXO 商品库存；
- 售后退货事件同步，退货入库完成后回传商城更新售后状态；
- 进销存插件可作为辅助，主履约交给 Y-OMS-WMS-TMS。
6 运维 & 备份方案
- MySQL 每日定时全量备份，开启 binlog，备份保留 7~30 天；
- Redis 开启持久化；
- 日志切割，runtime 目录日志定期清理，防止磁盘占满；
- 监控：服务器 CPU、内存、PHP 进程；
- 版本升级：升级前完整备份数据库 + 源码，插件环境提前在测试环境验证兼容性；
- 安全策略：禁止公网暴露数据库端口；定期修改数据库、后台管理员密码；PHP 定期更新补丁。
7 常见部署坑点
- PHP 版本不对，缺少扩展（fileinfo 必装），安装向导环境检测失败；
- Nginx 伪静态未配置，后台 404；
- runtime 目录权限不足，缓存、日志无法写入，页面报错；
- 数据库字符集不是 utf8mb4，emoji 表情存储失败；
- 小程序域名未配置 HTTPS，小程序端无法调用接口；
- 插件版本和主程序版本不匹配，开启插件后页面报错；
- 支付回调外网域名无法访问，无法接收微信支付宝回调。
8 业务人员使用简要说明
- 平台运营：登录管理后台维护商品、配置营销活动、处理订单售后、管理插件；开启多商户插件后，审核商家、设置平台佣金、监控全平台订单、资金结算。
- 商家运营（多商户插件）：商家后台管理店铺、商品发布、处理订单、售后审核、店铺营销、申请资金提现。
- 门店运营（多门店插件）：门店收银、订单核销、自提订单管理、门店库存。
- C 端买家：PC/H5 / 小程序浏览商品、购物下单、支付、查看物流、发起售后、参与营销活动、门店自提核销。
- 权限建议：超级管理员、商品运营、订单客服、财务、门店管理员分开分配角色权限。