CF-Workers-CheckProxyIP 是一个部署在 Cloudflare Workers 上的轻量级ProxyIP 验证工具，能快速准确地检测代理 IP 的可用性，并展示出口 IP、地理位置、ASN 信息和地图线路。它最实用的一招叫"路径直达"：只要把自己的 Worker 域名后面拼上目标 IP，打开这个 URL 就会自动填入输入框并立即开始检测——把链接发出去，别人点开就能复现同一次检测结果，分享与复用极其方便。

CF-Workers-CheckProxyIP 是什么？

这是一个单文件 Worker 应用：页面、域名解析、TCP/TLS 连通性探测全部内置在同一个 Worker 中，部署后立刻得到一个可用的检测页面，无需任何额外服务。

核心能力一览：

• ✅ 支持单条 / 多行批量检测（批量按Ctrl + Enter开始）
• ✅ 支持 IPv4、IPv6、域名、IP:端口等多种目标格式
• ✅ 域名自动并发解析A/AAAA/TXT记录
• ✅ 结果展示响应耗时、出口 IP、国家旗帜、Cloudflare 机房连线地图
• ✅ 单条模式自动保存最近 10 条本地历史，按Enter即可重测

项目核心文件说明见 README.md，检测逻辑实现全部在 _worker.js 中。

路径直达：一个 URL 自动触发检测的原理

正常情况下，你访问 Worker 根路径https://你的域名.workers.dev/会看到空白输入框。而路径直达的玩法是把目标直接写在 URL 路径里：

https://你的域名.workers.dev/8.223.63.150:443

打开这个链接后，页面会自动完成三步动作：

1. 读取 URL 路径中的目标，并做 URL 解码
2. 把目标回填到输入框
3. 自动点击"开始检测"按钮，立即发起/check检测

更巧妙的是，前端会在触发检测后立刻用history.replaceState把地址栏重置回根路径（见 _worker.js），这意味着同一条链接可以无限次重复使用——每次打开都会重新自动触发一次检测，而不会停留在"已检测"状态。

三个最实用的分享场景

场景一：把检测链接发给他人复现

朋友给你一个候选 ProxyIP，你不必截图解释，直接把https://你的域名.workers.dev/203.0.113.10:8443发过去。对方点开就能看到实时的成功/失败状态、响应时间、出口位置和地图线路，检测结果天然可验证、可对比。

场景二：常用目标一键书签化

把常用的几组 IP/域名分别拼成直达链接收藏到浏览器书签栏，以后想复查某个代理是否还活着，点书签即可，输入都不用敲。

场景三：嵌入自己的运营流程

如果你的团队在维护一批代理节点，可以把"新节点上线检测"固化成一条直达 URL，节点更换时只需换掉链接中的目标部分，流程零改动。

路径直达支持哪些目标格式？

URL 路径里可以放下面这些格式，解析规则与页面输入框完全一致（实现见 _worker.js）：

💡 小技巧：域名中含.tp端口.时（如abc.tp8443.example.com）会强制覆盖端口号，这类特殊目标同样可以拼进直达链接。

⚠️ 注意：路径只识别"单个目标"。多个目标请打开页面后开启批量检测开关，每行输入一个。另外路径长度需超过 3 个字符且不能是resolve、favicon.ico等保留路径。

如何快速部署自己的检测页？

部署只需要 5 步，几分钟搞定：

1. 登录 Cloudflare Dashboard，创建一个新的 Worker
2. 打开在线编辑器
3. 将 _worker.js 的完整内容粘贴进去
4. 保存并部署
5. 访问 Worker 地址，开始使用路径直达

如果习惯本地开发，也可以先克隆仓库：

git clone https://gitcode.com/gh_mirrors/cf/CF-Workers-CheckProxyIP

仓库默认采用"单文件直接部署"方式，未附带wrangler.toml；已有 Workers 工程也可以直接把_worker.js的fetch()路由与页面逻辑合并进去。唯一的可选环境变量是BEIAN（自定义页脚 HTML），不设置则使用默认页脚。

常见问题

Q：直达链接打开后没有自动检测？检查路径是否以根路径开头（如/8.223.63.150:443），且长度超过 3 个字符；IPv6 建议直接写成2606:4700::1格式，解析器会自动处理。

Q：检测结果会受检测人所在地影响吗？检测由 Cloudflare 边缘节点（/check路由）执行并通过固定出口探针判断 IPv4/IPv6 能力，页面会显示执行检测的机房代码（colo字段），因此不同地域访问看到的线路图可能略有差异，这属于正常现象。

Q：能换成自己的检测后端吗？可以。前端的checkIP()请求的是同源/check?proxyip=接口，替换探针目标优先调整_worker.js中的PROBE_TARGETS即可，详见 README.md 的"自定义建议"章节。

写在最后

CF-Workers-CheckProxyIP 把"部署成本极低"做到了极致：一个单文件 Worker，就同时拥有ProxyIP 批量筛选、域名解析、出口可视化三大能力。而路径直达功能，则让每一条检测结果都变成一个可分享、可复用、可复现的链接——把目标写进 URL，检测就自动发生。对于需要频繁验证代理可用性的场景，这是最省事的一招。

项目基于 MIT License 开源，放心使用与二次开发。