Skip to content

平台初始化配置 ​

更新时间:2026/10/15 12:07:28

本篇是完整上线指南的第二阶段:系统已按基础设施以 PROD 形态运行,现在把平台自身配置到可运营状态。每个配置域说明是否必须、不配的后果、配置入口与详情链接,字段级操作见对应文档。

菜单均指运营端(管理端)。商户侧配置在商户开通阶段处理。

配置域速览 ​

配置域必须不配后果详情
运营管理员账号必须无人可安全登录运营端用户管理
端点配置必须跳转、回调、登录回调地址全部错误支付平台配置
系统安全策略强烈建议默认宽松:密码永不过期、会话不限时系统安全配置
存储配置(OSS)强烈建议文件上传类功能全不可用存储配置
邮件(SMTP)强烈建议邮箱找回密码、验证码不可用通知与邮件
用户协议强烈建议登录页协议空态,合规缺口用户协议
站点配置按需页脚缺备案信息(对外站点建议配)支付平台配置
三方登录按需不影响支付;依赖端点配置先行第三方平台登录
敏感词 / 字典默认即可保持默认即可,一般无需动敏感词管理

账号与权限 ​

生产环境的账号基本要求(操作细节见用户管理与权限与菜单管理):

  • 创建正式运营管理员账号并分配角色与菜单权限,日常只用它登录。开发超管(enable-admin=false)在 PROD 已强制关闭,bootx 账号仅 dev 可用;
  • 不要共用内置超管(administrator 不可编辑/封禁),按职责建独立角色(建议复制内置角色再裁剪,不要直接改内置角色);
  • 角色规划建议至少分:运营管理员(全量)、风控/客服(订单与日志只读)、只读审计。

每次系统升级后必须执行一次「同步权限码」(菜单管理页):不执行则新版本新增的按钮权限对已授权角色不可见。升级时的完整步骤见上线验收与运维交接。

端点配置 ​

菜单路径:系统管理 → 系统配置 → 平台配置 → 端点配置

端点配置是全系统对外地址的真相源,生产要求(字段说明与检查按钮见支付平台配置):

端点生产要求不配/配错后果
支付网关前端地址与 H5 网关部署域名严格一致,HTTPS收款链接、支付结果回跳 404;微信/支付宝授权回调失败
后端 API 地址公网可达 HTTPS(通道回调依赖)通道回调进不来,订单停在待支付
管理端访问地址运营端实际域名三方登录 client=admin 时回调地址错误
商户端访问地址商户端实际域名三方登录回调、跨端跳转错误

配置后用每个地址旁的「检查」按钮验证(后端 API 走部署自检探针)。

这类问题先查端点配置

「页面跳 404」「回调收不到」「三方登录跳转异常」这类问题,先核对端点配置与实际部署域名是否一致,再看支付网关域名契约。

系统安全策略 ​

菜单路径:系统管理 → 系统配置 → 系统安全配置

策略默认偏宽松(便于首次体验),生产必须人工收紧。默认值与收紧建议(配置项详解见系统安全配置):

面板默认宽松点生产建议
密码策略轮换周期 0=永不过期、历史记录 0=不限按合规要求设轮换周期与历史限制;最小长度 ≥8
登录安全失败锁定与验证码阈值默认可用保持开启,验证码阈值 ≤ 锁定阈值
会话管理最大活跃时长 0=不限设上限;并发超限策略按业务选(推荐「踢出最早」)
双因素认证默认关运营端账号建议开启(用户在个人中心绑定 TOTP)
通行密钥默认关按需;依赖 HTTPS,且改站点域名会使已绑密钥全部失效
防重放校验默认关开启后商户请求须带随机数与时间字段。开放给外部商户前先评估对方接入成本,详见支付安全与风控

注意区分:这里的「防重放」属于 IAM 登录/API 层安全;支付域的风控在支付能力 - 支付安全与风控。

存储配置 ​

菜单路径:系统管理 → 系统配置 → 平台配置 → OSS 配置

平台文件统一走 S3 兼容对象存储,没有本地存储兜底。不配置的后果:站点素材、对账单、导入导出等一切文件上传/下载功能不可用(核心支付不受影响)。

上线两个高频坑(配置详解见存储配置):

  • 桶必须配 CORS 跨域规则:上传是「浏览器预签名直传」对象存储,「测试连接」通过≠能上传,CORS 漏配是上线后上传失败的常见原因;
  • 单桶方案使「私有」名义化:生产建议公开桶 + 私有桶分开建,公开桶设公共读。

邮件配置 ​

菜单路径:系统管理 → 系统配置 → 平台配置 → 邮件配置

SMTP 不配的后果:邮件全链路不可用,邮箱找回密码通道关闭(登录页找回入口会给提示)、邮箱绑定/解绑验证码全部发不出;账号密码登录不受影响。面向商户开放的部署建议配好,保存后发一封测试邮件验证(配置字段见通知与邮件)。

用户协议 ​

菜单路径:系统管理 → 基础数据 → 用户协议

未配置时登录页协议为空态、登录不受影响,但对外运营属合规缺口:上线前把《用户协议》《隐私政策》的当前语言版本发布(草稿不生效)。注意「同协议同语言只有一个生效版本」,新版本发布不会强制已同意用户重新确认,重大变更需配合公告(见用户协议)。

站点配置 ​

菜单路径:系统管理 → 系统配置 → 平台配置 → 站点配置

系统名称、Logo、ICP/公安/支付清算/增值电信备案号、版权信息。对外运营的站点必须展示备案号(页脚渲染依赖此配置),与域名备案信息保持一致。

三方登录(可选) ​

菜单路径:系统管理 → 系统配置 → 第三方平台

内置 11 个平台(微信扫码/公众号、支付宝、钉钉、企微、飞书等)。上线依赖链(配置详解见第三方平台登录):

  1. 端点配置先行:三方回调地址由端点拼出,端点没配抽屉会直接提示;
  2. 跳转型平台(支付宝/公众号)额外依赖「支付网关前端地址」;
  3. 开放平台侧登记回调域名,再回平台配密钥。

不启用不影响支付功能。

本阶段核对清单 ​

  • [ ] 正式运营管理员账号可登录,角色按职责分配,超管不共用
  • [ ] 端点配置四项与部署域名一致,检查按钮全部通过
  • [ ] 密码/会话策略已收紧,运营端 2FA 已评估
  • [ ] OSS 已配置且桶 CORS 已加,真实上传验证过
  • [ ] SMTP 已配置,测试邮件可达
  • [ ] 用户协议与隐私政策已发布
  • [ ] 站点备案信息已填

下一阶段:支付能力开通。