Cloudflare IP 优选工具

⭐ 如果觉得好用，点个 Star 支持一下～

这是一个全自动的 Cloudflare CDN 节点优选工具。它通过 TCP 延迟筛选 + IP 可用性二次检测 + HTTP 延迟及抖动检测 + 真实带宽测速 多重机制，从多个公开数据源中聚合节点，自动识别并解析任意格式（标准代码、中文名、emoji国旗、JSON等），筛选出当前网络环境下速度最快、延迟最低、抖动最小的 Cloudflare IP，并支持自动更新至 Cloudflare DNS 以及同步至 GitHub 仓库，同时支持微信实时通知。

[!IMPORTANT] 跨平台支持：本工具同时兼容 Windows 和 Linux 操作系统。

• Windows 自动推送依赖 PowerShell 脚本 git_sync.ps1
• Linux 自动推送依赖 Bash 脚本 git_sync.sh

📍 快速导航

• 🚀 我要部署（Windows / Linux 命令对照）
• 🔐 我要获取 Token（GitHub / Cloudflare / WxPusher 三合一教程）
• ⚙️ 我要调整参数
• ☁️ 我要配置 Cloudflare DNS
• 📤 我要配置 GitHub 同步
• 🔧 Fork 后无法推送？一键修复
• 🔗 对接 EdgeTunnel 指南
• ❓ 常见问题

✨ 功能特性

📦 文件清单

🖥️ 系统要求

• 操作系统：Windows 10+ / Windows Server 2016+ 或 Linux（Ubuntu/Debian/CentOS 等）
• 必备软件：
  • Python 3.7+
  • Git
  • curl（需在系统 PATH 中可用）
• Python 依赖：requests, aiohttp, brotlicffi

🚀 部署步骤

通用前置步骤

1. 获取项目文件

   • 方式一（推荐）：点击本仓库页面的绿色 Code 按钮 → Download ZIP，下载压缩包后解压到本地。
   • 方式二（熟悉 Git 的用户）：使用命令行克隆仓库：

     git clone https://github.com/你的用户名/仓库名.git
     cd 仓库名

2. 配置各项令牌（见下一节）
   根据需求获取并填写 GitHub Token、Cloudflare API Token 和 WxPusher 凭证。

💡 部署脚本会自动安装 requests、aiohttp、brotlicffi 三个 Python 依赖、创建 .gitignore 并配置定时任务（每 5 分钟整点运行）。

🔐 获取必要令牌（重要）

若你希望启用 GitHub 自动推送、Cloudflare DNS 更新或微信通知，请参考下表获取对应令牌。

💡 若不需要某项功能，可跳过对应步骤或在配置中关闭开关：

• 无需微信通知：config.json 中设 ENABLE_WXPUSHER: false
• 无需 GitHub 推送：config.json 中设 GITHUB_SYNC_MAX_RETRIES: 0
• 无需 Cloudflare DNS 更新：config.json 中设 CF_ENABLED: false

Windows 部署

以管理员身份打开 PowerShell，逐行执行以下命令：

# 1. 进入项目目录
cd "C:\你的项目路径\cfnb"

# 2. 若提示脚本禁用，临时绕过（可选）
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

# 3. 运行部署脚本
.\setup.ps1

# 4. 编辑推送脚本，填入 GitHub 令牌等信息
notepad git_sync.ps1

# 5. 测试运行
python main.py

Linux 部署

在终端中逐行执行以下命令：

# 1. 进入项目目录
cd /path/to/cfnb

# 2. 赋予执行权限
chmod +x setup.sh

# 3. 运行部署脚本（需要 sudo 安装软件包）
sudo ./setup.sh

# 4. 编辑推送脚本，填入 GitHub 令牌等信息
nano git_sync.sh

# 5. 测试运行
python3 main.py

🔧 Fork 后无法推送？一键修复

适用于 fork 或修改远程仓库后，出现以下任一问题的情况：

