Skip to content
adream2Public

About

一个可利用 Cloudflare Workers 搭建的 IP 查询工具

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

CFIP · IP 地址详细信息查询工具

CI Deploy License: MIT Cloudflare Workers

基于 Cloudflare Workers 的 IP 与网络诊断工具:查询任意 IPv4/IPv6(或留空查本机)的归属地、运营商、ASN、节点归属(云厂商/CDN、托管 vs 住宅、Anycast、原生 vs 广播 IP)、反向解析、DNSBL 黑名单、代理/VPN/Tor 识别、RDAP 注册信息;并内置浏览器侧诊断(连通性、WebRTC 泄漏、指纹、测速)与基建查询(ASN、批量 IP、DNS 对比、MTR、子网计算器)。

  • 零密钥可用:所有默认数据源均无需 API Key
  • 多源聚合 + 字段级优先级合并 + 单源熔断降级 + 多源位置对比
  • 内置工具箱分四组:网络诊断 / 隐私与指纹 / 查询工具 / 平台状态
  • 浏览器侧诊断全部在本地完成,不上传数据;测速用自建端点,不依赖第三方测速站
  • 结果可导出:复制 JSON、复制 Markdown 诊断报告、下载 JSON(全部本地生成)
  • PWA:可安装 + 离线壳(HTML network-first,静态资源 stale-while-revalidate)
  • SEO / GEO 就绪:canonical + OG/Twitter + JSON-LD(WebSite/SoftwareApplication/FAQPage)+ robots.txt / sitemap.xml / llms.txt,AI 爬虫显式放行
  • 前端除主动触发的诊断外不发起第三方请求:内联 SVG 地图、localStorage 查询历史、无 CDN 无统计脚本(统计/广告为可选项,默认关闭)
  • 6 小时结果缓存(Cache API),共享出口限流友好
  • 隐私:不记录查询日志、不建查询数据库,仅缓存

界面与 API

端点 说明
/ 浏览器 → 中文单页;命令行(curl/wget) → 纯文本摘要
/api[?ip=] 统一 JSON(CORS 全开)
/ip[?ip=] 纯文本 IP 地址(脚本友好)
/api/probe 出口探测:各 AI/云服务视角的 Worker 出口 IP 与可达性
/api/domain?domain= 域名工具箱:DoH 解析 + CDN 识别 + RDAP WHOIS
/api/dns?domain=&type= 多解析器 DNS 对比:5 个公共 DoH 并发查询 + 一致性判定(污染/区域调度)
/api/ping?target=&type= 全球 Ping / MTR(Globalping,ping/http/dns/mtr,匿名 250 次/h)
/api/asn?asn= ASN 查询:AS 名称、宣告前缀、上下游邻居(RIPEstat)
/api/bulk?ips= 批量 IP 地理查询(GET 逗号分隔 / POST 文本体,最多 20 个)
/api/speed?bytes= 测速:GET 返回指定字节(默认 1 MiB,上限 10 MiB);POST 返回接收字节数
/api/status 服务状态聚合(Cloudflare/GitHub/OpenAI/Anthropic)
/api/site-config 统计/广告配置(来自 Workers 变量,空值表示未启用)
/robots.txt 抓取规则(放行搜索引擎与 AI 爬虫,屏蔽 /api、/ip)
/sitemap.xml 站点地图(域名随请求或 SITE_URL 自适应)
/llms.txt 面向 LLM / AI 搜索的站点摘要(GEO)
?ip=example.com *(规划中)域名先经 DoH 解析再查询
curl https://<your-worker>.workers.dev/api?ip=8.8.8.8
curl https://<your-worker>.workers.dev/ip
curl -s https://<your-worker>.workers.dev/api/probe | head -30   # 出口探测
curl -s https://<your-worker>.workers.dev/api/domain?domain=github.com | head -30
curl -s https://<your-worker>.workers.dev | head -20   # 纯文本摘要

JSON 按分区组织:location / network / node / reputation / connection(仅自身查询)/ comparison(多源位置对比)/ meta(数据源状态、耗时、warnings)。判定类字段(如 node.hosting、node.ipType)带 confidence 与 source,node.ipType.reasons 列出判定依据。

