litemall

第一部分：服务器基础环境准备

1. 云服务器，系统 CentOS7.9，SSH 远程登录（FinalShell/Xshell）

# 更新系统，安装基础工具
yum update -y
yum install -y wget git unzip

1. 关闭防火墙（仅测试环境，正式环境放行端口）

systemctl stop firewalld
systemctl disable firewalld

1. 安装 JDK8（必须 JDK8，高版本 JDK 会报错）

yum install java-1.8.0-openjdk-devel -y
# 验证
java -version

1. 安装 MySQL5.7

yum install -y mysql-community-server
systemctl start mysqld
systemctl enable mysqld
# 获取初始密码
grep 'temporary password' /var/log/mysqld.log
# 登录MySQL修改密码
mysql -uroot -p
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的强密码';

第二部分：拉取 litemall 源码

# 拉取源码
git clone https://gitee.com/linlinjava/litemall.git
cd litemall

目录结构： litemall-admin：后台 Vue 前端 litemall-vue：H5 商城 Vue 前端 litemall-wx：微信小程序前端 其余文件夹：SpringBoot 后端模块

第三部分：安装 Maven，编译打包后端

# 安装maven
yum install maven -y
# 在litemall根目录执行打包
mvn clean package

打包成功后，jar 包路径：litemall-all/target/litemall-all-0.1.0-exec.jar

第四部分：导入数据库

1. 源码内 SQL 文件：litemall/sql/litemall.sql
2. Navicat 远程连接服务器 MySQL，新建数据库 litemall，字符集 utf8mb4
3. 执行 litemall.sql，导入基础表、测试商品、管理员数据
4. 记住数据库名、账号、密码，后续配置 yml 要用

第五部分：修改后端配置文件

路径：litemall-all/src/main/resources/application.yml
修改配置项：

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/litemall?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: 你的mysql密码
# 微信支付配置（可选，小程序支付用）
wx:
  app-id: 微信小程序AppID
  app-secret: 小程序AppSecret
  mch-id: 微信商户号
  mch-key: 商户密钥

如果需要对接新中付支付，在这里新增自定义支付配置，然后开发支付接口代码。 修改配置后，重新执行 mvn clean package 打包。

第六部分：启动后端服务

# 后台运行jar
nohup java -Dfile.encoding=UTF-8 -jar litemall-all/target/litemall-all-0.1.0-exec.jar > litemall.log 2>&1 &
# 查看日志
tail -f litemall.log

后端默认端口：8080 访问接口测试：http://服务器IP:8080

第七部分：编译后台管理前端 litemall-admin（Vue）

1. 安装 Node.js 14 版本

curl -sL https://rpm.nodesource.com/setup_14.x | bash -
yum install nodejs -y

1. 进入前端目录

cd litemall-admin
# 安装依赖
npm install --registry=https://registry.npm.taobao.org
# 打包静态文件dist
npm run build

打包完成，dist 目录就是后台管理网页静态资源。

第八部分：Nginx 部署前端 + 反向代理后端接口

1. 安装 Nginx

yum install nginx -y
systemctl start nginx
systemctl enable nginx

1. 将 dist 上传到 /usr/share/nginx/html/admin
2. Nginx 站点配置示例（后台管理）

server {
    listen 80;
    server_name admin.xxx.com; #你的后台域名
    root /usr/share/nginx/html/admin;
    index index.html;

    location /api/ {
        proxy_pass http://127.0.0.1:8080/api/;
    }
}

1. H5 商城前端 litemall-vue 打包，新建 Nginx 站点，同理配置反向代理。
2. 重载 Nginx：nginx -s reload

第九部分：微信小程序前端部署（litemall-wx）

1. 在本地电脑打开微信开发者工具
2. 导入项目：litemall-wx文件夹
3. 修改 utils/api.js，把接口地址改成公网 HTTPS 域名
4. 编译预览；提交审核需要：
   

第十部分：HTTPS 配置（小程序、支付强制要求）

1. 宝塔 /openssl 申请免费 Let’s Encrypt 证书
2. Nginx 配置 443 端口 HTTPS，HTTP 自动跳转 HTTPS
3. 将 HTTPS 接口域名填写到微信小程序后台的 request 合法域名

第十一部分：访问系统 & 默认账号

1. 管理后台地址：https://admin.xxx.com
   账号：admin123 密码：admin123

登录后第一时间修改管理员密码！

1. H5 商城：https://h5.xxx.com
2. 微信小程序：微信开发者工具预览，提交审核后微信内打开

第十二部分：定时任务

litemall 自带简单定时任务，用于超时未支付订单自动关闭，内嵌在 SpringBoot 程序，不需要额外配置 crontab，这点比 mall 简单。