• git pull 报错：fatal: refusing to merge unrelated histories
• 推送时每次弹出浏览器要求登录

运行对应平台的一键修复脚本即可（前提：已按前文填写好 config.json 与推送脚本中的令牌）

脚本会自动完成：

• 备份现有配置文件（可随时恢复）
• 设置免认证远程地址
• 强制对齐本地与远程仓库
• 将你的令牌安全注入最新版本的文件（不覆盖其他参数）

💡 运行成功后，main.py 即可正常自动推送，不再有任何冲突或弹窗。

🕒 定时自动运行说明

日志查看：

• Windows：任务计划程序中查看历史记录。
• Linux：tail -f cron.log

⚙️ 配置说明（完整参数详解）

[!NOTE] 默认参数基于 2核2G 云服务器 测试通过。若在 软路由、树莓派或低配 PC 上运行，建议适当降低 MAX_WORKERS、HTTP_TEST_WORKERS、BANDWIDTH_WORKERS。

所有参数均位于 config.json，以下为逐项说明。

筛选模式与数量控制

TCP 连接测试参数

综合排序权重

最终节点的排名由综合得分决定，公式为：
得分 = (SPEED_WEIGHT × 带宽) / (1 + TCP_LATENCY_WEIGHT × TCP延迟 + HTTP_LATENCY_WEIGHT × HTTP延迟 + JITTER_WEIGHT × HTTP抖动)

前置过滤参数（TCP 测试前生效）

💡 过滤执行顺序：前置端口过滤 → 前置黑名单 → 前置白名单。
所有前置过滤均在 TCP 测试前完成，可大幅减少无效测试。

网络直连控制

DNS 黑名单参数（仅作用于 DNS 更新环节）

说明：

• 该过滤仅作用于 Cloudflare DNS 批量更新环节，不会影响 ip.txt 的内容和 GitHub 推送。
• DNS 更新时会同时应用以下条件，只有全部满足的节点才会写入 DNS：
  • 端口必须为 443
  • 落地不能仅为 IPv6（即保留 IPv4 或双栈节点，需开启 FILTER_IPV6_AVAILABILITY）
  • 国家不在 BLOCKED_COUNTRIES 黑名单中（需开启 FILTER_BLOCKED_COUNTRIES_ENABLED）
  • IP 风险等级不高于设定阈值（需开启 DNS_IP_RISK_FILTER_ENABLED，若过滤后无节点则自动回退到未过滤列表）

微信通知（WxPusher）参数

💡 若不需要通知，将 ENABLE_WXPUSHER 设为 false 即可。

Cloudflare DNS 批量更新参数

💡 若不需要 DNS 更新，将 CF_ENABLED 设为 false 即可。

节点数据源与获取配置

[!NOTE] 本工具支持多个数据源同时使用，并内置了完全自适应的解析引擎。无论数据源是标准 IP:端口#代码 格式，还是中文标签、emoji国旗、JSON数组/对象，甚至是混合无关文字的标签，程序都能自动识别并统一转换为标准格式。添加新数据源只需在 ADDITIONAL_SOURCES 数组中新增一个对象，无需任何代码修改。

IP 地区校准参数

💡 校准结果会实时写入缓存文件，程序结束后自动按 IP 地址排序，下次运行可复用。
Token 文件每行一个 ipinfo.io 的 API Token，可在 ipinfo.io 注册免费获取（每月 5 万次）。
程序会自动校验 Token 有效性并显示进度，当所有 Token 均触发速率限制时，会通过微信通知。

💡 快速配置建议

• 通常只需修改 ALLOWED_COUNTRIES、WXPUSHER_APP_TOKEN、WXPUSHER_UIDS。
• 启用 DNS 更新需正确填写 CF_API_TOKEN、CF_ZONE_ID、CF_DNS_RECORD_NAME。
• 网络不稳定时可 ↑ TCP_PROBES / TIMEOUT，↓ MIN_SUCCESS_RATE / MAX_WORKERS。
• 希望更快出结果可 ↓ BANDWIDTH_CANDIDATES 或 BANDWIDTH_SIZE_MB。

