一、需求背景
现网 vty.vip 中国部分区域成功进入约 75%；需合并双池、防扫描、可衡量 KPI。
vty-domain-shield · PRD v2.3 · 2026-09-02
保护品牌域名 · 可落地技术方案
vty.vip 中国区成功进入 ~75% → 新方案目标 ≥88%。Brand 301 → Gate 双检 → 加密 3 域 → 轮询。
→ H5 异常提示截图 Demo（430px 首页/登录 · E-LOAD / E-PROBE / E-RESOLVE 等）
二、总体方案
Brand→Gate→Site 三段；异常空页；正常加密 3 域；App 不经品牌域、非客户端 403。
三~五、分册
运维（301+桶）、技术（接口+探活+SDK）、测试（P0 用例 TC-B/G/R/C/A）。
域名分层
| 角色 | 示例 | 内容 | 主责 |
|---|---|---|---|
| Brand | winbet.com | 禁止 | 运维 301 |
| Gate | go-gate.xx.net | 空页/极简 bootstrap | 技术双检 |
| Site | play-a.com | 完整业务 | 技术+运维 CDN |
| Share | s-xx.com | 解析跳转 | 技术 |
KPI 目标
| 指标 | vty.vip 基线 | 新方案目标 |
|---|---|---|
| 中国区全链路成功进入 | ~75% | ≥ 88%（稳定 30 天） |
| 品牌首跳 301 | ~80～85% | ≥ 95% |
| 单省最低 | < 60% | ≥ 78% |
主流程（H5）
winbet.com ─301─→ Gate（IP✓ 且 指纹✓）
├─ 异常 → 200 空页
└─ 正常 → Resolve 加密 [d1,d2,d3]
→ 轮询 /__health → 进入 Site
App：跳过 Brand → app/resolve（签名）→ 同上轮询
怎么读
- 运维 → 「运维」分册 + PRD 第三章
- 研发 → 「技术」分册 + PRD 第四章（接口/池合并/探活）
- 测试 → 「测试」分册 + PRD 第五章（P0 用例表）
- 完整版 → 「完整 PRD」或 PRD.html
运维分册
品牌域只做 301；Gate/Site 分桶；禁止品牌绑 Site 源站。
必须交付（O-1 ~ O-10）
- 品牌 DNS → Brand CDN，仅 301 到 Gate，Body 为空。
- URL 桶：bucket-brand（空）、bucket-gate（极简页）、每 Site 独立桶 +
/__health。 - 证书/WAF：Brand GET/HEAD；Gate +POST resolve；Site 常规。
- 监控：非 301、Body 非空、证书到期、探活失败、可用 Site=0。
- 应急：Site 挂不动 Brand；Gate 挂切备用 Gate Location。
自检
curl -sI https://winbet.com/ # 301 + Location → Gate curl -sL --max-redirs 0 https://winbet.com/ | wc -c # 0 或极短
详见 PRD 第三章。
技术分册
Gate 双检 + 加密 Resolve + 统一池 + 探活 Worker + H5/App SDK。
必须交付（T-1 ~ T-11）
- 池合并：单表
site_domain_pool，channels 区分 h5/app。 - gate/resolve：IP+fp 通过 → AES 加密最多 3 域。
- app/resolve：HMAC 签名；浏览器/curl → 403。
- 探活：30s 周期，3 败 disabled + 告警。
- SDK：解密 → 轮询 health → 失败重拉 Resolve。
- 网关：Site API 校验 X-App-Sign。
接口决策（摘要）
| 条件 | 结果 |
|---|---|
| IP 或指纹异常 | 空页，不返回域名 |
| App 无签名 | 403 |
| healthy 域 ≥3 | 加密返回 3 条 |
| healthy 域 = 0 | 503 维护 |
风控、轮询与前端提示（摘要）
| 模块 | 定案 |
|---|---|
| IP | 硬拒绝 5 条 + 评分扣分 10 条；ip_score≥60 通过（§4.3.6） |
| 指纹 | 硬拒绝 8 条 + 评分扣分 10 条；fp_score≥60 通过（§4.3.7） |
| 轮询 | 3 域 HEAD 各 3s → Resolve 重试 3 轮 → 运行期 FAILOVER（§4.6） |
| 前端文案 | E-LOAD / E-PROBE / E-RESOLVE 等 i18n 定稿（§4.10）；截图 Demo |
| 参考实现 | js/gate-fp-collect.js · js/gate-ip-check.reference.js |
完整规则见 PRD §4.3、§4.6、§4.10、§4.11。
测试分册
P0 全过方可上线；可直接拆 Jira/禅道。
P0 模块
| 编号 | 焦点 | 期望 |
|---|---|---|
| TC-B1~B4 | 品牌零内容 | 仅 301，无业务页 |
| TC-G1~G4 | Gate 双检 | 正常进站；异常空页 |
| TC-R1~R5 | Resolve+池 | 3 域加密；切换一致 |
| TC-C1~C7 | 客户端轮询 | 自动切域；UI 映射 §4.11 |
| TC-UI1~UI7 | 前端异常提示 | 文案与 Demo 一致 |
| TC-A1~A5 | App | 签名 OK；非客户端 403 |
| TC-P1~P3 | 探活+分享 | 90s 摘除；Share 同源 |
| TC-T1~T3 | 埋点 | brand 可归因 |
验收签字
| 角色 | 焦点 | 签字 |
|---|---|---|
| 运维 | 301 + 桶 + 监控 | |
| 技术 | 接口 + SDK + 探活 | |
| 测试 | P0 全过 | |
| 产品 | 口径 |
完整用例见 PRD 第五章。