数据源

来源 提供 Key 限流 失败行为
request.cf 连接层信息(HTTP/TLS/RTT/colo,仅自身查询) 否 无 字段级防御读取
ipwho.is(主) 地理全套、ASN/ISP/ORG、代理识别、托管识别 否 1000/天 降级 ip-api
ip-api.com(二级) 地理、ISP/ORG/AS、移动/托管/代理、rDNS 兜底;/api/bulk 批量兜底(100 个/次) 否 45/分钟 · 批量 15/分钟 ENABLE_IPAPI=false 可关
ip2region 离线库 国内中文省/市/运营商(xdb 随 Workers Assets 部署,仅 IPv4) 否 无 缺数据时 warning,中文归属退化为在线源
RDAP(rdap.org 引导) 网段 CIDR、RIR、注册国家、注册时间、滥用投诉邮箱、用途类型 否 无 失败降级 RIPEstat whois,仍失败才留空
Cloudflare DoH rDNS 反解、5 个 DNSBL 黑名单(含命中原因 TXT)、域名解析 否 无 rdnsError / 空记录
公共 DoH ×5 /api/dns 多解析器对比:Cloudflare / Google / AdGuard / AliDNS / DNSPod 否 无 单源失败不影响整体
RIPEstat AS 名称/宣告状态、宣告前缀、上下游邻居(/api/asn) 否 无 warnings 记录失败项
公共 STUN WebRTC 泄漏检测(浏览器侧直连 stun.cloudflare.com / stun.l.google.com) 否 无 仅 mDNS / 内网候选
bgp.tools ASN 名称/描述/注册国家(已知 ASN 时触发) 否 无 忽略
Globalping 全球分布式探针(ping/http/dns 测量,/api/ping) 否 匿名 250 次/h 429 时提示稍后再试
Statuspage(CF/GH/OpenAI/Anthropic) 服务状态聚合(/api/status) 否 无 字段置空
ipinfo.io(可选) 加强地理/代理识别 IPINFO_TOKEN 5 万/月 无 secret 不注册
AbuseIPDB(可选) 滥用评分/举报数 ABUSEIPDB_KEY 1000/天 无 secret 不注册

关于共享出口限流:Worker 出站请求对上游显示的是 Cloudflare 共享出口 IP,ipwho.is / ip-api 的配额可能被多方共用。缓解:6h 缓存 + 多源降级链 + 连续失败熔断(60s 跳过窗口)+ 无限制骨干源(RDAP / DoH);bgp.tools 从 CF 出口可能返回 403,属已知限制。

ip-api.com 免费档禁止商业用途,本项目仅将其作为二级降级源并保留 attribution;商业用途请购买其 Pro 或设 ENABLE_IPAPI=false。

部署

1. 克隆与安装

git clone https://github.com/adream2/CFIP.git && cd CFIP
npm install

2. 国内归属数据(ip2region,零配置)

public/data/ip2region_v4.xdb(约 11MB)作为 Workers Assets 随代码一起部署,Worker 经 ASSETS 绑定按需加载(模块级记忆化,每 isolate 一次)——无需 KV、无需手动上传。更新数据:

GH_TOKEN=<有 Contents 写权限的 PAT> npm run xdb:sync

Workers Assets 单文件上限 25 MiB(Free 同等待遇),11MB 的 xdb 放得正好。IPv6 离线数据(v6 xdb)因体积超出公共 CDN 单文件限制未内置;IPv6 查询的地理/网络/信誉数据由在线源完整覆盖,功能不受影响。

3. 本地验证

npx wrangler dev
curl "http://localhost:8787/api?ip=114.114.114.114"
curl "http://localhost:8787/api/probe"
npm test          # 213 个测试(ip/ip-type/calc/diag/merge/xdb/render/inject/seo/tools/dns/asn-bulk/adapters/handler 集成)

4. 部署

npx wrangler deploy

或推送 GitHub 自动部署(见下)。