📊 结果输出说明

程序运行完成后，会在本地生成 ip.txt 文件，每行格式为 IP地址:端口#国家代码，例如：

104.16.x.x:443#US
162.159.x.x:443#HK

重要说明：

• ip.txt 中保存的是基于综合加权排序的结果，综合考虑了带宽、TCP 延迟、HTTP 延迟和抖动，以确保 GitHub 推送的节点列表完整且不丢失任何高速低延迟的 IP。
• Cloudflare DNS 批量更新环节会额外应用 FILTER_IPV6_AVAILABILITY（过滤落地 IPv6）、BLOCKED_COUNTRIES（屏蔽特定国家）、DNS_IP_RISK_FILTER_ENABLED（IP 风险等级过滤，可设定最高允许等级，过滤后无节点自动回退到无风险过滤列表）等过滤，仅将符合条件的 IP 写入 DNS 记录。

☁️ 配置 Cloudflare DNS 自动更新

本工具支持将优选出的 IP 地址列表自动更新到 Cloudflare DNS 的同名 A 记录，实现解析层面的多 IP 轮询负载均衡。

第一步：获取 Cloudflare API Token 与 Zone ID

1. 按照 获取必要令牌 中的步骤获取 Cloudflare API Token（需具有 Zone:DNS:Edit 权限）。
2. 在 Cloudflare 域名概览页面右侧复制你的 Zone ID。

第二步：填写配置文件

编辑 config.json，找到 Cloudflare DNS 配置部分，填入你的信息：

"CF_ENABLED": true,
"CF_API_TOKEN": "your_CF_API_TOKEN",
"CF_ZONE_ID": "your_CF_ZONE_ID",
"CF_DNS_RECORD_NAME": "your_CF_DNS_RECORD_NAME",
"CF_TTL": 60,
"CF_PROXIED": false

💡 若不需要 DNS 更新功能，将 CF_ENABLED 设为 false 即可。

第三步：测试运行

1. 手动运行一次优选程序：python main.py（Windows）或 python3 main.py（Linux）。
2. 程序运行结束后，观察控制台输出。若看到 ✅ Cloudflare DNS 批量更新成功！，则配置成功。

工作原理

每次运行时，脚本会：

1. 查询目标子域名下现有的所有 A 记录。
2. 从带宽测速结果中按速度顺序挑选落地 IPv4 的节点（若启用 FILTER_IPV6_AVAILABILITY）。
3. 组装一个原子批量请求：同时删除所有旧记录并创建全部新记录。

注意事项

• 免费套餐单次批量操作最多支持 200 条记录，足够使用。
• 若候选池中落地 IPv4 节点不足目标数量，则更新实际可用的数量，不会强制凑满。
• 使用原子批量 API，单次请求完成删除和创建，可能存在极短暂的解析真空期（通常 1~5 秒）。

📤 配置 GitHub 自动同步

本工具支持每次运行后将 ip.txt 自动推送到你指定的 GitHub 仓库，方便通过 Raw 链接订阅节点列表。

第一步：创建 GitHub 仓库

1. 登录 GitHub，点击右上角 + → New repository。
2. Repository name 可任意填写（如 cf-ip）。
3. 仓库类型选择 Private（推荐）或 Public。
4. 不要勾选 “Add a README file”、“.gitignore” 等初始化选项。
5. 点击 Create repository。

第二步：初始化本地仓库并关联远程

💡 如果你是通过网页下载的 ZIP 压缩包解压的，必须执行以下全部命令。
如果你是用 git clone 命令下载的，本地仓库已自动关联远程，可跳过此步，直接进入第三步。

根据你的操作系统选择对应标签页的命令，在项目根目录下打开终端执行：

