优选 IP 库 API

鉴权：数据接口需要令牌 —— ?token=YOUR_TOKEN 或请求头 X-API-Token / Authorization: Bearer。 /api/health 与本页公开。

格式：IP:端口#备注（备注原样沿用 IP 库里的名字），例如 47.239.49.79:443#HK-AS45102-34.81MB/s

GET /api/ipdb                       完整 JSON
GET /api/ipdb.txt | /ipdb.txt       纯文本(每行一条)
GET /api/regions                    地区汇总
GET /api/region/HK                  单地区
GET /api/random?n=5                 随机抽样
GET /api/sub?base=vless://...&n=5   生成订阅
POST /api/refresh                   强刷缓存(需 X-Admin-Token)

通用参数: ?region=HK,JP &n=10 &offset=0 &active=1 &seq=global &shuffle=1 &format=txt|csv|json
实时同步: ?fresh=1  跳过 60s 边缘缓存立即回源；响应头 X-Data-Fetched-At 为数据拉取时间

→ 直接看 ipdb.txt · → 看 JSON