项目运行
本页是运行 DaxPay 的总入口,帮你按场景选择最合适的运行方式,并给出前置依赖与启动后的验证方法。
运行方式速览
| 方式 | 适用场景 | 说明 |
|---|---|---|
| Docker Compose | 最快体验、本地联调 | 一条命令拉起 PostgreSQL / Redis / Artemis / 主应用 / 通道子应用,推荐首次试用 |
| 项目构建 | 二次开发、定制部署 | clone 源码后 mvnd / pnpm 编译,适合需要修改源码的场景 |
| 配置说明 | 调整 Profile、端口、数据库、密钥等 | 生产部署与凭证注入必读 |
推荐路径
首次接触 DaxPay 建议直接走 Docker Compose,几分钟即可在本地跑起完整链路。
前置依赖
| 环境 | 版本要求 | 说明 |
|---|---|---|
| JDK | 25+ | Java 运行环境(容器化部署可不装,镜像自带) |
| mvnd | 最新 | Maven Daemon,加速源码编译 |
| Node.js | ^22.13.0 || ^24.0.0 | 前端构建环境 |
| pnpm | >=10.0.0 | 包管理器(强制,禁用 npm/yarn) |
| PostgreSQL | 14+ | 主数据库 |
| Redis | 7+ | 分布式缓存 |
| Apache Artemis | 最新 | JMS 消息队列,用于支付延时通知 |
数据库需提前创建(UTF8 编码,public 模式),库名约定与详细要求见 项目构建 - 数据库准备。
各应用端口
| 应用 | 端口 | 健康检查 |
|---|---|---|
| 主应用 dax-pay-open | 9999 | http://127.0.0.1:9999/actuator/health |
| 通道子应用 dax-pay-channel-one | 20100 | http://127.0.0.1:20100/actuator/health |
| 通道子应用 dax-pay-channel-two | 20200 | http://127.0.0.1:20200/actuator/health |
| Web 运营端(dev) | 6999 | — |
| Web 商户端(dev) | 7999 | — |
| H5 端(dev) | 9500 | — |
| 小程序管理端(H5 dev) | 9000 | — |
| 文档站(dev) | 5173 | — |
Go 版通道
通道子应用另有 Go 版本 dax-pay-channel-one-go,端口同为 20100,与 Java 版二选一,切勿同时启动。
最快路径:Docker Compose
准备好 .env(数据库 / Redis / Artemis / RSA / AES 等凭证,详见 配置说明 - 生产环境变量清单)后:
bash
# 拉起全部服务
docker compose --env-file .env up -d
# 查看主应用日志
docker compose logs -f daxpay-open完整的 docker-compose.yml 编排模板见 Docker 部署。
启动后验证
bash
# 主应用健康检查,预期 {"status":"UP"}
curl http://localhost:9999/actuator/health
# 通道子应用
curl http://localhost:20100/actuator/health启动成功后可访问:
- 主应用控制台输出
应用 'dax-pay-open' 运行成功! - API 文档(dev):
http://127.0.0.1:9999/swagger-ui/index.html - Web 运营端(dev):
http://127.0.0.1:6999 - Web 商户端(dev):
http://127.0.0.1:7999 - H5 端(dev):
http://127.0.0.1:9500