一、教程简介
Tigshop是拥有16年企业级电商研发经验的开源商城系统，采用SpringBoot3 + Vue3 + Nuxt3 + UniApp主流全栈架构，全面覆盖B2C单商户、B2B2C 多商户、O2O 多门店、跨境多语言、S2B2C 供应链五大核心电商场景，是企业级商用落地首选的开源电商方案。
相比于Docker部署，宝塔面板可视化部署无需复杂 Linux 命令，可快速完成环境搭建、项目部署、进程守护、SSL 配置、反向代理等全流程操作，极大降低运维门槛，适合中小企业、个人开发者快速上线商城项目。
本文整理出一套可直接落地、零冗余、高稳定的宝塔部署全流程，可快速了解。
二、部署前置要求
2.1 服务器配置最低标准
- 硬件：2核CPU / 4GB内存及以上（双Java服务+中间件常驻运行）
- 系统：CentOS 7.6+、Ubuntu 18.04+、阿里云Linux
- 网络：3M及以上带宽，开放安全组端口
- 环境：干净服务器，无端口占用、无残留环境冲突
2.2 必备软件环境（官方适配）
全部在宝塔软件商店一键安装，严格适配 Tigshop Java技术栈：
- Nginx 1.20+：静态资源托管、反向代理、HTTPS 配置
- MySQL 8.0+：官方强制适配，不兼容 MySQL5.7
- JDK 17：适配 SpringBoot3 核心框架，不支持 JDK8/11
- Redis 7.x：缓存、分布式会话、秒杀库存、业务缓存
- Supervisor 进程管理器：Java 项目常驻守护、开机自启、异常重启
- Maven 3.8+：源码编译打包（已有Jar包可跳过）
2.3 核心端口规划（务必放行）
需在服务器安全组、宝塔防火墙同时放行以下端口：
| 服务名称 | 端口 | 核心用途 |
| 管理后台API | 8080 | 平台/商家后台业务接口 |
| 用户商城API | 8181 | PC/H5/小程序前端接口 |
| MySQL数据库 | 3306 | 商城业务数据存储 |
| Redis缓存 | 6379 | 缓存、会话、秒杀业务 |
| 宝塔面板 | 8888 | 后台运维管理 |
| 网站访问 | 80/443 | HTTP/HTTPS 域名访问 |
三、宝塔面板快速安装
3.1 对应系统安装命令
CentOS / 阿里云服务器
url=https://download.bt.cn/install/install_panel.sh;if [ -f /usr/bin/curl ];then curl -sSO $url;else wget -O install_panel.sh $url;fi;bash install_panel.sh ed8484bec
Ubuntu / Debian 服务器
wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && sudo bash install_panel.sh ed8484bec
3.2 面板信息查看
安装完成后，终端自动输出面板地址、账号、密码。若遗忘，执行以下命令查询：
bt default
重要提醒：云服务器需提前放行 8888 端口，否则无法访问宝塔面板。
四、环境安装与全局配置
4.1 可视化安装依赖软件
登录宝塔面板 → 进入【软件商店】，按顺序极速安装：Nginx → MySQL8.0 → JDK17 → Redis7 → Supervisor。
4.2 环境有效性验证
终端执行以下命令，验证环境安装成功：
java -version redis-cli ping mysql -V
4.3 配置JDK全局环境变量
如需本地编译源码，配置全局JDK环境：
echo 'export JAVA_HOME=/usr/local/jdk17' >> /etc/profile echo 'export PATH=$PATH:$JAVA_HOME/bin' >> /etc/profile source /etc/profile java -version
五、Tigshop 源码预处理
5.1 官方源码获取
登录授权中心，下载Java PRO 版部署包，核心目录结构如下：
tigshop-java-pro/ ├── tigshop-adminapi/ # 管理后台后端（8080端口） ├── tigshop-api/ # 用户商城后端（8181端口） ├── sql/demo.sql # 数据库初始化脚本 ├── public/ # PC/后台/H5 前端静态资源 ├── application.yml # 全局核心配置文件
5.2 配置文件适配本地环境
修改 application.yml，适配宝塔本地数据库、Redis 服务：
spring: datasource: url: jdbc:mysql://127.0.0.1:3306/tigshop_java?character_set_server=utf8mb4&allowPublicKeyRetrieval=true&useSSL=false&serverTimezone=GMT%2B8 username: tigshop password: 自定义数据库密码 data: redis: host: 127.0.0.1 port: 6379 password: # 无密码则留空
5.3 源码打包生成Jar包
终端进入项目目录，跳过测试快速打包：
# 打包管理后台 cd tigshop-adminapi mvn clean package -Dmaven.test.skip=true # 打包用户商城端 cd ../tigshop-api mvn clean package -Dmaven.test.skip=true
打包成功后，target 目录生成两个核心 Jar 包，用于后续部署。
5.4 项目文件上传服务器
宝塔【文件】→ 进入 /www/wwwroot/，新建文件夹 tigshop-java，上传：两个Jar包、public静态资源、demo.sql数据库脚本。
六、数据库初始化配置
6.1 新建业务数据库
宝塔【数据库】→【添加数据库】
- 数据库名：
tigshop_java - 用户名：
tigshop - 密码：自定义（与yml配置保持一致）
6.2 导入初始化数据
点击数据库右侧【导入】，上传 demo.sql 脚本，自动完成建表、初始化管理员账号、商品分类、分销配置、基础商城数据。
七、双SpringBoot项目部署（核心步骤）
Tigshop Java 版分为后台管理、用户商城两个独立后端服务，需分别部署并开启进程守护。
7.1 部署管理后台API（8080）
宝塔【网站】→【Java项目】→【添加Java项目】
- 项目类型：SpringBoot项目
- Jar路径：
/www/wwwroot/tigshop-java/对应后台Jar包 - JDK版本：JDK17
- 端口：8080
- 启动参数：
-Xms512m -Xmx1024m --server.port=8080 - 开启：开机自启、异常自动重启
7.2 部署用户商城API（8181）
重复上述步骤，仅修改核心参数：
- Jar路径：商城端Jar包
- 端口：8181
- 启动参数：
-Xms512m -Xmx1024m --server.port=8181
7.3 启动验证
查看项目日志，出现 Started TigshopApplication in xx seconds 即为启动成功。
八、Nginx站点配置（前端+反向代理）
通过 Nginx 实现静态资源托管、路由兜底、API 反向代理、HTTPS 全站加密，解决前端刷新404、接口跨域问题。
8.1 新建站点
添加站点，绑定商城域名，网站根目录指向 /www/wwwroot/tigshop-java/public，通过宝塔SSL面板一键申请免费HTTPS证书。
8.2 完整Nginx配置（直接复制替换）
server { listen 80; server_name shop.tigshop.com; return 301 https://$host$request_uri; } server { listen 443 ssl; server_name shop.tigshop.com; ssl_certificate /www/server/panel/vhost/cert/shop.tigshop.com/fullchain.pem; ssl_certificate_key /www/server/panel/vhost/cert/shop.tigshop.com/privkey.pem; root /www/wwwroot/tigshop-java/public; index index.html index.htm; // 前端路由兜底，解决刷新404 location / { try_files $uri /pc/$uri /pc/index.html; } location /admin { try_files $uri $uri/ /admin/index.html; } location /mobile { try_files $uri $uri/ /mobile/index.html; } // 商城API反向代理 location /api { proxy_pass http://127.0.0.1:8181; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_connect_timeout 60s; proxy_read_timeout 300s; } // 后台API反向代理 location /adminapi { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_connect_timeout 60s; proxy_read_timeout 300s; } // 静态资源缓存优化 location ~* \.(jpg|png|css|js|ico)$ { expires 365d; access_log off; } }
保存配置并重载Nginx，无报错即配置生效。
九、全端项目访问验证
- PC商城首页：
https://你的域名，支持商品浏览、秒杀拼团、优惠券、门店自提、多语言切换 - 商家管理后台：
https://你的域名/admin，包含商品/订单/分销/直播/分账/可视化装修/数据看板全功能 - H5移动端商城：
https://你的域名/mobile，适配手机浏览器、微信小程序，支持会员、分销、下单功能
十、日常运维常用操作
10.1 项目启停重启
宝塔【Java项目】面板，支持一键启动、停止、重启服务，服务器重启自动恢复。
10.2 日志排查
Java项目详情页查看实时日志，快速定位接口报错、队列异常、佣金计算问题。
10.3 版本升级
官网下载新版Jar包覆盖旧文件，重启Java服务；如有数据库更新，手动执行升级SQL脚本即可。
十一、高频部署报错解决方案
- 页面空白/静态资源404：Nginx伪静态路由规则缺失，替换本文完整配置即可解决
- 接口502错误：Java服务未启动、端口未放行，查看日志排查服务状态
- 数据库连接失败：核对yml文件账号密码、数据库地址与本地数据库一致
- 页面刷新404：未配置 try_files 路由兜底，严格使用教程Nginx配置
- Java内存溢出：调低JVM参数
-Xmx768m或升级服务器内存 - 分销/订单消息不触发：检查Redis服务运行状态与连接配置
十二、宝塔部署优势 & 场景适配
12.1 核心优势
- 全可视化操作，无需精通Linux命令，运维门槛极低
- 自带进程守护、自动重启、定时备份，稳定性更高
- 一键SSL、伪静态、缓存优化，适配生产环境上线标准
12.2 全业务场景通用
本部署方案适配 Tigshop Java 所有PRO版本，仅需微调业务配置即可切换场景：B2C单商户、B2B2C多商户、O2O多门店、跨境多语言、S2B2C供应链商城。
