平台初始化配置
本篇是完整上线指南的第二阶段:系统已按基础设施以 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 个平台(微信扫码/公众号、支付宝、钉钉、企微、飞书等)。上线依赖链(配置详解见第三方平台登录):
- 端点配置先行:三方回调地址由端点拼出,端点没配抽屉会直接提示;
- 跳转型平台(支付宝/公众号)额外依赖「支付网关前端地址」;
- 开放平台侧登记回调域名,再回平台配密钥。
不启用不影响支付功能。
本阶段核对清单
- [ ] 正式运营管理员账号可登录,角色按职责分配,超管不共用
- [ ] 端点配置四项与部署域名一致,检查按钮全部通过
- [ ] 密码/会话策略已收紧,运营端 2FA 已评估
- [ ] OSS 已配置且桶 CORS 已加,真实上传验证过
- [ ] SMTP 已配置,测试邮件可达
- [ ] 用户协议与隐私政策已发布
- [ ] 站点备案信息已填
下一阶段:支付能力开通。