5. GitHub Actions 自动部署

  1. 建仓库并推送代码
  2. Cloudflare Dashboard → My Profile → API Tokens → 创建令牌,权限选 Account.Workers Scripts:Edit(最小化)
  3. 仓库 Settings → Secrets → 添加 CF_API_TOKEN
  4. push 到 main 即自动:类型检查 → 测试 → wrangler deploy

可选 secrets:IPINFO_TOKEN、ABUSEIPDB_KEY(配置后在 deploy.yml 取消注释对应段落,或手动 npx wrangler secret put <NAME>)。

配置项(wrangler.toml [vars])

变量 默认 说明
CACHE_TTL_SEC 21600 查询结果缓存(6h)
DNSBL_TTL_SEC 3600 黑名单缓存(1h,变化快)
ENABLE_IPAPI true ip-api.com 降级源开关
UPSTREAM_TIMEOUT_MS 6000 单源超时
HEAD_INJECT 空 注入到 HTML <head> 的原始片段(搜索引擎验证 meta 等),空 = 不注入
SITE_URL 空 站点绝对地址,用于 canonical / og:url / sitemap;空 = 取请求 origin

SEO / GEO

默认就绪,不需要配置。站点是单页工具站,SEO 的着力点在「结构化数据 + 可索引正文 + 明确的抓取许可」:

项目 位置 说明
title / description / keywords public/index.html 标题控制在 30 字内,描述覆盖全部核心查询项
canonical 同上 __SITE_ORIGIN__/,输出时替换为绝对地址;?ip= 参数页统一归一到首页
Open Graph / Twitter Card 同上 summary_large_image,配 1200×630 分享图 assets/og.png
JSON-LD 同上 WebSite + Organization + SoftwareApplication + FAQPage(@graph)
可索引正文 页面「关于 CFIP · 常见问题」 4 组问答(<details>),与 FAQPage 结构化数据一一对应
robots.txt /robots.txt(Worker 动态) 放行页面,屏蔽 /api/、/ip;显式列出 15 个 AI 爬虫
sitemap.xml /sitemap.xml(Worker 动态) 首页单条,changefreq=weekly
llms.txt /llms.txt(Worker 动态) 给 LLM 的站点摘要:能力清单 + 接口地址 + 使用说明

域名自适应:/robots.txt、/sitemap.xml、/llms.txt、canonical、og:url、JSON-LD 里的地址都取自请求 origin;若同一份 Worker 同时挂在 *.workers.dev 和自定义域上,建议设 SITE_URL 固定主域名,避免两套 canonical 互相稀释:

[vars]
SITE_URL = "https://ip.example.com"

重新生成分享图(改配色/文案后):

powershell -ExecutionPolicy Bypass -File scripts/make-og.ps1

scripts/make-og.ps1 必须带 UTF-8 BOM 保存,否则 PowerShell 5.1 会按 ANSI 解析,中文注释会吞掉后续代码行(踩过)。 上线后建议在 Google Search Console / Bing 站长 / 百度搜索资源平台各提交一次 sitemap.xml,验证 meta 走上面的 HEAD_INJECT。

头部代码注入(搜索引擎验证 meta)

要加 Google / Bing / 百度 / 搜狗的站点验证 meta,不用改 index.html:给 Worker 变量 HEAD_INJECT 赋一段原始 HTML,服务端输出 HTML 时插到 <head> 里的 <!--HEAD_INJECT--> 位置。

[vars]
HEAD_INJECT = """
  <meta name="google-site-verification" content="your-google-token">
  <meta name="msvalidate.01" content="your-bing-token">
  <meta name="baidu-site-verification" content="codeva-xxxxxxxx">
  <meta name="sogou_site_verification" content="xxxxxxxx">
"""

也可在 Cloudflare Dashboard → Settings → Variables 里直接粘贴(改完即生效,无需改代码)。

  • 未设置或空字符串 = 不注入片段(HTML 仍会替换站点地址占位符,字符串级开销可忽略)
  • 支持 <head> 内任意内容:meta / link(preconnect)/ script
  • 只作用于 HTML 响应,/api、/ip、curl 文本摘要不受影响
  • 注入后正文变化,ETag 按渲染结果重新生成,条件请求仍走 304
  • 落点优先用 index.html 里的 <!--HEAD_INJECT--> 锚点;锚点被删也能退回 </head> 之前

