基于 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),共享出口限流友好
- 隐私:不记录查询日志、不建查询数据库,仅缓存
| 端点 | 说明 |
|---|---|
/ |
浏览器 → 中文单页;命令行(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。
git clone https://github.com/adream2/CFIP.git && cd CFIP
npm installpublic/data/ip2region_v4.xdb(约 11MB)作为 Workers Assets 随代码一起部署,Worker 经 ASSETS 绑定按需加载(模块级记忆化,每 isolate 一次)——无需 KV、无需手动上传。更新数据:
GH_TOKEN=<有 Contents 写权限的 PAT> npm run xdb:syncWorkers Assets 单文件上限 25 MiB(Free 同等待遇),11MB 的 xdb 放得正好。IPv6 离线数据(v6 xdb)因体积超出公共 CDN 单文件限制未内置;IPv6 查询的地理/网络/信誉数据由在线源完整覆盖,功能不受影响。
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 集成)npx wrangler deploy或推送 GitHub 自动部署(见下)。
- 建仓库并推送代码
- Cloudflare Dashboard → My Profile → API Tokens → 创建令牌,权限选 Account.Workers Scripts:Edit(最小化)
- 仓库 Settings → Secrets → 添加
CF_API_TOKEN - push 到
main即自动:类型检查 → 测试 →wrangler deploy
可选 secrets:IPINFO_TOKEN、ABUSEIPDB_KEY(配置后在 deploy.yml 取消注释对应段落,或手动 npx wrangler secret put <NAME>)。
| 变量 | 默认 | 说明 |
|---|---|---|
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 的着力点在「结构化数据 + 可索引正文 + 明确的抓取许可」:
| 项目 | 位置 | 说明 |
|---|---|---|
| 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。
要加 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 同意弹窗。
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)
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)。请自行获取字体并子集化后放入该路径:
- 钉钉进步体对个人/企业免费商用(以官方说明为准,请存档许可证)
- 子集化常用 3500 汉字控制在 1–2MB(如
fonttools pyftsubset --unicodes="U+4E00-9FFF,...") - 未放置字体时自动回退系统字体栈(PingFang SC / Microsoft YaHei / Noto Sans SC),功能与排版不受影响
- jason5ng32/MyIP — 全功能 IP 工具箱(功能对标:原生/广播 IP 判定、多解析器 DNS 对比、MTR、IP 计算器、诊断报告导出)
- zhihui-hu/one-ip — 一站式 IP 工具箱(功能矩阵参考:出口探测/域名工具/全球 Ping/服务状态)
- jinhuaitao/My-IP — Worker IP 信息页(UA 协商、端点设计)
- Adgerlee/CF-IPInfo — 仪表盘与多语言
- slchris/iptools — wrangler 工程布局
- v1xingyue/geo-sdk-worker — TS + Vitest + Assets
- yack-security/CFWorker_PublicIP — ip-api + DoH
- lionsoul2014/ip2region — 离线中文 IP 数据
- 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
MIT