BGP 劫持事件监控台 · 数据 API

静态文件 API(无后端)。基础路径即本站根:https://artifact.luorui.online/i1sdYhp5lrZK/。 所有响应均为 JSON。

1. 目录索引

GET /api/index.json

{
  "api": "v1",
  "generated": "2026-11-04T01:17:40Z",        // 本轮渲染时间(UTC)
  "collections": {                              // 三个集合
    "blog_main": {"total": 8,   "pages": 1,   "dsize": 60},
    "rt_main":   {"total": 400, "pages": 7,   "dsize": 60},
    "rt_other":  {"total": 14260,"pages": 238,"dsize": 60}
  },
  "counts": {"total_events": 14666},
  "idmap": { "<事件id>": {"c": "rt_main", "p": 2}, ... }
}

2. 按集合取事件(分页)

GET /paged/{collection}_p{page}.json

分片按事件起始时间旧 → 新排列,每页 dsize=60 条;p1 最旧,末页最新。 响应结构:

{ "rows": [ {事件对象}, ... ] }
集合含义
blog_main博客报道事件(经 LLM 调查确认)
rt_main实时告警 · 主要事件(过七道门槛,有实锤 VP 曲线)
rt_other实时告警 · 其他事件(门槛未过 / 可见度低 / 证据不足等)

3. 按 ID 取单个事件(两步)

# ① 查目录拿分片位置
curl -s .../api/index.json | jq '.idmap["58.147.135.0-162032"]'
# → {"c": "rt_main", "p": 2}
# ② 取分片, rows 中 id 匹配
curl -s .../paged/rt_main_p2.json | jq '.rows[] | select(.id=="58.147.135.0-162032")'

4. 事件对象结构

字段类型说明
idstring事件 ID(前缀-时分),全局唯一
originstringrealtime(告警源)/ blog(博客源)
statusstring事件状态(confirmed 等)
created / last_updatedISO8601入库 / 最后更新时间
sources[]array来源条目:source / url / title / fetched_at / item_id(= conv 文件名)
conv_ids[]array有存档的调查对话 ID(渲染时生成)
verdictobject判定结果(见下表)
replay[]arrayVP 曲线(每个被劫持前缀一条,见下表)

verdict(判定)字段

字段说明
statusconfirmed / unrelated / insufficient_data
hijack_type六分类:exact_prefix_origin、sub_prefix_origin、 path_manipulation、prefix_squatting、route_leak、benign_anomaly
hijacked_prefixes[]被劫持前缀列表
legit_origin合法 origin:{asn, name, country}
hijacker_asns[] / victim_asns[]劫持者 / 受害者:{asn, name, role, country}
party_relation同组织/关联方判定:{related, kind, evidence}
time_start / time_end / ongoing起止时间(UTC, 分钟精度)与是否进行中
visibility{peak_vps, pct, basis} 峰值可见 VP 数与占比
rpki{hijack_route_status, note} 劫持路由的 RPKI 验证状态
summary_zh中文结论摘要
evidence[]证据链:{tool, fact}
caveats[]存疑点说明
impact_note影响面说明

replay[](VP 曲线)字段

字段说明
prefix / legit_origin该曲线对应前缀与合法 origin AS
window[2]曲线窗口 [起, 止](起至少为 time_start-24h)
first_seen / last_seen劫持路由首现 / 最后可见
baseline{at, vps, hijack, legit} 劫持前基线
peak_vps / n_vps_ever劫持峰值 VP / 窗口内出现过该前缀的 VP 总数
series[]数据点 [ISO时间, 劫持VP, 合法VP, 任意VP],按时间升序; 曲线为降采样(约 300 桶,保留红峰与首尾点)

5. 调查对话与工具轨迹

GET /conv/{item_id}.json — item_id 取事件对象 sources[].item_id 或 conv_ids[]。

{
  "item_id": "582227ca57b2eaac",
  "generated": "2026-11-05T06:18Z",
  "n_turns": 3,
  "turns": [
    { "role": "system",    "content": "调查判定提示词" },
    { "role": "user",      "content": "告警原文 + 事件库 + R 编号证据包(工具结果)" },
    { "role": "assistant", "content": "最终判定 JSON 原文" }
  ],
  "trace": [                                  // 工具调用轨迹
    { "step": 1, "tool": "hijack_replay",
      "args": { "prefix": "84.75.178.0/24", "starttime": "2026-11-04T05:54",
                "endtime": "2026-11-05T06:13", "suspect_asns": [42960],
                "legit_origin": 52025 },
      "ok": true,
      "result": "{ \"prefix\": \"84.75.178.0/24\", ... }" }, ...
  ]
}

trace 条目结构:{step, tool, args, ok, result}。result 为工具返回的 JSON 字符串(与模型所见一致;单条超 9000 字节时截断并标注总字节数)。hijack_replay 例外:其 result 为完整数据、无 9000 截断(2026-11-13 起新数据原生完整;更早存档已于 2026-11-14 完成去截断补全);完整曲线另存于事件对象 replay[]。result 字段自 2026-11-05 起写入;更早存档中缺 result 的条目已离线补齐,按来源带两种标记:rerun:true 表示用保存的参数重跑/重取所得;rebuilt:true 表示 hijack_replay 条目由事件 replay[] 存档重构(曲线、基线、疑似 ASN、首末时间等核心字段完整,n_updates、top_origins 等仅存在于原始返回的次要统计不可还原)。极少数条目因数据源错误未能补齐,保持无 result。

6. 页面控制台 API(同源)

在博客/实时页打开浏览器控制台即可使用(缓存自动去重):

const e = await HijackAPI.getEvent('58.147.135.0-162032');  // 单事件完整对象
const rows = await HijackAPI.list('rt_main', 1);            // 集合+页
const colls = await HijackAPI.collections();                 // 集合清单
const conv = await HijackAPI.conv('582227ca57b2eaac');       // 调查对话+trace(或null)

7. 注意事项