Banner

Tigshop开源商城

2026-10-15

1 硬件 & 软件环境

测试环境最低配置

  • Java 版：CPU ≥2 核，内存 ≥4G，SSD ≥50G
  • PHP 版：CPU ≥2 核，内存 ≥2G，SSD ≥30G
  • 系统：CentOS7.9 / Ubuntu20.04

生产环境推荐

  • Java 版：4 核 8G 起步，MySQL 主从，Redis；大流量集群 + Nginx 负载均衡
  • PHP 版：4 核 4G，Redis 缓存提升并发

软件版本清单

Java 版本

  • JDK17、MySQL8.0、Redis6+、Nginx1.20+、Maven3.6+、Node.js16+

PHP 版本

  • PHP8.1、MySQL8.0、Redis（可选）、Nginx1.20+，开启 fileinfo、redis、curl、gd 扩展

2 方式 A：宝塔面板部署（PHP 版本，新手首选）

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 创建站点与数据库

网站 → 添加站点，绑定域名，新建 MySQL 数据库，保存账号密码。网站根目录指向public。

Step4 下载 Tigshop 源码上传解压

Gitee 下载 Tigshop 源码，上传网站目录解压。设置目录权限，runtime目录 755。

Step5 访问安装向导

浏览器访问域名，进入安装页面

  1. 环境检测，确认所有扩展检测通过
  2. 填入宝塔创建的数据库账号密码
  3. 设置平台管理员账号密码，提交安装，自动导入数据表

Step6 前端打包部署

  1. PC 端 Nuxt3 项目、管理后台 Vue 项目：npm install && npm run build打包 dist，Nginx 托管静态资源。
  2. Uni-app 移动端源码，HBuilderX 打包 H5，编译微信 / 抖音小程序。

3 方式 B：Linux Jar 包部署（Java 版本）

Step1 服务器基础配置

# 测试环境关闭防火墙，生产环境不要关闭，按需放行端口
systemctl stop firewalld
systemctl disable firewalld
setenforce 0
sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
yum update -y

Step2 安装 JDK17、MySQL8.0、Redis

# 创建数据库
CREATE DATABASE tigshop DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Step3 源码拉取、Maven 打包

git clone https://gitee.com/tigshop/tigshop.git
cd tigshop
mvn clean package -DskipTests

打包完成，target 目录生成tigshop.jar

Step4 上传 Jar 包，修改配置

mkdir -p /usr/local/tigshop/logs

上传 jar 包，修改application.yml，配置 MySQL、Redis 地址、文件存储、支付密钥。

Step5 启动服务

nohup java -jar tigshop.jar > /usr/local/tigshop/logs/tigshop.log 2>&1 &
生产环境推荐 systemd 托管，实现崩溃自动重启。

Step6 前端部署

PC Nuxt3、管理后台 Vue 打包 dist；Uni-app 移动端 HBuilderX 打包。Nginx 反向代理 /api 转发 Java 后端端口。

4 系统网页初始化配置（后台操作）

  1. 登录平台后台，修改默认管理员密码
  2. 初始化顺序：
    ① 商城基础配置：商城名称、域名、短信、邮件
    ② 商品分类、品牌管理
    ③ 支付配置：微信、支付宝密钥
    ④ 文件存储配置：本地 / OSS/MinIO
    ⑤ 开启对应业务模块（B2B2C/O2O / 跨境 Pro 版需要授权）
    ⑥ 营销基础参数：优惠券、分销、积分规则
  3. 新增商品，维护 SKU、库存，发布商品
  4. C 端 H5 / 小程序访问，测试加购、下单、支付、售后全流程

5 对接 Y-OMS-WMS-TMS 履约中台

完整业务链路：
C 端用户 Tigshop 下单付款 → Tigshop 订单事件调用 API 推送订单到 Y-OMS → OMS 库存校验、分仓策略分配仓库 → OMS 下发 WMS，仓库 PDA 收货拣货复核打包 → WMS 出库推送 TMS 生成运单 → TMS 承运商调度，物流轨迹回调回写 Tigshop 前台。

对接要点：

  1. Tigshop 开放订单 Webhook，新订单、订单状态变更实时推送 OMS；
  2. 关闭商城原生发货流程，发货、物流状态由履约中台回调更新；
  3. SKU 库存双向同步：WMS 真实库存定时回写到 Tigshop 商品库存；
  4. 售后退货事件同步，退货入库完成后回传商城更新售后状态。

6 运维 & 备份方案

  1. MySQL 每日定时全量备份，开启 binlog，备份保留 7~30 天；
  2. Redis 开启 RDB+AOF 持久化，防止缓存丢失；
  3. 日志切割，定期清理日志，防止磁盘占满；
  4. 服务器监控：CPU、内存、磁盘、Java/PHP 进程；
  5. 版本升级前完整备份数据库 + 源码，优先在测试环境验证；
  6. 安全策略：禁止公网暴露数据库、Redis 端口，定期修改后台密码。

7 常见部署坑点

  1. PHP 版本过低、缺少 fileinfo 扩展，安装向导环境检测失败；
  2. Nuxt3 SSR 部署配置错误，PC 前台页面渲染异常、SEO 失效；
  3. runtime 目录权限不足，缓存、日志无法写入，页面报错；
  4. 数据库字符集非 utf8mb4，emoji 表情存储失败；
  5. Nginx 伪静态配置缺失，页面 404；
  6. 小程序域名未配置 HTTPS，小程序端接口请求失败；
  7. Pro 版未配置授权，B2B2C、O2O 模块无法启用。

8 业务人员使用简要说明

  1. 平台运营：登录平台后台维护商品、配置营销活动、处理订单售后；B2B2C 版本审核商家、设置类目佣金、资金结算；O2O 版本管理门店。
  2. 商家运营（B2B2C）：商家后台管理店铺、发布商品等待平台审核，处理订单、售后审核、店铺营销、申请资金提现。
  3. 门店运营（O2O）：门店 POS 收银、订单核销、自提订单、门店库存管理。
  4. C 端买家：PC/H5 / 小程序浏览商品、购物下单、支付、查看物流、发起售后、参与营销活动。
  5. 权限建议：超级管理员、商品运营、订单客服、财务、门店管理员分开分配角色权限。


3
Tigshop开源商城
Tigshop（佰商科技）企业级开源商城，**Apache2.0 开源协议**，单商户 B2C 标准版永久免费开源，源码无加密；同时提供 Java (SpringBoot3)、PHP (ThinkPHP8) 两套后端版本，支持 B2C/B2B2C/O2O/S2B2C / 跨境多语言 / B2B 批发六大业务产品线。
2026-10-15
6
目录