一、教程简介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.7JDK 17适配 SpringBoot3 核心框架不支持 JDK8/11Redis 7.x缓存、分布式会话、秒杀库存、业务缓存Supervisor 进程管理器Java 项目常驻守护、开机自启、异常重启Maven 3.8源码编译打包已有Jar包可跳过2.3 核心端口规划务必放行需在服务器安全组、宝塔防火墙同时放行以下端口服务名称端口核心用途管理后台API8080平台/商家后台业务接口用户商城API8181PC/H5/小程序前端接口MySQL数据库3306商城业务数据存储Redis缓存6379缓存、会话、秒杀业务宝塔面板8888后台运维管理网站访问80/443HTTP/HTTPS 域名访问三、宝塔面板快速安装3.1 对应系统安装命令CentOS / 阿里云服务器urlhttps://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 ed8484becUbuntu / Debian 服务器wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh sudo bash install_panel.sh ed8484bec3.2 面板信息查看安装完成后终端自动输出面板地址、账号、密码。若遗忘执行以下命令查询bt default重要提醒云服务器需提前放行 8888 端口否则无法访问宝塔面板。四、环境安装与全局配置4.1 可视化安装依赖软件登录宝塔面板 → 进入【软件商店】按顺序极速安装Nginx → MySQL8.0 → JDK17 → Redis7 → Supervisor。4.2 环境有效性验证终端执行以下命令验证环境安装成功java -version redis-cli ping mysql -V4.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_serverutf8mb4allowPublicKeyRetrievaltrueuseSSLfalseserverTimezoneGMT%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.skiptrue # 打包用户商城端 cd ../tigshop-api mvn clean package -Dmaven.test.skiptrue打包成功后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 部署管理后台API8080宝塔【网站】→【Java项目】→【添加Java项目】项目类型SpringBoot项目Jar路径/www/wwwroot/tigshop-java/对应后台Jar包JDK版本JDK17端口8080启动参数-Xms512m -Xmx1024m --server.port8080开启开机自启、异常自动重启7.2 部署用户商城API8181重复上述步骤仅修改核心参数Jar路径商城端Jar包端口8181启动参数-Xms512m -Xmx1024m --server.port81817.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脚本即可。十一、高频部署报错解决方案页面空白/静态资源404Nginx伪静态路由规则缺失替换本文完整配置即可解决接口502错误Java服务未启动、端口未放行查看日志排查服务状态数据库连接失败核对yml文件账号密码、数据库地址与本地数据库一致页面刷新404未配置 try_files 路由兜底严格使用教程Nginx配置Java内存溢出调低JVM参数-Xmx768m或升级服务器内存分销/订单消息不触发检查Redis服务运行状态与连接配置十二、宝塔部署优势 场景适配12.1 核心优势全可视化操作无需精通Linux命令运维门槛极低自带进程守护、自动重启、定时备份稳定性更高一键SSL、伪静态、缓存优化适配生产环境上线标准12.2 全业务场景通用本部署方案适配 Tigshop Java 所有PRO版本仅需微调业务配置即可切换场景B2C单商户、B2B2C多商户、O2O多门店、跨境多语言、S2B2C供应链商城。
