阳明区小程序服务器配置要求：域名白名单参数、证书与环境区分说明

小程序前端运行在客户端容器内，出于安全考虑，平台不允许前端直接访问任意网络地址。后端服务要被小程序调用，必须在后台完成域名登记、所有权校验与传输加密等配置。本篇从白名单参数、证书要求、备案主体与环境区分几个角度，说明小程序服务器配置的硬性要求。

一、前端网络请求的安全机制

小程序对网络访问实行白名单制：只有在后台登记过的域名，前端接口才能发起请求；未登记域名在正式环境会被直接拦截。本地开发时可在开发者工具中临时关闭校验用于调试，但该选项不随发布生效，线上版本必须使用登记完成的正式域名。

理解这一机制后，配置工作的主线就很清晰：先确定后端域名，再按用途分类登记，最后完成所有权与证书校验。

二、四类合法域名的用途与填写格式

后台服务器域名分为四类。请求域名承载普通 HTTPS 接口；长连接域名用于 WebSocket 实时通信；上传与下载域名分别处理文件传输；业务域名用于 web-view 组件内嵌网页。每类域名对应不同接口，填写时要按用途归位，不能混用。

域名填写需带协议头，格式规范，末尾不应随意添加斜杠。各类域名每月有可修改次数限制，上线前应规划好域名结构，一次性填齐，避免反复占用修改额度。

三、域名所有权校验文件部署

登记域名时，平台要求在域名根目录放置校验文件，通过公网访问该文件确认域名归属。校验文件必须可经 HTTPS 正常读取，路径不能错放，权限不能拦截。校验通过后，该域名下的接口与资源才允许被小程序访问。

若域名使用了 CDN 或多层代理，需确认校验文件能穿透缓存与回源被访问到，否则校验会一直失败。阳明区的开发团队在部署时应先在浏览器手动访问校验文件地址，确认可打开再提交后台。

四、HTTPS 证书与传输安全

小程序通信强制使用 HTTPS，纯 HTTP 地址无法接入。服务器需部署由受信任机构签发的证书，自签名证书不被认可。除协议外，TLS 版本与加密套件需达到平台要求，建议开启较高版本 TLS 并使用主流套件，过低版本会被拒绝连接。

证书临近到期前应及时续期，证书一旦过期，线上小程序会立即出现接口不通。运维侧可定期检查证书有效期与链完整性，避免部分低版本系统因证书链不全而握手失败。

五、备案与主体一致性

域名上线前必须完成备案手续，备案登记的主体需与小程序主体归属一致或同属一个集团。缺少备案的域名，即便证书与加密配置齐全，也无法在后台通过白名单校验。备案流程先后经过接入商初审与管理局终审，整体周期较长，规划项目排期时应把备案时间预留进去，不要等到开发收尾才办理。

主体不一致是备案与登记阶段的常见退回原因，规划域名时就要确认域名注册主体与小程序主体归属，避免后期转移。

六、开发、体验与线上环境区分

项目通常存在开发、体验、线上三套环境，对应不同域名或接口前缀。配置白名单时要明确哪些域名属于正式环境，避免把测试地址填入生产白名单，导致线上访问到测试数据。版本发布前应核对当前版本实际请求的域名与后台登记项一致。

环境切换可通过接口前缀或环境配置完成，代码中不要硬编码测试地址。上线走查时，重点确认正式包发出的请求都落在已登记域名范围内。

七、接口性能与后端安全基线

除连通性外，后端还需满足基本性能与安全要求。核心接口响应宜控制在较短时间内，静态资源走 CDN 分发，图片压缩并懒加载；高峰期具备弹性扩容能力，数据库做好索引与缓存。安全层面，传输加密，敏感字段存储加密，日志不打印完整敏感信息；登录态由服务端校验，金额类操作在服务端二次复核。把连通配置与安全基线一并落实，后端服务才能长期稳定支撑小程序运行。