自建发卡平台部署清单:域名、容器、数据库与备份
把程序打开只是部署的开始。销售授权码、兑换码的自建发卡平台,还要保证订单可追溯、库存不重复分配、付款通知可持续接收,以及服务器损坏后能够恢复。本文采用单台服务器上的通用架构说明各组件职责,不指定未经核实的软件版本,也不提供不明来源的一键安装脚本;具体命令应配合所选项目的正式文档。
文章目录
先画最小架构,再决定服务器配置
- 访问入口域名与 HTTPS 反向代理
- 业务应用商品、订单、登录与支付通知
- 持久化数据私有网络内的数据库和受控库存
- 后台任务交付、邮件、重试与定期核对
低流量站点可以先采用单机方案,但要知道它存在共同故障点。容器隔离组件,不会让一块损坏的磁盘自动恢复。容量规划应观察真实并发、数据库连接数、库存量和任务耗时,不能只按首页访问量估计。
先确认项目支持的数据库、运行环境、队列和持久化目录。把测试环境与生产环境分开,测试卡密和支付密钥也要隔离,避免一次演练触发真实发货。
域名、HTTPS 与回调入口一起验收
将域名解析到实际入口,验证证书覆盖正在使用的主机名,并设置续期监控。浏览器能打开首页,不代表支付服务可以访问通知地址;代理规则、访问验证和防火墙都可能对机器请求产生不同结果。
为回调入口单独确认方法、请求体大小、超时和响应规则。不要让它跳转到登录页或返回人机验证页面,也不要为了方便把整个后台的访问保护关闭。需要放行时,应只调整必要路径,同时保留后端验签。
后台采用强认证和最小权限,敏感操作要求重新确认。日志应能用内部订单号串起入口、应用和任务处理过程,同时避免记录完整卡密、会话令牌或支付密钥。发生故障时,能够定位到“请求没到”还是“业务未处理”,比反复刷新页面有效。
用可复现的容器配置,而不是手动改运行中的文件
记录镜像来源和经过测试的明确版本或摘要,保留上一版配置。生产环境不要依赖一个随时变化的标签,也不要把宿主机上临时修改的程序当成正式发布。可复现意味着换一台机器后,仍能得到经过验收的同一套应用。
Docker 的生产部署说明建议按生产需求调整绑定、日志和重启策略。可使用独立的生产覆盖配置,但必须先理解合并结果。下列仅为检查命令示例,文件名按自己的项目修改:
docker compose -f compose.yaml -f compose.production.yaml config --quiet
docker compose -f compose.yaml -f compose.production.yaml ps
重启策略不等于服务可用:进程可能正常运行却无法连接数据库。还需要业务健康检查、资源限制和外部告警,避免反复重启把真正错误掩盖掉。
数据库保持私有,持久化目录逐项登记
数据库通常只需要被业务容器访问,不必把数据库端口映射到公网。需要维护时,使用受控管理通道和独立账号。应用账号只授予运行所需权限,结构迁移可以使用单独权限,减少应用漏洞直接演变成整库管理权限的机会。
容器可以替换,订单和库存不能随着容器删除而消失。逐项登记数据库、上传文件、必要的加密材料和任务状态位于哪里。Docker 卷文档解释了卷的生命周期;卷能持久化数据,但仍与宿主存储故障相关,不能自动替代异地备份。
金额保存应明确单位与精度,订单时间统一保存并在界面正确转换。卡密明文展示、导出和客服查看应限制权限。若采用应用层加密,应把解密所需材料纳入受控恢复流程;只备份密文数据库而丢失密钥,依然无法恢复交付。
密钥、容器权限与管理入口一起收紧
支付密钥、数据库密码和邮箱凭据不要写进镜像、公开仓库或工单截图。按组件分配不同凭据,并记录轮换方法。使用 Compose secrets 时,应用必须实际支持从文件读取,而不是仅在配置中声明一个名称。
Docker 的 Compose secrets 指南说明了按服务授权访问的方式。普通文件来源仍需保护宿主文件,不应把声明 secret 理解为原始文件自动加密。备份包中若含凭据,也需要加密和访问控制。
按应用要求尽量减少容器权限,避免使用特权模式,不把 Docker 管理套接字挂给业务容器。OWASP 容器安全清单强调,套接字访问会扩大宿主管理风险。管理面板也不应仅依赖一个不常见端口作为保护。
把交付和通知做成可恢复的后台工作
支付确认、分配库存、发送邮件是不同步骤。数据库中要保留付款事实和待交付任务,即使邮件供应商临时不可用,也不能把已经收到的付款抹掉。任务记录至少应有订单号、处理状态、尝试次数和下一次重试时间。
对可重试错误设置退避和上限,超过上限进入人工处理列表。缺货、金额不符等业务问题不能靠无限重试解决。对外部交付接口使用稳定的业务幂等键,避免任务进程重启后重复开通。
定期核对已付款未交付、长时间处理中和通知持续失败的订单。稳付pay的链上监控达到配置的确认条件后发送回调,但库存分配和数字商品交付仍由商户系统负责。当前商户后台还在开发,对接方式应以实际提供的文档和联系支持为准。
备份必须通过一次隔离恢复证明可用
先确定可接受的数据损失窗口和恢复时长,再决定备份频率。例如每天备份一次意味着故障时可能缺少当天的新订单,并不等于“数据不会丢”。对数据库使用适配引擎的一致性备份方案,不能在写入期间随意复制数据目录后就认定可恢复。
PostgreSQL 的 SQL 导出说明介绍了逻辑备份与恢复方式;实际数据库若不同,应使用它自己的官方流程。备份还应覆盖必要配置、文件和受控密钥,并保留独立位置的副本及保留周期。
恢复演练在隔离环境完成,先禁止真实邮件、真实支付通知和自动交付。抽查最近订单、库存关联、管理员权限和任务状态,再记录恢复耗时。数据库恢复到较早时间点后,要用支付侧记录重新对账,避免把已售出的卡密再次分配。
用失败演练和上线清单收尾
失败场景一:程序升级后新增了数据库字段,直接换回旧镜像却无法启动。回滚不仅是回滚程序,还要确认结构兼容;升级前应验证迁移计划、备份和恢复路径,避免在生产上临时猜测。
失败场景二:应用健康检查一直通过,但任务进程已经停止,客户付款后只能看到“处理中”。应分别监控入口、数据库连接、任务积压和最老待处理时间,而不是只监控首页是否返回成功。
- 域名、证书续期和通知路径已从外部验证。
- 数据库无不必要公网端口,凭据与生产环境分开管理。
- 容器重建后数据仍在,关键目录与版本有记录。
- 重复通知、最后库存、缺货、邮件失败与晚到付款测试通过。
- 备份已在隔离环境恢复,支付记录与卡密状态核对一致。
- 明确升级负责人、告警接收人和人工交付流程。
先以少量商品和受控订单观察,再逐步放量。自建的价值是可以理解并控制整个交付过程,也需要为它安排持续维护时间。
参考资料与技术文档
以下官方资料用于核对协议及实现原理。文中代码与场景用于技术解释,具体环境和正式接入协议应分别验证。