加密与认证¶
当前实施范围¶
请求/响应保持 JSON 格式,选定的传输加密方式是 HTTPS/TLS。统一 JSON 封装负责描述业务结果;TLS 负责连接中的机密性和完整性。客户端应正常校验证书,不关闭证书校验。
已新增AES 请求与响应加密:使用标准 JWE 的 RSA-OAEP-256+A256GCM,每请求独立随机密钥、独立响应密钥、随机 IV、完整性认证及 Redis 防重放。先通过公钥接口获取公开参数,再在统一网络层加密。当前部署已启用;prod运行配置对约定的JSON范围强制密文,当前dev配置保留App明文JSON兼容,后台JSON业务始终要求JWE。
当前状态(2026-11-20):Budyoo只有一套正式部署环境,目前处于上线前开发和验收阶段,没有独立测试服。官网https://budyoo.cn/已完成公网访问验收,https://www.budyoo.cn/通过308跳转到主域,官网证书覆盖两个主机名。API为https://api.budyoo.cn,后台为https://admin.budyoo.cn/admin/,文档为https://docs.budyoo.cn/docs/,三个域名均可通过公网HTTPS访问;应用实际运行配置仍为dev,App和管理员身份仍独立校验。服务器内TLS主机名校验及14项HTTPS JWE检查已完成,App正式开放、客户端验收和真实供应商接入仍待完成。官网页面当前展示备案号,App备案及App正式开放仍按各自进度维护。上线前清库与初始化计划见接入入口,本次未清库或切换运行配置。
2026-11-20统一媒体协议已部署,服务器完整1390项回归为0失败、0错误、1项条件跳过;发布前备份及校验、应用健康与Nginx检查通过。部署后39项真实公网媒体检查覆盖图片、H.264视频/首帧、缓存及Range、跨账号与后台身份边界、退出及删除后的撤权;另复验HTTPS、动态API不缓存、ESA真实IP与WSS无效票据拒绝。合成账号和正式媒体已清理,暂存仍按签名宽限回收。详见实际验证范围,不将服务器结果扩大为Flutter真机或正式供应商验收。
API、WebSocket与外部服务出口方向¶
2026-11-20官网、管理后台和文档站的公开静态资源已接入static.budyoo.cn并完成部署:248个资源内容比对、15项边缘缓存HIT抽样、三个站点HEAD/Range、HTTPS、后台CSP及独立鉴权拒绝检查通过;浏览器六语官网、后台既有会话恢复和深层文档导航正常。HTML及管理员API保留原域名,私有媒体继续执行原远程鉴权。具体边界和实际验证范围见网站静态资源CDN。
本轮网络方案按 SpekTalk 的实际部署思路记录为:api.budyoo.cn 的 HTTP API 与 /ws/v1/realtime WebSocket 统一接入阿里云 ESA;ESA 只负责边缘接入、动态转发、TLS 和 WebSocket Upgrade,不缓存或改写需要登录的 API 正文。ESA 回源到中国大陆 ECS 的 Nginx,Java 仍只绑定回环地址,公网不恢复 Java 直连。media.budyoo.cn 是独立的对象媒体 CDN,不与 API/WebSocket 共用缓存策略。
2026-11-20接入状态:budyoo.cn的全球、CNAME接入站点已建立,API代理api.budyoo.cn,官网、后台和文档站的公开资源另通过static.budyoo.cn分发。API全域绕过缓存、WebSocket、强制HTTPS、TLS 1.2/1.3、HTTPS 443回源及源站证书校验已配置;智能路由已开启,用户已确认其独立请求费。Nginx已按控制台提供的ESA回源网段配置真实客户端IP信任。边缘证书已签发,有效至2027-02-17 07:59:59,托管续期CNAME已配置。北京时间2026-11-20 00:18已将API权威DNS改为ESA分配的CNAME,公网健康检查返回Server: ESA和UP;不同递归DNS仍可能保留旧记录至缓存到期。media.budyoo.cn继续使用独立CDN;官网、后台和文档站的HTML保留原入口,公开资源通过独立静态域名缓存,管理员API继续同源且不缓存,见网站静态资源CDN。
已核对基础版套餐有效期至2027-11-20 00:00:00,自动续费关闭,每自然月50 GB按套餐规则发放。资源包页面实际显示1 TB的ESA通用流量包,有效期为2026-11-19 23:00:00至2027-11-19 23:00:00;这是整段有效期的总量,并非每月1 TB。此前截图为99元/500 GB组合报价,不能据此认定实际订单额度或付款额。智能路由为0.1元/万次请求,例如100万次约10元,套餐和资源包不能抵扣该请求费;超量流量及ECS费用另计。参考ESA套餐选型、智能路由和ESA套餐费用。
2026-11-20已启用ESA独立日费用提醒:按北京时间每自然日的后付费应付账单,超过50元时通过云监控向现有账号联系人发送短信和邮件;已购年套餐和资源包不重复计入日用量阈值,CDN/OSS各自50元费用预警保持独立。由于费用中心当前没有ESA原生日预警选项,由服务器每天北京时间10:30回看最近七个已结束自然日。账单约延迟24小时,提醒在账单可用后触发,不是实时计费封顶。规则与每日任务已启用,受限账单读取和事件上报检查通过。通知邮箱已按用户指定地址更正并完成激活,控制台已回读确认;未制造超额费用或验证真实费用告警的短信/邮件投递。只告警、不自动停用,ESA用量告警未另行新增。账单口径见阿里云日账单查询。
Google、FCM 及其他外部供应商调用规划走后续香港中转节点,再由中转节点以固定出口访问供应商;它们不经过用户的 API/WebSocket 数据路径。当前仓库没有香港节点地址、路由密钥或中转配置,也没有发现 FCM 客户端实现;Google OIDC、微信 OAuth、Apple DeviceCheck、短信/邮件和可选翻译供应商仍按各自服务配置直连或未启用。香港 ECS 尚未购买,计划在业务开发完成、外部供应商清单和流量确认后再采购。中转节点上线前必须补充固定供应商白名单、mTLS/签名认证、超时与重试、健康检查、审计和费用告警,不能用一个开放代理代替。
DNS解析记录本身不需要另买“DNS”才能完成ESA CNAME接入;香港ECS后续另行采购计费。此次采用默认线路CNAME,国内外API均通过ESA;没有配置“国内直连、海外ESA”的DNS分流。App继续使用原API与WSS域名、路径和身份协议,无需因ESA切换修改接口地址。
2026-11-20验证范围:切换前经ESA通过14项HTTPS JWE检查;切换前后均通过健康检查、API不缓存、未认证拒绝、真实IP及直连伪造头检查、WSS 101和无效票据拒绝,以及隔离票据认证和80秒心跳。公网DNS切换后,15项媒体CDN检查通过,包含合成账号HTTPS/JWE登录、OSS上传确认、有效鉴权、缓存命中、HEAD/Range、无凭证与越权拒绝及退出后凭证拒绝,合成账号已按正常注销流程清理。该验收使用现行dev固定码,不代表短信/邮件真实发送;正式账号的完整WebSocket业务、即时撤销、Flutter真机及海外移动网络仍待验收。
北京时间2026-11-20 00:28,Globalping复用五个境外探测点请求公开健康接口,均返回HTTP 200、Server: ESA、DYNAMIC和UP,TLS证书验证通过。先前德国节点仍返回源站响应,与DNS缓存过渡一致,本次已转为ESA。以下为本次探测的单次耗时,单位毫秒;总耗时包含DNS、TCP、TLS、首字节及下载,不能视作长期平均延迟,也未进行同条件直连速度对比。
| 探测点 | DNS | 首字节阶段 | 总耗时 |
|---|---|---|---|
| 香港 | 68 | 56 | 136 |
| 新加坡 | 502 | 412 | 1288 |
| 日本东京 | 258 | 213 | 486 |
| 美国布法罗 | 1139 | 289 | 1481 |
| 德国法尔肯施泰因 | 1126 | 343 | 1500 |
当前保留dev固定验证码123456和隔离开发身份,手机号/邮箱未接真实发送。prod始终强制HTTPS,拒绝开发挑战及会话;真实供应商另行配置。正常域名接入不需要开启allowInsecureDevelopment或allowInsecureDevelopmentSessions,仅经约定的隔离本地HTTP联调才显式使用开发例外。
TLS保护连接,JWE保护约定范围内的JSON正文;URL、查询串和HTTP头不在JWE保密范围。文件上传、下载及WebSocket仍依赖TLS和原有身份权限,不额外套JSON加密。私有对象存储不提供永久公开URL,不绕过资料审核、参与者或管理员权限。
调用规则¶
App API已统一经过Nginx入口防护,包含按IP秒级限流、整站限流、并发数、请求大小、超时及人工临时IP封禁/到期解封。Java上游只绑定服务器回环地址;这不等同于大流量DDoS清洗。
- 认证数据和敏感业务只通过已验证的 HTTPS 入口发送;客户端不能依赖 HTTP 跳转保护已经发出的请求正文。
- 公共系统信息和声明的认证入口允许匿名调用;本人资料使用真实会话,401/403的含义遵循公共协议。
- 后台接口使用独立服务端管理员认证与权限判断,不能只由页面控制访问。
- 示例不嵌入密码、真实 Token 或业务密钥;日志不输出认证头、用户隐私请求体或密钥。
- 网络超时不表示写入失败;涉及创建、支付等写操作时,在业务定义幂等规则前不自动重试。