简体中文
首次部署
本页说明在运维面板里从零部署一套 DaxPay 的完整顺序:每一步进入哪个页面、做什么、怎样确认已经完成。重新搭建一套环境也按本页操作;已经部署好的服务器,日常启停和配置修改见日常运维。
部署顺序
登录面板后默认进入「总览」页,左侧侧栏列出全部管理页。首次部署按下表顺序进行:
| 步骤 | 侧栏页面 | 要做的事 |
|---|---|---|
| 第 1 步 | 总览、Docker 管理、扩展源码 | 确认服务器条件,安装 Docker 和 Git |
| 第 2 步 | 全局配置 | 应用内存档位,确认 JVM、构建并发和构建加速源 |
| 第 3 步 | 基础环境 | 部署 PostgreSQL、Redis、Artemis |
| 第 4 步 | 业务环境 | 选择版本与运行模式,下载代码,初始化数据库,准备 IP 数据文件,构建镜像,部署业务系统(演示模式额外拉起 mock 模拟网关) |
| 第 5 步 | 网关管理 | 部署网关,绑定域名,配置 CDN 接入和对外接口 |
前置条件没有满足时,相关按钮不可点击,鼠标移到按钮上会提示还缺什么。下载代码、构建镜像、部署等耗时操作都在后台以任务方式执行,进度和输出在右下角的任务中心查看,切换页面或刷新浏览器不会中断任务。
第 1 步:准备服务器
服务器需要满足:
- amd64 架构的 Linux,内存至少 4 GB,生产环境建议 8 GB 以上;
- 能访问源码仓库、Docker 镜像仓库和 Maven / npm 依赖源;
- 80 端口没有被其他程序占用(网关用 80 端口对外服务,HTTPS 由外层 CDN 或网关终结,源站不监听 443);
- 生产部署已规划好域名、CDN / HTTPS 接入方式和数据库所需的磁盘空间。
然后在面板中完成三项检查:
- 总览:在系统信息和运行负载中确认内存、磁盘够用;端口检查会列出与网关、业务服务冲突的端口。
- Docker 管理 → 配置:Docker 未安装时点「安装 Docker」,在弹窗中选择安装源和镜像加速器,点「开始安装」。
- 扩展源码 → 代码源:卡片第一行是「Git 环境」。显示已安装和版本号即可;显示未安装时,点同一行的「安装 Git」,确认后面板按发行版自动选用 apt、yum 或 dnf 安装。
Docker 管理页能正常显示引擎信息、Git 环境显示已安装,这一步就完成了。服务器原本已有 Docker 和 Git 时,确认一下即可。
第 2 步:全局配置
打开「全局配置」。页面分两部分:「运行配置」影响所有容器,部署后再修改需要重新部署才能生效,建议部署前先定好;「构建配置」只影响镜像构建,修改后下次构建自动生效。
| 配置 | 怎么选 |
|---|---|
| 内存档位 | 按服务器内存选择紧凑(≥ 4 GB)、标准(≥ 8 GB,推荐)或增强(≥ 16 GB),点「应用档位」。面板会根据宿主机内存推荐一个档位 |
| 运行形态 | Java JVM 选 HotSpot(标准)或 OpenJ9(低内存),影响后端和通道子应用的基础镜像。应用档位时 JVM 会重置为该档位的默认值,需要不同的 JVM 时在应用档位之后再改 |
| 构建并发 | 默认「智能」,按宿主机内存决定同时运行几个构建容器;低配机器或有其他业务占用内存的机器,可以固定为「低内存(1 并发)」 |
| 构建加速 | 为 Maven 和 npm 选择下载源,境内服务器选国内源可以明显缩短构建时间 |
各档位的内存分配见配置与排障 - 内存档位。
第 3 步:部署基础环境
打开「基础环境」,在「部署管理」中点「一键部署」。面板会拉取镜像并启动 PostgreSQL、Redis、Artemis 三个中间件。
- 中间件密码由面板自动生成,点「查看密码」可以查看。以后需要改密码时,使用服务卡片「配置」抽屉中的「修改密码」,面板会同步修改中间件本身,并提示重启业务容器;不要手工编辑服务器上的配置文件。
- 中间件端口默认不映射到宿主机,只供业务容器在 Docker 网络内访问。
三张服务卡片都显示运行中,这一步就完成了。数据库初始化和业务部署都依赖基础环境,没有全部运行时先不要继续。
第 4 步:部署业务环境
打开「业务环境」。准备工作集中在页面下半部分的「版本与构建」区,按下面的顺序完成后,再回到页面上方部署。
选择版本与运行模式
在「部署版本」卡中设置:
- 版本选择:「跟随 4.0 分支」使用最新代码,「指定 Release Tag」固定到某个发布版本。
- 运行模式:「生产」装载生产数据集,以 PROD 运行并关闭沙箱;「演示」装载演示数据集,以 DEV 运行并开启沙箱。正式环境选择「生产」。
运行模式决定初始化数据库时装载哪一套数据。数据库初始化之后再切换模式,库里的数据不会跟着改变,只能强制重建数据库(会清空现有数据),所以请先选好模式再初始化。
下载代码
在「项目代码」中点「下载代码」,面板按选定的版本拉取主后端、通道、管理端、H5 和扩展通道的源码,完成后显示「已下载 N/M」。
- 扩展通道仓需要代码源凭据,未配置凭据或没有访问权限时会自动跳过。已下载数比总数少属于正常情况,不影响构建和部署。
- 之后切换版本只会修改配置,需要再点「更新代码」拉取对应版本的源码。
- 卡片上的「逐仓明细」默认收起,展开后逐仓查看克隆状态、当前版本、本地提交(可复制全量哈希)与落后远端的提交数。
准备数据
「数据准备」中的各项都要完成:
- 数据库初始化:点「初始化」,面板按运行模式创建表结构并导入对应的数据集,完成后显示「已初始化」和表数量。初始化之后按钮变为「强制重建」,它会清空现有数据,生产环境不要随意使用。
- IP 数据文件:主后端镜像构建需要 IPv4 和 IPv6 两个 ip2region 数据文件。在面板打开 Gitee 或 GitHub 下载页,浏览器下载后点「上传 .xdb 文件」上传。
- 重置内置超管密码:忘记内置超管
bootx密码时使用,确认框确认后把密码重置为默认值121212(并清除密码错误计数与锁定状态),执行后登录并立即改密。
构建镜像
在「镜像构建」中点「一键构建全部」。主后端、通道子应用、运营端、商户端和 H5 会并行构建;配置了扩展通道凭据时,扩展通道镜像自动加入构建;开通 App 端 H5 站点(见下文 App 端 H5 站点)后,两个 H5 站点镜像也会加入清单。每个镜像也可以单独构建,个别服务构建失败时只重建失败的那个即可。各服务面板标题右侧的徽标标示镜像状态:未构建 / 已构建,以及镜像缺失、镜像待重建、容器待重建等待处理状态。
IP 数据文件没有准备好时,「一键构建全部」不可点击。构建是整个部署中最耗时的环节,耗时取决于构建并发、CPU、内存、网络和依赖缓存。
部署业务系统
镜像、数据库和 IP 数据文件都准备好后,页面上方的「部署业务系统」按钮变为可点击。点击后,面板部署主后端、通道子应用、运营端、商户端和 H5;演示模式下会额外拉起 mock 模拟网关容器(见下文演示模式)。
首次部署会自动生成 RSA、AES 和通道传输密钥,并固定写入运行配置。生产环境不要重新生成这些密钥,否则已经加密的数据可能无法解密。业务容器默认不映射宿主机端口,统一经网关对外访问;需要直连调试时,见配置与排障 - 端口暴露。
页面上方显示「当前运行版本」,后端服务和前端服务的卡片都显示运行中,这一步就完成了。
App 端 H5 站点
业务系统包含「App 运营端 H5」与「App 商户端 H5」两个可选静态站点,开通后可在手机浏览器直接访问运营端与商户端,无需小程序资质与打包。两个站点默认关闭,不影响常规部署。
- 开通入口在移动端管理页对应产品卡的「H5 站点部署」区块,开关带二次确认;关闭会立即移除站点容器,镜像保留;
- 开通后回到「业务环境」页,两个站点随其他服务一起构建镜像与部署,版本跟随业务源码;
- 对外访问经网关绑定对应域名(见网关管理 - 域名绑定);未开通时网关不允许绑定其域名。
演示模式
运行模式在「部署版本」卡中选择,分「生产」与「演示」两档。生产档面向正式业务;演示档面向产品演示与本地体验,选择后按下面的行为部署。
- 数据库:初始化时装载演示数据集
data-demo.sql,演示账号、演示商户与 mock 通道开箱即用; - mock 模拟网关:部署业务系统时自动拉起
daxpay-mock-channel容器,在 Docker 管理的归属列中标记为 demo,业务环境页的服务卡片带「演示」标记;它扮演第三方通道,承接模拟通道的支付、回调与退款; - 扩展源码:状态板追加 basic 组的 mock 组件仓,该仓随业务环境页的一键构建部署,不计入档位徽章;
- 模拟通道:默认可用,不需要真实通道进件即可跑通完整支付链路。
mock 模拟网关自带管理台,默认 HTTP Basic 认证账号与密码均为 mock。在业务环境页 mock 模拟网关卡片的「配置」抽屉中,可以修改认证开关、账号和密码;保存后需要在容器管理中重建 mock 模拟网关容器才会生效,重启容器不生效。
模拟通道与 mock 模拟网关只用于演示、联调和培训,不要暴露到公网:需要从其他机器访问时经网关域名访问,并先修改默认账号密码;mock 模拟网关的端口暴露只支持 off 与 local,不支持 public,详见配置与排障 - 端口暴露。切回生产档并重新部署后,面板不再拉起 mock 模拟网关容器,并会清理残留的演示容器;数据库不会自动换成生产数据集,需要按上文强制重建。
第 5 步:部署网关
打开「网关管理」。网关是一个独立的 nginx 容器,默认使用 80 端口,是整个系统对外的统一入口。
- 在「总览」页签的「部署管理」中点「一键部署」。
- 在「域名绑定」页签填写运营端、商户端、H5、后端 API 和 Artemis 控制台的域名。只填裸域名,不带
http://和路径,不需要的留空。小程序或 APP 需要专用接入入口时,再绑定移动端 API 域名;开通 App 端 H5 站点后可再绑定两个站点的域名。 - 在「CDN / 外层接入」页签选择接入模式。域名直接解析到服务器时选「直连源站」;域名接入了 CDN 或外层网关时选「经 CDN / 外层网关回源」,面板会生成回源 Token,按页面上的清单在 CDN 控制台把它配置为回源头。生产环境推荐经 CDN 回源。回源头配好之前不要点「应用网关配置」,否则各绑定域名的访问会返回 404。
- 在「对外接口」页签核对开关:商户开放 API
/unipay、通道回调/unipay/callback、小程序 / APP API/app-*、对外开放接口/client/默认开启,易支付兼容接口/epay默认关闭,按需调整。 - 点「应用网关配置」,面板生成 nginx 配置并重新加载。
以后修改域名、接入模式或接口开关,点「应用网关配置」即可,不需要重新部署网关。各页签的完整说明见网关管理。
部署完成后检查
- 「总览」页中基础环境和业务系统的服务卡片都显示正常运行。
- 通过绑定的域名能打开运营端、商户端和 H5。
- 通过后端 API 域名能访问开放接口。
- 任务中心没有失败的任务,业务日志和网关日志没有持续出现的错误。
- 正式环境到「业务环境」页查看顶部的「环境形态」条:运行模式为「生产(PROD)」,沙箱和超管均为「关」,并且没有不一致提示。
部署中遇到报错,先在任务中心打开失败任务的日志查看原因,常见问题见 FAQ - 一键部署与运维面板。