integral-shop/deploy/docker/step1-integral/README.md

# 步骤一：寄卖商城 Docker 部署（池州雷蕾商贸 czleilei240）

项目：`integral-resell`（寄卖商城）  
服务：`redis` · `integral-houtai`（Webman PHP 8.0）· `integral-h5`（Nginx 静态站）

步骤二（积分商城）与本步骤完全独立，可以单独部署、单独重启。

---

## 快速部署

```bash
cd deploy/docker/step1-integral

# 1. 准备环境变量
cp .env.example .env
cp houtai.env.example houtai.env
vim .env          # 填入 REDIS_PASSWORD
vim houtai.env    # 填入 DB_PASSWORD（RDS 密码）、REDIS_PASSWORD（同 .env）

# 2. 首次部署：在服务器上确保宿主机目录存在
#    （若原部署目录已存在则跳过）
mkdir -p /www/wwwroot/leilei.czchunfang.com
mkdir -p /www/wwwroot/leileiadmin.czchunfang.com/public/upload

# 3. 将 H5 静态文件同步到宿主机目录（首次 / 每次前端更新后）
rsync -av integral-resell/h5/ /www/wwwroot/leilei.czchunfang.com/

# 4. 构建并启动
docker compose --env-file .env up -d --build

# 5. 查看状态
docker compose --env-file .env ps
docker compose --env-file .env logs -f integral-houtai
```

---

## 目录映射（宿主机 ↔ 容器）

| 宿主机路径 | 容器路径 | 用途 |
|---|---|---|
| `/www/wwwroot/leilei.czchunfang.com` | `/usr/share/nginx/html` | H5 静态文件，手动改 JS 即时生效 |
| `/www/wwwroot/leileiadmin.czchunfang.com/public/upload` | `/app/public/upload` | webman 后台上传文件 |
| `./houtai.env` | `/app/.env` | 运行时配置，只读挂入，不打进镜像 |
| `integral-runtime`（named vol）| `/app/runtime` | webman PID、session 等运行时数据 |

> **H5 文件更新流程**：直接修改 `/www/wwwroot/leilei.czchunfang.com/` 下的文件（如 JS bundle、configs.js），  
> Nginx 下次请求时自动读取新文件，**无需重启容器**。  
> 仅当 Nginx 配置或镜像本身需要变更时，才需要 `docker compose build integral-h5`。

| 域名 | 用途 | Docker 容器端口 | 宿主机端口 | 宝塔 upstream |
|---|---|---|---|---|
| `leilei.czchunfang.com` | 寄卖商城 H5 | integral-h5:80 | **18080** | `resell_h5` |
| `leileiadmin.czchunfang.com` | 寄卖商城 API / 后台 | integral-houtai:**8785** | **18085** | `resell_api` |

> webman.bin 写死监听 **8785** 端口。  
> - H5 容器内部 Nginx 已将 `/api/` 和 `/upload/` 代理到 `integral-houtai:8785`（Docker 内网，无需暴露）  
> - 宝塔 Nginx 的 `leileiadmin.czchunfang.com` 直连宿主机 **18085**（映射到 webman 8785）

---

## 宝塔 Nginx 配置

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

| 配置文件 | 说明 |
|---|---|
| `deploy/docker/nginx/leilei.czchunfang.com.conf` | H5 站点，upstream → 127.0.0.1:18080 |
| `deploy/docker/nginx/leileiadmin.czchunfang.com.conf` | API 站点，upstream → 127.0.0.1:18085 |

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

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

---

## 验证

| 地址 | 预期 |
|------|------|
| `https://leilei.czchunfang.com/` | 寄卖商城 H5 首页（生产） |
| `https://leileiadmin.czchunfang.com/api/...` | 寄卖商城 API（生产） |
| `http://116.62.83.240:18080/` | H5 直连测试（绕过域名/SSL） |

---

## 常用命令

```bash
# 重启 webman
docker compose --env-file .env restart integral-houtai

# 看 webman 日志
docker compose --env-file .env logs -f integral-houtai

# 进入 webman 容器
docker compose --env-file .env exec integral-houtai bash

# 仅重建 H5（改了 .env 中的域名参数后）
docker compose --env-file .env build integral-h5
docker compose --env-file .env up -d integral-h5

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

# 停止并删除所有卷（慎用：清空上传图片和 runtime）
docker compose --env-file .env down -v
```

---

## 关键一致性检查

| 位置 | 值 |
|---|---|
| `.env` INTEGRAL_API_PUBLIC_URL | `https://leileiadmin.czchunfang.com` |
| `.env` INTEGRAL_H5_PUBLIC_URL | `https://leilei.czchunfang.com/` |
| `.env` INTEGRAL_APP_STR | `ZFyTNQTWEkCBczKzyUDJWE9Ecx260517` |
| `houtai.env` APP_SECRET | **同上** |
| `.env` INTEGRAL_SN_ID | `17533260260517` |
| `h5/static/configs.js` sn_id | **同上** |