VTY 品牌域名防护产品需求文档

说明： 本文档仅描述 产品需求、流程、判断逻辑与验收标准。接口、加密、SDK、部署等 由技术团队自行设计，不在本文范围。

范围（必读）： 本文 只 规范用户通过 品牌域名 在 PC 浏览器 / H5 浏览器 进入主站的流程。App 客户端 与 分享域名（分享短链、分享落地域等）均不在本文范围，维持现网，不做产品变更。

一、需求背景

1.1 为什么要做

VTY 对外使用 品牌域名（如 winbet.com）投放广告、口碑与物料。真正承载业务的是 可轮换的主站域名（如 play-*.com），会因区域封锁、投诉、扫描等原因失效。

现网问题（以 vty.vip 为参考）：

1.2 产品目标

1. 品牌域干净：用户与监管扫描品牌域时，看不到登录、钱包、赛事等业务页。
2. 落地判定：在 落地中间域 完成 风控判定（黑名单 / 刷机 / 脚本等，§3.3.1）；不通过则在落地域拦截，不进入主站。
3. 动态主站：判定通过后，下发 加密的、最多 3 条 可用主站域名；客户端 探活后进入 第一条可用域。
4. 主站可换、品牌不换：主站域被封可切换；品牌域尽量不因连带被标危险。

1.3 成功指标（产品 KPI）

88%统计口径、探活定义、备用机制、参数继承和埋点要求见十一、产品规则及评审确认项。

二、需求边界

2.0 范围一句话

只涉及品牌域名（PC + H5）；不涉及 App；不涉及分享域名。

2.1 本次包含（In Scope）

2.2 本次不包含（Out of Scope）

2.3 角色分工（产品视角）

三、具体需求

3.1 域名角色（产品定义）

3.2 品牌域 → 落地域（运维 301）

3.3 落地域判定与动态主站

3.3.1 异常访问 · 产品定义

以下情况一律视为 异常，落地域 空页，不进入主站（对用户无业务文案）：

• 命中任一项 → 异常，落地域空页
• 均未命中 → 不因风控项拦截，继续频率限制、探活等后续流程

3.3.2 判定标准 · 技术补充

本需求不限制刷机识别、脚本识别和设备标识采集的具体实现方式。可识别范围、判断规则、接口字段及阈值由研发评审确认；验收重点为命中异常规则后展示空页，且不下发主站域名。

3.3.3 探活与异常表现 · 产品规则

3.3.4 需求编号索引

3.4 主站进入后

3.5 涉及端（仅以下两端）

四、涉及范围

4.1 页面与系统

4.2 用户入口

✓ 本次唯一产品变更入口：
    PC 浏览器 / H5 浏览器 → 打开 【品牌域名】

✗ 明确不涉及：
    App 任意入口
    分享域名 / 分享链接任意入口

4.3 文案与语言

中越文案对照

五、注意事项

1. 品牌域永不挂业务：任何「救急把首页挂回品牌域」禁止。
2. 落地域不是主站：落地域 不得 出现投注、钱包、完整首页。
3. 失败不暴露主站：判定失败阶段，用户 不应 在地址栏或文案中看到 play-*.com。
4. 主站可牺牲：单个主站域被封 允许 换池内其它域；品牌域不应连带失效。
5. PC 与 H5 流程一致：差异仅在 布局，流程与判断 相同。
6. 异常访问统一处理：黑名单、刷机、脚本/自动化 等风控命中，均 空页、不进主站（见 §3.3.1）。
7. 黑名单口径：「IP / 设备异常」首先指 后台黑名单命中；非泛指网络故障或终端型号不支持。
8. 刷机 / 脚本：产品要求 直接当异常；如何识别 由技术补充（§3.3.2），对用户 不展示 「刷机」「脚本」等字样。
9. 范围外系统不动：App、分享域名 相关能力与流程 不在本文修改；若有关联需求需 单独立项。

六、逻辑判断

6.1 判定顺序（产品规则）

1. 用户是否从品牌域 301 到达落地域？（运维保障）
2. 落地域风控判定（产品规则，识别方式见 §3.3.2 技术补充）：
   a. 当前 IP 是否命中 【后台 IP 黑名单】？
   b. 当前设备是否命中 【后台设备黑名单】？
   c. 是否为 【刷机 / Root】 等高风险终端？
   d. 是否为 【脚本 / 自动化 / 爬虫】 访问？
3. 是否触发 **频率限制**（R-L7）？
   → 风控命中：停止，落地域 **空页**（E1），不下发主站
   → 频率命中：停止，落地域 **全屏**「访问过于频繁」（E6），不下发主站
4. 风控与频率均通过：下发加密动态主站列表（≤3 条）
5. 按顺序探活主站（§3.3.3）
   → 有可用：跳转主站首页/登录
   → 全无可用：落地域 **全屏**「暂时无法连接」（E4），可重试
   → 接口或返回数据异常：落地域 **全屏**「加载失败」（E5），可重试