Windows（PowerShell）

# 1. 初始化仓库（若尚未初始化）
git init

# 2. 移除旧 origin 并添加你的远程地址（替换为你的仓库链接）
$null = git remote remove origin 2>&1
git remote add origin https://github.com/你的用户名/仓库名.git

# 3. 拉取远程数据并切换到默认分支（先 main 后 master）
git fetch origin
$null = git checkout main 2>&1
if ($LASTEXITCODE -ne 0) { $null = git checkout master 2>&1 }

Linux （Bash）

# 1. 初始化仓库（若尚未初始化）
git init

# 2. 移除旧 origin 并添加你的远程地址（替换为你的仓库链接）
git remote remove origin 2>/dev/null
git remote add origin https://github.com/你的用户名/仓库名.git

# 3. 拉取远程数据，对齐远程默认分支名
git fetch origin
git checkout -b temp-branch 2>/dev/null || git checkout main 2>/dev/null || git checkout master 2>/dev/null
git branch -M $(git remote show origin | grep "HEAD branch" | cut -d " " -f5) 2>/dev/null || git branch -M main

⚠️ 如果远程仓库是完全空的（创建时未勾选任何初始化文件，无任何分支），上述命令会因没有可检出的分支而失败。
解决方法：先手动创建一个初始提交再重试：

git commit --allow-empty -m "init"

然后再次执行上面的第 3 步。

第三步：获取并填写 GitHub Token

1. 按照 获取必要令牌 中的步骤获取 GitHub Personal Access Token（需勾选 repo 权限，过期时间设为 No expiration）。

2. 编辑对应平台的推送脚本：

   • Windows：用文本编辑器打开 git_sync.ps1
   • Linux：用文本编辑器打开 git_sync.sh

3. 将脚本开头部分的四个变量替换为你的真实信息：

   # Windows (git_sync.ps1)
   $github_token = "your_github_personal_access_token_here"
   $github_username = "your_github_username"
   $repo_name = "your_repo_name"
   $branch = "your_branch"

   # Linux (git_sync.sh)
   github_token="your_github_personal_access_token_here"
   github_username="your_github_username"
   repo_name="your_repo_name"
   branch="your_branch"

第四步：测试推送

1. 确保项目目录下已有 ip.txt 文件（可先手动运行一次 python main.py 生成）。
2. 手动执行推送脚本测试：
   • Windows：双击运行 git_sync.ps1 或在 PowerShell 中执行 .\git_sync.ps1
   • Linux：执行 ./git_sync.sh
3. 若终端显示 ✅ ip.txt 已推送到 GitHub，则配置成功。
4. 之后每次运行 main.py，程序都会自动调用推送脚本，无需人工干预。

[!WARNING] 关于私有仓库的特别提醒

如果你将仓库设置为 Private（私有），则通过 Raw 链接访问 ip.txt 时必须在 URL 后附加 ?token=xxxxxx 参数才能获取内容，例如：

https://raw.githubusercontent.com/用户名/仓库名/refs/heads/分支名/ip.txt?token=xxxxxx

但请注意，部分代理工具或订阅解析器可能无法正确处理带 Token 参数的 URL，原因包括：

• 不支持自定义请求头（GitHub 要求完整的 User-Agent 等头信息）
• 无法解析带查询参数的链接
• 防火墙或网络环境限制

因此，如果你希望将 ip.txt 作为订阅链接供代理工具使用，强烈建议将仓库设为 Public（公开）。

公开仓库的 Raw 链接无需 Token 即可访问，兼容性最佳：

https://raw.githubusercontent.com/用户名/仓库名/refs/heads/分支名/ip.txt

验证与订阅

推送成功后，访问 https://raw.githubusercontent.com/你的用户名/仓库名/refs/heads/分支名/ip.txt 即可获取最新节点列表，供代理工具订阅使用。

💡 若不需要 GitHub 同步功能，可在 config.json 中设置 GITHUB_SYNC_MAX_RETRIES: 0 即可关闭。

🚀 对接 EdgeTunnel (2.0+) 指南

EdgeTunnel (EDTunnel) 是基于 Cloudflare Workers 的隧道工具。使用本项目筛选出的 ip.txt 可以显著提升连接速度和稳定性。

方法一：优选订阅模式（推荐）

1. 复制你的 GitHub Raw 链接：

   https://raw.githubusercontent.com/你的用户名/仓库名/refs/heads/分支名/ip.txt

2. 打开 EdgeTunnel 控制面板，点击菜单栏的 “优选订阅生成”。
3. 在 “优选订阅模式” 区域，选择 “自定义订阅（支持汇聚订阅）”。
4. 点击 “订阅接口” 按钮，在 API URL 输入框中粘贴上一步获取的 GitHub Raw 链接。

   💡 如需指定端口，可在链接后添加 ?port=443。

5. （可选）勾选 “将优选作为 PROXYIP”。
6. 点击 “可用性验证”，系统将验证 API 并拉取节点列表。
7. 检查无误后，点击 “追加API” 按钮将链接加入自定义订阅地址。
8. 点击 “保存” 按钮完成配置。

方法二：手动替换 EdgeTunnel 节点配置

1. 打开 EdgeTunnel 控制面板，点击菜单栏的 “优选订阅生成”。
2. 在 “优选订阅模式” 区域，选择 “自定义订阅（支持汇聚订阅）”。
3. 在 “自定义订阅地址” 输入框中直接粘贴节点地址，每行一个，例如：

   104.16.x.x:443#US
   162.159.x.x:443#HK

4. 点击 “保存” 按钮，即可手动指定优选的节点列表。

方法三：使用 Cloudflare DNS 域名（推荐）

如果你已启用 Cloudflare DNS 批量更新，可以直接将你的子域名（如 cf.yourdomain.com）填入 EdgeTunnel：

方式一：通过“优选订阅生成”

1. 打开 “优选订阅生成” 页面，选择 “自定义订阅（支持汇聚订阅）”。
2. 在 “自定义订阅地址” 输入框中，填入你的子域名（例如 cf.yourdomain.com）。
3. 点击 “保存” 按钮。

方式二：通过“Cloudflare CDN 访问设置”

1. 进入 “Cloudflare CDN 访问设置” 页面。
2. 在 “PROXYIP” 输入框中，填入你的子域名（例如 cf.yourdomain.com）。
3. 点击 “保存” 按钮。

该域名会自动解析到当前最优的多个 IP 之一，实现零配置动态切换。

💡 为什么这样对接更有效？

• 低延迟：main.py 已经通过 TCP 握手筛选出了延迟最低的节点。
• 高带宽：结果经过真实 curl 下载测试，排在前面的节点具有更强的并发吞吐能力。
• 高可用：通过 AVAILABILITY_CHECK_API 过滤了那些能 Ping 通但无法正常通过代理请求的无效 IP。
• 自动更新：DNS 记录随优选结果自动刷新，无需手动修改配置。

注意事项

• GitHub 缓存：GitHub Raw 链接有一定的 CDN 缓存时间（通常为 5 分钟左右）。如果刚运行完脚本发现链接内容没变，请稍等片刻。
• 网络环境：建议在你的主运行环境（如家庭软路由或主力 PC）运行此脚本，因为不同网络环境下筛选出的最优 IP 可能不同。
• DNS 生效时间：修改 DNS 记录后受 TTL 影响，全球生效可能需要几分钟，但通常 Cloudflare 更新是实时的。

❓ 常见问题

🙏 致谢

• 节点数据源 & 检测 API：cmliussss
• IP 风险检测 API：ipapi.is
• IP 地区校准：ipinfo.io
• 微信通知服务：WxPusher

许可证：本项目采用 MIT License 开源。