mirror of
https://github.com/jeequan/jeepay.git
synced 2026-09-03 06:34:47 +08:00
1e58fd5490
目标：门面文档只放"最常用"，把"深水区"分到独立文件，按需查阅。 README（299 → 205 行）： - 合并 "为什么选择 Jeepay" + "适用场景" 为 "Jeepay 适合谁" 一节。 - 删除 "系统能力概览"（信息已在项目简介 + Jeepay 适合谁里）。 - 删除 "快速开始"（环境要求 / 代码获取 / 首次启动流程都在 docs/deploy/* 里更详细）。 - 删除 "在线体验" + "版本与兼容性说明"（前者并入"贡献与协作"尾行， 后者内容已散在 CONTRIBUTING.md / upgrade.md 里）。 - "贡献与协作"段一句话指向 CONTRIBUTING.md，不再重复列清单。 docs/deploy/shell.md（248 → 79 行）：只保留"5 分钟上手 + 常用命令 + 卸载 + 高级覆盖项表"。移除宿主端口冲突详解、HTTPS 反代、RocketMQ 排查、 ARM64 说明等细节段，全部外迁。 docs/deploy/compose.md（218 → 63 行）：目录约定 + 启动命令 + 端口 / 账号 + 常用命令；移除镜像发布章节（对终端用户无用）外迁。 docs/deploy/troubleshooting.md（31 → 132 行）：从 shell.md 吸收 RocketMQ 启动失败、brokerIP 缓存问题、WebSocket 101 卡住、application.yml 变目录、 镜像 403、打包排障现场等排障条目，成为统一的故障诊断入口。 新增 docs/deploy/https.md（88 行）：域名 + HTTPS 反代模板（从 shell.md 搬出），含 nginx 配置示例、certbot 申请命令、第三方支付回调 URL 注意 事项、防火墙建议。 新增 docs/deploy/publish.md（62 行）：Docker Hub / 华为云 SWR 镜像发布 脚本说明（从 compose.md 搬出），只给维护者看。 净删除 528 行，新增 211 行；整体更紧凑，每篇文档聚焦单一主题。
1.9 KiB
1.9 KiB
Docker Compose 部署
适合本地 / 测试环境拉起完整集群（含前端）。
目录约定
jeepay-open/
├── jeepay/
└── jeepay-ui/
前端不在 jeepay 同级时，可在 jeepay/.env 覆盖 UI_BASE_DIR（参考 .env.example）。
启动
cd jeepay
mvn clean package -DskipTests # 编译后端 JAR
docker compose up -d --build # 首次：编译镜像 + 启动
docker compose up -d # 后续：跳过编译
docker compose restart payment # 重启某个服务
默认镜像指向华为云 SWR 公开仓库（与 Shell 部署一致），国内零配置直达。
暴露端口
| 组件 | 端口 |
|---|---|
| MySQL | 13306（避开宿主 3306） |
| Redis | 6380 |
| RocketMQ | 9876 / 10909 / 10911 / 10912 |
| payment / manager / merchant | 9216 / 9217 / 9218 |
| 前端 | manager 9227 / merchant 9228 / cashier 9226 |
默认账号
- 运营平台
http://localhost:9227：jeepay/jeepay123 - 商户系统
http://localhost:9228：需运营平台创建商户用户（默认密码jeepay666）
常用命令
docker compose ps
docker compose logs -f --tail=100 payment manager merchant
docker compose config # 启动前变量 / 语法校验
docker compose down # 停止 + 清网络（卷保留）
docker compose down -v # 连同卷一起删
配置说明
- 默认 MQ = RocketMQ；
conf/payment|manager|merchant/application.yml已切到rocketMQ。 - 容器内 MySQL / Redis 主机名 =
mysql/redis（compose 已配 network alias）。 - 改
conf/*.yml后docker compose restart <service>即可。 - 要回到 ActiveMQ / RabbitMQ，需同时改
docker-compose.yml和conf/*.yml。
- 出问题排查：troubleshooting.md
- 推镜像到 Docker Hub / 华为云 SWR（维护者流程）：publish.md