验证 token 本身是公开信息,但若注入统计脚本或含密钥的内容,请用 npx wrangler secret put HEAD_INJECT,别写进公开仓库。

统计与广告(可选,默认全关)

默认不加载任何第三方脚本(连通性、WebRTC、指纹、测速等诊断功能只在点击后按需联网)。接入有两个入口,二选一即可:

方式 A:改本地文件(推荐,最简单) —— 编辑 public/assets/site-config.js,填 ID 后 push,自动部署生效:

export const siteConfig = {
  analytics: { ga4: '', bing: '', baidu: '', cloudflare: '' },   // 留空 = 关闭
  adsense: { client: '', slots: { afterResult: '', beforeFooter: '' } },
};

方式 B:Workers 变量 —— 在 wrangler.toml 的 [vars](或 Dashboard → Settings → Variables)添加同名变量,非空时覆盖本地文件:

变量 说明
SITE_GA4_ID GA4 测量 ID,G-XXXXXXXXXX
SITE_BING_UET Bing UET 标签 ID(纯数字)
SITE_BAIDU_ID 百度统计 hm.js id(32 位 hex)
SITE_CF_ANALYTICS_TOKEN Cloudflare Web Analytics token(无 Cookie,CF 部署首选)
ADSENSE_CLIENT AdSense 发布商 ID,ca-pub-XXXXXXXXXXXXXXXX
ADSENSE_SLOT_AFTER_RESULT 结果区下方广告单元 slot
ADSENSE_SLOT_BEFORE_FOOTER 页脚推广卡上方广告单元 slot

前端启动时读 /api/site-config(1.5s 超时,失败静默回落本地文件),任一插件启用后页脚「按需联网 · 不上传诊断数据」自动改为「统计/广告已启用」。

AdSense 投放欧盟用户需自行接入 Google 认证的 CMP(同意管理平台);本项目不含 Cookie 同意弹窗。

PWA 与离线

  • public/manifest.webmanifest + public/sw.js,可安装为桌面 / 手机应用
  • 导航请求 network-first:保证 HEAD_INJECT 与站点地址替换等动态渲染始终最新,离线时回落缓存首页
  • 静态资源 stale-while-revalidate:先给缓存、后台更新,部署后第二次访问即生效,无需手动 bump 版本号
  • /api、/ip 完全不进缓存(避免与查询结果、测速混淆)

架构

请求 → 路由(/api | /ip | /api/probe | /api/domain | /api/dns | /api/ping | /api/status
              | /api/asn | /api/bulk | /api/speed | / + UA 协商 | ASSETS)
  → parseIp 校验/规范化 → classifyIp(非公网短路,不发起外部查询)
  → Cache API 读取(仅显式 ?ip=;过半衰期后台刷新)
  → 并行适配器(Promise.allSettled + 每源超时 + 熔断)
  → bgptools 条件追加轮(已知 ASN 时)
  → mergeResults 字段级优先级合并(priorities.ts)
  → 静态 ASN 映射兜底(provider-map.ts:云厂商/CDN/anycast)
  → deriveIpType 原生/广播判定(ip-type.ts:注册地 vs 使用地)
  → comparison 多源位置对比 → 写缓存 → 响应(JSON / 文本 / HTML)

IP 类型判定(原生 / 广播)

node.ipType 为启发式推断,不做黑箱结论:

判定 依据 置信度
原生 IP 地理归属国家 = RDAP 注册国家 high
原生 IP 地理归属国家 = AS 注册国家(RDAP 缺失时退回) medium
广播 IP 注册地 ≠ 使用地(跨境机房 / CDN 回源 / 代理池常见) high / medium
无法判定 RDAP 与 bgp.tools 均无注册地信息 low

reasons 数组给出完整依据(含 rDNS 云/IDC 关键词、ASN 归属),前端折叠展示。

