宝塔面板部署

面向在宝塔（BaoTa）面板上把 jeepay 作为 Docker 应用一键安装的场景。宝塔用户不需要 git clone 源码，所有配置文件由 compose 里的 jeepay-configs init 容器（alpine/git 镜像）从 gitee 按 tag 拉下来分发。

Compose 文件

位置：仓库根目录 docker-compose.baota.yml
宝塔应用模板引用该文件作为 docker-compose 部分即可

镜像默认地址

所有业务镜像 + MySQL / Redis / RocketMQ / Nginx 默认走华为云 SWR 公开仓库（swr.cn-south-1.myhuaweicloud.com/jeepay/*），由计全官方维护，国内直拉不需要 Docker Hub 加速器。alpine/git（配置分发 init 容器）仍从 Docker Hub 拉（< 20MB，一次性）。

想改回 Docker Hub 上游镜像，可通过下面"可选环境变量"覆盖。

宝塔应用模板要声明的变量

必须

变量	用途	建议默认
`VERSION`	业务镜像 tag（`jeepay-manager` 等）	`3.2.0`
`CONFIG_REF`	配置源 git ref（与 `VERSION` 同版本的 tag 或 `master`）	当前 release tag
`UI_RELEASE`	前端 `html.tar.gz` 的 `jeepay-ui` release tag	`V3.0.0`
`APP_PATH`	宿主部署根目录	宝塔默认
`HOST_IP`	对外绑定 IP	宝塔默认
`WEB_HTTP_PORT1` / `2` / `3`	映射到容器 `19216` / `19217` / `19218`	`19216` / `19217` / `19218`
`CPUS` / `MEMORY_LIMIT`	nginx 资源限制	`1` / `512m`

可选（改镜像源时覆盖）

变量	默认
`MYSQL_IMAGE`	`swr.cn-south-1.myhuaweicloud.com/jeepay/mysql:8.0.25`
`REDIS_IMAGE`	`swr.cn-south-1.myhuaweicloud.com/jeepay/redis:6.2.14`
`ROCKETMQ_IMAGE`	`swr.cn-south-1.myhuaweicloud.com/jeepay/rocketmq:5.3.1`
`NGINX_IMAGE`	`swr.cn-south-1.myhuaweicloud.com/jeepay/nginx:1.18.0`
`MANAGER_IMAGE`	`swr.cn-south-1.myhuaweicloud.com/jeepay/jeepay-manager:${VERSION}`
`MERCHANT_IMAGE`	`swr.cn-south-1.myhuaweicloud.com/jeepay/jeepay-merchant:${VERSION}`
`PAYMENT_IMAGE`	`swr.cn-south-1.myhuaweicloud.com/jeepay/jeepay-payment:${VERSION}`
`JEEPAY_CONFIGS_IMAGE`	`alpine/git:v2.45.2`（Docker Hub）

切回 Docker Hub 整套示例：

MYSQL_IMAGE=mysql:8.0.25
REDIS_IMAGE=redis:6.2.14
ROCKETMQ_IMAGE=apache/rocketmq:5.3.1
NGINX_IMAGE=nginx:1.18.0
MANAGER_IMAGE=jeepay/jeepay-manager:3.2.0
MERCHANT_IMAGE=jeepay/jeepay-merchant:3.2.0
PAYMENT_IMAGE=jeepay/jeepay-payment:3.2.0

安装后怎么改配置

配置文件都在 ${APP_PATH}/jeepayhomes/jeepayConfigs/ 下，直接编辑即可：

jeepayConfigs/
├── db/my.cnf, init.sql
├── redis/redis.conf
├── rocketmq/broker.conf
├── service/{manager,merchant,payment}/application.yml
├── nginx/nginx.conf, conf.d/, html/
└── .latest/        # 最新版模板（只读参考，不要改）

改完重启对应服务：

bash

docker compose restart jeepay-manager
# nginx 改完可热加载
docker exec nginx118 nginx -t && docker exec nginx118 nginx -s reload

jeepay-configs 用 cp -n 铺配置，已存在的文件永远不覆盖，机器重启 / compose up 都不会丢失用户编辑。

升级版本

在宝塔 UI 改 VERSION 和 CONFIG_REF 到新 tag（两者建议同值）
重建应用：宝塔 UI 点"重建"，或 docker compose up -d
.latest/ 目录会同步刷新到新版模板，用户自己的 yml 不动

看 diff 决定是否合并新模板中的新字段：

bash

diff ${APP_PATH}/jeepayhomes/jeepayConfigs/service/manager/application.yml \
     ${APP_PATH}/jeepayhomes/jeepayConfigs/.latest/conf/manager/application.yml

宝塔场景特有的点

不需要 jeepay/jeepay-configs 镜像：从 alpine/git 直接 clone，配置永远跟 git tag 一致
jeepay-configs 容器安装后显示 Exited (0)：正常，一次性 init 容器跑完即退出
baota_net 是宝塔预建网络：compose 里 external: true，不要自己创建

验证

安装完成后检查：

bash

# 8 个业务容器 + 1 个 init 容器
docker ps -a --format "table {{.Names}}\t{{.Status}}" | grep -E "jeepay|mysql8|redis6|rocketmq|nginx118"

# 三个 API healthy
for c in jeepaymanager jeepaymerchant jeepaypayment; do
  echo -n "$c: "; docker inspect --format '{{.State.Health.Status}}' $c
done

# 验证码 / 登录（浏览器访问宝塔映射的 19217 端口）

出问题看哪里

troubleshooting.md：所有部署方式通用的故障排查
https.md：配置域名 + HTTPS 反代（宝塔场景建议在外层再套一层 nginx + 证书）
${APP_PATH}/jeepayhomes/service/logs/：业务服务日志
docker logs jeepay-configs：配置分发是否成功