部署引导
运维面板的「部署引导」适合首次部署或重新搭建一套 DaxPay 环境。六个步骤按依赖顺序在一页纵向展开，各操作按钮按自身前置条件启用（例如镜像未构建时部署按钮不可点）；已经部署完成的服务器，日常启停和配置修改应优先使用日常运维。
部署前检查
开始前确认：
- 服务器为 amd64 Linux，内存至少 4 GB，生产环境建议 8 GB 以上。
- Docker、Docker Compose 和 Git 可用；面板可以在第 1 步协助安装。
- 服务器能够访问源码仓库、镜像仓库和 Maven/npm/Go 依赖源。
- 8060、80 端口没有冲突（源站不监听 443，HTTPS 由外层 CDN / 网关终结）。
- 生产部署已经规划域名、CDN / HTTPS 接入方式和数据库持久化空间。
首次安装面板的过程见安装、升级与卸载，从零开始的最短路径见一键部署。
第 1 步：环境检查
这一阶段准备宿主机和项目源码：
- 检查 Docker、Docker Compose、Git、磁盘、内存和端口。
- 缺少 Docker 时，通过面板提供的安装操作按发行版安装。
- 点击「下载代码」拉取 DaxPay 源码，默认使用配置的代码源。
- 通过实时任务终端观察安装和下载输出；长任务刷新页面后仍可恢复日志。
如果 Docker 安装失败，先在终端确认当前用户有 sudo 权限，并检查发行版软件源是否可访问。不要在 Docker 尚未正常运行时继续镜像构建。
第 2 步：全局配置
全局配置会影响后续构建和运行：
| 配置 | 作用 |
|---|---|
| 内存档位 | 批量设置基础环境、业务服务的资源上限和 JVM 类型 |
| 运行形态 | 选择 HotSpot/OpenJ9 |
| 部署版本 | 选择分支或 Release Tag |
| 构建加速源 | 配置 Maven、npm 下载加速源 |
| 构建并发 | 智能 / 低内存单并发 / 均衡 / 并行四档，决定同时构建的容器数 |
切换部署版本后，在本步的「部署版本」行点击「更新源码」拉取新版本。修改全局配置后，如果已有容器配置产生 drift，必须按提示重新部署对应服务才能生效。
第 3 步：镜像构建
构建前先准备 data/ip/ 下的 ip2region 数据文件。v4 数据可通过面板下载，v6 数据通常需要手动上传。
点击「一键构建全部」会以并行流水线构建全部镜像（后端 Maven 组、Web 双端、H5 多路同时推进）：
- 主后端与通道子应用（含扩展通道，凭据已配置时自动加入，版本跟随业务源码）。
- 运营端与商户端。
- H5 端。
构建耗时取决于并发档位、CPU、内存、网络和依赖缓存。部分服务构建失败时任务终态为「部分成功」，失败清单见任务中心日志，单独重建失败的服务即可，不要反复重建全部镜像。
第 4 步：基础环境
点击「部署基础环境」启动 PostgreSQL、Redis、Artemis 三个中间件。
- 密码由面板生成并写入工作目录配置。
- 默认不把中间件端口映射到宿主机，只允许业务容器通过 Docker 网络访问。
- 需要本机调试时，在「运维管理 → 基础环境」对应卡片临时开启端口映射。
- 修改凭据后要按面板提示重启或重新部署依赖服务。
基础环境必须健康后再初始化数据库和部署业务服务。
第 5 步：服务部署
初始化数据库
执行数据库初始化任务，导入 table.sql 和 data.sql。生产环境不要随意勾选强制重建，因为这可能清理现有表和数据。
部署业务容器
当镜像、数据库和 IP 数据文件均准备完成后，点击「一键部署」启动：
- 主后端；
- 通道子应用；
- 运营端、商户端和 H5 端。
首次部署会生成 RSA、AES 和通道传输密钥。密钥生成后会固化到运行时配置，生产环境不要重复生成，否则已有加密数据可能无法解密。
业务容器默认不映射宿主机端口，统一由第 6 步网关对外提供访问。需要直连调试时，前往配置与排障查看端口暴露策略。
第 6 步：网关接入
部署网关会启动独立 nginx 容器，默认使用 80 端口作为整个系统的对外入口。
域名
可分别为运营端、商户端、H5、后端 API、Artemis 控制台配置域名，另有可选的移动端 API（小程序/APP 专用入口）。填写裸域名，不要带 http:// 或路径。
CDN / 外层接入
网关源站不配置证书，HTTPS 由外侧 CDN / 网关层终结。接入模式两种：
- 直连源站：域名直接解析到服务器，适合未接入 CDN 或临时联调；
- 经 CDN / 外层网关回源：各绑定域名入口只放行带正确回源 Token 的请求，生产环境推荐。
CDN 接入清单与回源 Token 的完整说明见网关管理 - 域名绑定与 CDN 外层接入。
对外接口
网关按路径前缀放行外部请求：商户开放 API /unipay、通道回调 /unipay/callback、小程序 / APP API /app-* 默认开启，易支付兼容 /epay 默认关闭。核对开关状态，并确认来源限制、防火墙和网关域名配置。
域名、接入模式和接口开关属于网关配置，点击「应用网关配置」即可 reload；内存档位等全局配置则需要重新部署容器，两者不要混淆。
部署验证
部署完成后逐项验证：
- 总览页显示基础环境和业务服务健康。
- 通过绑定域名打开运营端、商户端和 H5。
- 通过后端域名访问健康检查或允许的开放接口。
- 检查网关日志、业务日志和任务终端没有持续报错。
- 生产上线前将部署模式从 DEV 切换为 PROD，关闭沙箱和超管，再重启业务容器。
常见失败位置
| 现象 | 优先检查 |
|---|---|
| Docker 安装失败 | sudo 权限、发行版软件源、网络和 Docker 服务状态 |
| 镜像构建失败 | IP 文件、依赖下载源、内存和具体任务日志 |
| 基础环境不健康 | 容器日志、磁盘空间、端口映射和自动生成的凭据 |
| 业务容器反复重启 | 数据库密码、运行时配置、镜像版本和后端日志 |
| 网关访问 404/502 | 域名、接口开关、容器网络、服务健康状态 |
更完整的分阶段处理方法见配置与排障。