6.2 判断结果与用户体验

6.3 谁做什么（产品决策表）

七、流程

可视化： flow/index.html — PC / H5 页面截图式 分步说明。

7.1 PC 打开品牌域（总览）

步骤1  用户 PC 浏览器输入/点击 winbet.com
步骤2  【运维】品牌 CDN 301 → entry.vty.net（落地域）
步骤3  落地域：显示「正在连接最佳线路…」
步骤4  落地域：风控判定 + 频率检查（识别标准见 §3.3.2）
       ├─ 风控命中（黑名单/刷机/脚本）→ 空页（E1）
       ├─ 频率限制 → 全屏「访问过于频繁」（E6）
       └─ 通过 ↓
步骤5  落地域：获得加密动态主站列表 → 解密 → 依次探活
       ├─ 某条可用 → 步骤6
       └─ 均不可用 → 落地域全屏「暂时无法连接」
步骤6  浏览器跳转到 play-x.com 主站首页（完整业务）
步骤7  之后主站故障 → 现有动态域名切换（不变）

7.2 H5 打开品牌域（总览）

与 §7.1 逻辑完全相同。差异：

7.3 流程与截图对照

八、异常场景描述

8.1 落地域阶段（报错在落地域）

表现分级： 风控命中（E1）= 空页；频率 / 探活 / 接口失败 = 全屏报错。二者不可混用。

8.2 主站阶段（进站后 · 沿用现有）

8.3 产品禁止表现

• 判定失败时展示 主站域名 或「域名池」字样
• 风控命中时用 全屏报错 代替 空页（E1 必须空页）
• 对用户展示「刷机」「脚本」「黑名单」「指纹异常」等 内部原因
• 判定失败时用 业务首页 壳子展示赌博/钱包内容
• 品牌域出现 200 业务页

九、产品验收标准

9.1 品牌域（运维 + 产品联合）

9.2 落地域

9.3 主站与范围外（回归）

9.4 KPI 验收（上线 30 天后）

9.5 签字

十、评审检查清单

评审时可按本清单 逐项勾选，确保逻辑闭环、范围清晰、可验收。

10.1 范围与边界

10.2 核心流程

10.3 风控与异常（重点）

10.4 角色与交付

10.5 成功标准

十一、产品规则及评审确认项

本章汇总已经明确的产品规则，以及需要研发、运维在评审会上确认的实现项。用户流程和异常表现按本文验收，具体技术实现以评审结论为准。

11.1 落地域失效后的备用机制

当前规则

产品说明

正常：  品牌域 ──301──► 主落地域 ──风控/探活──► 主站
失效：  品牌域 ──301──► 备落地域 ──同逻辑──► 主站
禁止：  品牌域 ──301──► 主站（常备）
禁止：  品牌域 ──挂业务页──► 用户

备落地域与主落地域 产品逻辑完全一致（风控、加密下发、探活、异常态）。

11.2 品牌域名原始参数如何继承到主站

当前规则

示意

用户打开：
  https://winbet.com/promo?utm_source=fb&invite=abc

301 后落地域（示意）：
  https://entry.vty.net/?from=winbet&_raw=...   ← 或等价透传方式（技术自定）
  产品要求：落地域能还原 path=/promo 与 query

跳转主站：
  https://play-a.com/promo?utm_source=fb&invite=abc&from=winbet

实现上可用 query 展开、短 token 兑换等，产品只验收主站最终 URL 含原业务参数。

11.3 主站探活 · 业务定义与跳转 P95

探活成功（业务定义）

整体跳转耗时（产品 SLA）

多数用户应 首条探活成功；P95=5s 已覆盖「风控+下发+1 次探活」。三条串行最坏可超过 5s，属尾部，用 P99/告警观察，不放宽 P95。

11.4 88% 成功进入率 · 分子分母 / UV / 风控排除 / 误杀恢复

统计维度

分子与分母

风控排除规则（谁不进分母）

辅助指标（必报，不替代 88%）

风控误杀正常用户的恢复机制

11.5 上线后埋点 · 如何定位卡在哪一段

六段漏斗（使用同一 trace_id / session_id 串联）

问题定位方式

有 brand_301_ok，无 landing_ready     → 查 CDN / 落地域可用性 / 是否该切备落地
有 landing_ready，risk pass=false     → 查风控 reason（是否误杀）
risk pass，无 domains 成功            → 查域名接口 / 域名池
domains 成功，probe 全失败            → 查主站池质量 / 区域封锁
有 jump_to_site，无 site_home_ready   → 查主站前端/API（非品牌链问题）

必带属性（产品要求）

trace_id、brand、deviceId、端（PC/H5）、国家/地区、risk.reason、探活 index、耗时 ms（各段）。

11.6 评审确认表

文档结束 · 产品需求文档 v1.3