Skip to content

首次部署 ​

更新时间:2026/11/17 11:11:35

本页说明在运维面板里从零部署一套 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 接入方式和数据库所需的磁盘空间。

然后在面板中完成三项检查:

  1. 总览:在系统信息和运行负载中确认内存、磁盘够用;端口检查会列出与网关、业务服务冲突的端口。
  2. Docker 管理 → 配置:Docker 未安装时点「安装 Docker」,在弹窗中选择安装源和镜像加速器,点「开始安装」。
  3. 扩展源码 → 代码源:卡片第一行是「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 端口,是整个系统对外的统一入口。

  1. 在「总览」页签的「部署管理」中点「一键部署」。
  2. 在「域名绑定」页签填写运营端、商户端、H5、后端 API 和 Artemis 控制台的域名。只填裸域名,不带 http:// 和路径,不需要的留空。小程序或 APP 需要专用接入入口时,再绑定移动端 API 域名;开通 App 端 H5 站点后可再绑定两个站点的域名。
  3. 在「CDN / 外层接入」页签选择接入模式。域名直接解析到服务器时选「直连源站」;域名接入了 CDN 或外层网关时选「经 CDN / 外层网关回源」,面板会生成回源 Token,按页面上的清单在 CDN 控制台把它配置为回源头。生产环境推荐经 CDN 回源。回源头配好之前不要点「应用网关配置」,否则各绑定域名的访问会返回 404。
  4. 在「对外接口」页签核对开关:商户开放 API /unipay、通道回调 /unipay/callback、小程序 / APP API /app-*、对外开放接口 /client/ 默认开启,易支付兼容接口 /epay 默认关闭,按需调整。
  5. 点「应用网关配置」,面板生成 nginx 配置并重新加载。

以后修改域名、接入模式或接口开关,点「应用网关配置」即可,不需要重新部署网关。各页签的完整说明见网关管理。

部署完成后检查 ​

  1. 「总览」页中基础环境和业务系统的服务卡片都显示正常运行。
  2. 通过绑定的域名能打开运营端、商户端和 H5。
  3. 通过后端 API 域名能访问开放接口。
  4. 任务中心没有失败的任务,业务日志和网关日志没有持续出现的错误。
  5. 正式环境到「业务环境」页查看顶部的「环境形态」条:运行模式为「生产(PROD)」,沙箱和超管均为「关」,并且没有不一致提示。

部署中遇到报错,先在任务中心打开失败任务的日志查看原因,常见问题见 FAQ - 一键部署与运维面板。