src/
├── index.ts            # Worker 入口:路由、编排、缓存、响应协商
├── types.ts            # 统一 IpInfo schema
├── ip.ts               # IP 解析/分类/ARPA(纯函数)
├── ip-type.ts          # 原生/广播 IP 判定(纯函数 + 判定依据)
├── merge.ts            # 字段级优先级合并器
├── cache.ts            # Cache API 封装
├── respond.ts          # JSON/文本协商、UA 判定
├── inject.ts           # HTML 出站渲染:<head> 注入 + 站点地址占位符替换
├── seo.ts              # robots.txt / sitemap.xml / llms.txt(域名自适应)
├── config.ts           # 环境变量默认值
├── adapters/           # 9 个数据源适配器 + 注册/执行 + 优先级表 + 熔断
├── tools/              # 工具端点:probe(出口探测)/ domain(DNS+RDAP+CDN)
│                       #   dns(6 解析器对比)/ ping(Globalping,含 MTR)
│                       #   asn(RIPEstat)/ bulk(批量)/ speed(测速)
│                       #   status(状态聚合)/ cache(TTL 缓存)
└── xdb/searcher.ts     # ip2region xdb 二进制查询(自实现)
public/                 # Workers Assets:单页 + 原生 JS + CSS + og.png + data/ip2region_v4.xdb
│   ├── assets/calc.js  # 纯前端 IP 计算器(IPv4/IPv6,零请求,可单测)
│   ├── assets/diag.js  # 诊断纯逻辑:站点预设 / UA / 候选分类 / 指纹摘要(可单测)
│   ├── assets/labs.js  # 连通性 / WebRTC / 指纹 / 测速 / ASN / 批量的 DOM 层
│   ├── sw.js           # Service Worker 离线壳
│   └── manifest.webmanifest
scripts/sync-xdb.mjs    # xdb 数据同步(下载 → Contents API 推送进仓库,随资产部署)
scripts/make-og.ps1     # 生成 1200×630 分享图(GDI+,需 UTF-8 BOM)
test/                   # Vitest(@cloudflare/vitest-pool-workers)

字体(钉钉进步体)

CSS 已预留 @font-face(public/assets/fonts/DingTalk-JinBuTi-CN-subset.woff2)。请自行获取字体并子集化后放入该路径:

  1. 钉钉进步体对个人/企业免费商用(以官方说明为准,请存档许可证)
  2. 子集化常用 3500 汉字控制在 1–2MB(如 fonttools pyftsubset --unicodes="U+4E00-9FFF,...")
  3. 未放置字体时自动回退系统字体栈(PingFang SC / Microsoft YaHei / Noto Sans SC),功能与排版不受影响

设计参考

已知限制

  • ip2region 仅 IPv4(见上);「住宅宽带 vs 托管」无权威免费源,isBroadband 明确标注为推断
  • 原生 / 广播 IP 判定为启发式:以 RDAP 注册国家为权威、缺失时退回 AS 注册国家,与地理归属国家比对;跨境 Anycast、CDN 回源会让结论接近「中转」而非「欺诈」,仅作参考
  • 连通性检测用 no-cors 只验证能否握手,不代表内容可正常使用;被 CORS / 证书策略拦截的站点可能误报为不可达
  • 测速反映「浏览器 ↔ 最近 Cloudflare 边缘节点」的链路,受本机负载与浏览器调度影响,只作相对参考;一轮测试约消耗 20–40MB 流量
  • 浏览器指纹哈希不是唯一标识,只用于说明「无 Cookie 时的可识别程度」,本站不存储任何指纹
  • WebRTC 检测依赖浏览器策略:Firefox 严格模式或禁用 WebRTC 的浏览器可能不返回任何 candidate
  • /api/dns 的结果分歧不等于污染:CDN GeoDNS 就近调度、解析器缓存不同步同样会造成差异,需结合国内外解析器分别判断
  • Cloudflare 平台侧的标准请求日志不受应用控制;应用侧本身零日志零存储
  • IP 地理定位精度取决于数据源,城市级为行业常态;DNSBL 逐列表独立展示,不下单一结论
  • 出口探测反映的是 Worker 共享出口在服务方的视角,不代表访客本机网络;Globalping 匿名额度按出口 IP 共享,高峰期可能触发 429

License

MIT

About

一个可利用 Cloudflare Workers 搭建的 IP 查询工具

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages