integral-shop/deploy/docker/step2-single-shop/README.md

# 步骤二：积分商城 Docker 部署（池州雷蕾商贸 czleilei240）

项目：`single-shop-22`（积分商城）
服务：`redis` · `single-front-api`（Spring Boot）· `single-admin-api`（Spring Boot）
`single-admin-web`（Vue 管理后台）· `single-h5`（uni-app H5）

步骤一（寄卖商城）与本步骤完全独立，可以单独部署、单独重启。

---

## 部署前提：宿主机文件准备

> JAR 和静态文件通过 **bind-mount** 挂入容器，部署前需先把文件放到宿主机对应目录。

### 1. Java JAR（Spring Boot API）

```bash
# 宿主机目录
mkdir -p /www/wwwroot/javaapi/logs/front
mkdir -p /www/wwwroot/javaapi/logs/admin

# 将本地编译好的 JAR 传到服务器（macOS 本地执行）
scp single-shop-22/backend/crmeb-front/target/miao-front-2.2.jar  root@116.62.83.240:/www/wwwroot/javaapi/
scp single-shop-22/backend/crmeb-admin/target/miao-admin-2.2.jar  root@116.62.83.240:/www/wwwroot/javaapi/
```

> 更新 JAR：FTP 替换宿主机文件 → `docker compose --env-file .env restart single-front-api`

### 2. 前端静态文件

```bash
# H5（uni-app）
mkdir -p /www/wwwroot/leilei-jf.czchunfang.com
rsync -a --delete single-shop-22/single_uniapp22miao/unpackage/dist/build/h5/ \
    root@116.62.83.240:/www/wwwroot/leilei-jf.czchunfang.com/
chmod -R 755 /www/wwwroot/leilei-jf.czchunfang.com/

# 管理后台（Vue）
mkdir -p /www/wwwroot/leilei-jfadmin.czchunfang.com
rsync -a --delete single-shop-22/backend-adminend/dist/ \
    root@116.62.83.240:/www/wwwroot/leilei-jfadmin.czchunfang.com/
chmod -R 755 /www/wwwroot/leilei-jfadmin.czchunfang.com/
```

> 更新前端：rsync 同步到宿主机 → 浏览器强刷即可，无需重建镜像或重启容器

### 3. 图片/PDF 目录

```bash
# 与步骤一 H5 Nginx 共享，步骤一已创建则无需重建
mkdir -p /www/wwwroot/leilei.czchunfang.com/crmebimage
```

---

## 快速部署

```bash
cd deploy/docker/step2-single-shop

# 1. 准备环境变量
cp .env.example .env
vim .env    # 填入 RDS_PASSWORD、REDIS_PASSWORD

# 2. 构建镜像（仅 JRE + Nginx，无 Maven/Node，约 2-5 分钟）
docker compose --env-file .env build

# 3. 启动所有服务
docker compose --env-file .env up -d

# 4. 查看状态
docker compose --env-file .env ps
docker compose --env-file .env logs -f single-front-api
docker compose --env-file .env logs -f single-admin-api
```

---

## 域名与端口

| 域名 | 用途 | 宿主机端口 |
|---|---|---|
| `leilei-jf.czchunfang.com` | 积分商城 H5（uni-app） | **18082** |
| `leilei-jfadmin.czchunfang.com` | 积分商城管理后台（Vue） | **18081** |

> Spring Boot API 端口（30032 / 30033）仅容器内监听，不对外暴露。
> 宝塔 Nginx 通过域名反代到 `127.0.0.1:18081 / 18082`，再由容器内 Nginx 转发到 API。

---

## 宝塔 Nginx 配置

将以下两个文件内容分别粘贴到宝塔面板对应站点的「配置文件」中：

| 配置文件 | 说明 |
|---|---|
| `deploy/docker/nginx/leilei-jf.czchunfang.com.conf` | H5 站点，upstream → 127.0.0.1:18082 |
| `deploy/docker/nginx/leilei-jfadmin.czchunfang.com.conf` | 管理后台，upstream → 127.0.0.1:18081 |

证书路径（文件已在项目中）：

```
deploy/docker/ssl-cert/
  leilei-jf.czchunfang.com_cert/nginx/leilei-jf.czchunfang.com.{pem,key}
  leilei-jfadmin.czchunfang.com_cert/nginx/leilei-jfadmin.czchunfang.com.{pem,key}
```

---

## 验证

| 地址 | 预期 |
|------|------|
| `https://leilei-jf.czchunfang.com/` | 积分商城 H5（生产） |
| `https://leilei-jfadmin.czchunfang.com/` | 积分商城管理后台（生产） |
| `http://116.62.83.240:18082/` | H5 直连测试（绕过域名/SSL） |
| `http://116.62.83.240:18081/` | 管理后台直连测试 |

---

## 常用运维命令

```bash
# 重启 Java API（更新 JAR 后）
docker compose --env-file .env restart single-front-api
docker compose --env-file .env restart single-admin-api

# 实时日志（宿主机路径 /www/wwwroot/javaapi/logs/ 也可直接查看）
docker compose --env-file .env logs -f single-admin-api
docker compose --env-file .env logs -f single-front-api

# 进入容器
docker compose --env-file .env exec single-admin-api bash

# 停止（保留卷）
docker compose --env-file .env down

# 停止并删除 Redis 数据卷（慎用）
docker compose --env-file .env down -v
```

---

## bind-mount 目录总览

| 宿主机路径 | 挂入容器路径 | 说明 |
|---|---|---|
| `/www/wwwroot/javaapi/miao-front-2.2.jar` | `/app/app.jar` (front-api) | 用户端 API JAR（只读） |
| `/www/wwwroot/javaapi/miao-admin-2.2.jar` | `/app/app.jar` (admin-api) | 管理端 API JAR（只读） |
| `/www/wwwroot/javaapi/logs/front/` | `/app/log` (front-api) | 用户端 API 日志 |
| `/www/wwwroot/javaapi/logs/admin/` | `/app/log` (admin-api) | 管理端 API 日志 |
| `/www/wwwroot/leilei.czchunfang.com/crmebimage/` | `/usr/local/crmeb/crmebimage/` (两个 API) | 图片/PDF 写入目录 |
| `/www/wwwroot/leilei-jf.czchunfang.com/` | `/usr/share/nginx/html` (h5) | H5 静态文件 |
| `/www/wwwroot/leilei-jfadmin.czchunfang.com/` | `/usr/share/nginx/html` (admin-web) | 管理后台静态文件 |
| `../single-shop/application-docker.yml` | `/config/application-docker.yml` (两个 API) | Spring Boot 配置（只读） |

---

## czleilei240 关键配置对照

| 配置项 | 值 |
|---|---|
| RDS Host | `rm-bp1a178eq62lxba9xbo.mysql.rds.aliyuncs.com` |
| DB / User | `yangtangyoupin` |
| crmeb.imagePath（容器内） | `/usr/local/crmeb/crmebimage/` |
| SYNC_SOURCE_ID | `shop_15` |
| SYNC_TARGET_MER_ID | `15` |
| Spring profile | `docker`（application-docker.yml 通过 env 注入） |

---

## 备注

- JVM 参数已包含 Java 17 + Spring Boot 2.2.6 所需的 `--add-opens` 标志（见 Dockerfile）。
- 图片/PDF 目录 `/www/wwwroot/leilei.czchunfang.com/crmebimage/` 同时挂入 `front-api` 和 `admin-api` 两个容器，确保文件共享。
- Redis 实例（`single-redis`）与步骤一（`integral-redis`）完全独立，数据互不干扰。