CFOpt

中文说明

CFOpt 是一个 Cloudflare 优选 IP 自动测速与发布工具。它会下载候选 IP，按多个 Cloudflare 端口运行 CloudflareSpeedTest，过滤不可用、丢包和低速结果，然后生成 Edge Tunnel 可导入的 CSV 并上传到 GitHub。

一键运行

Windows 首次运行并安装每日任务：

git clone https://github.com/GuardSkill/CFOpt.git H:\Projects\CFOpt
cd H:\Projects\CFOpt
[Environment]::SetEnvironmentVariable("GITHUB_TOKEN_CFOPT", "你的 GitHub token", "User")
powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force
powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Install-CFOptAutoPushTask.ps1"

Linux / 容器一键下载、授权、运行，并用 crontab 每天自动检查：

GITHUB_TOKEN_CFOPT="你的 GitHub token" AUTORUN_BACKEND=cron INSTALL_DAILY_AUTORUN=1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/GuardSkill/CFOpt/main/scripts/linux/install-and-run-cfopt-linux.sh)"

只手动跑一次：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force

FORCE=1 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

输出文件

CloudflareSpeedTest_CD.csv：Windows / 成都测速默认输出。
CloudflareSpeedTest_BJ.csv：Linux / 北京测速默认输出。
proxyip-best.txt：每日从 https://zip.cm.edu.kg/all.txt 拉取，完成 TLS/HTTP 可用性验证后按响应延迟筛选出的 ProxyIP，默认每国 Top 10，HK 默认 Top 50，供 Edge Tunnel 订阅生成阶段继续筛选使用。
CFOpt_Subconverter.ini：Subconverter 配置。
CFOpt_Subconverter_lite.ini：精简版 Subconverter 配置。
CFOpt_Subconverter_lite_cmliussss.ini：面向 CMLiussss / asdlokj1qpi233/subconverter 后端的精简配置，ruleset= 数量控制在默认上限 64 以下。
rules/：分流规则。

订阅转换配置文件使用本仓库的 raw 地址：

https://raw.githubusercontent.com/GuardSkill/CFOpt/main/CFOpt_Subconverter.ini
https://raw.githubusercontent.com/GuardSkill/CFOpt/main/CFOpt_Subconverter_lite.ini
https://raw.githubusercontent.com/GuardSkill/CFOpt/main/CFOpt_Subconverter_lite_cmliussss.ini

CMLiussss 后端推荐填写 CFOpt_Subconverter_lite_cmliussss.ini，避免旧 lite.ini URL 被后端缓存后继续回落默认模板。

CFOpt_Subconverter*.ini 不参与 IP 候选来源、测速、筛选和 CSV 合并逻辑；一般不需要随着测速脚本一起修改。

目录结构

scripts/windows/Invoke-CFOptAutoPush.ps1：Windows 自动测速上传脚本。
scripts/windows/Install-CFOptAutoPushTask.ps1：Windows 每日计划任务安装脚本。
scripts/linux/invoke-cfopt-auto-push-linux.sh：Linux 自动测速上传脚本。
scripts/linux/install-and-run-cfopt-linux.sh：Linux 一键下载、授权、运行和安装自动任务脚本。

根目录只保留 README、配置、CSV 和规则文件；脚本统一放在 scripts/ 下。

测速来源

默认候选来源：

https://zip.cm.edu.kg/ip.zip

额外候选来源默认开启：

https://zoroaaa.github.io/cf-bestip/ip_*.txt

cf-bestip 会按地区提供候选，例如 ip_HK.txt、ip_JP.txt、ip_SG.txt、ip_US.txt。脚本会按当前端口筛选 IP:端口#地区-score，再交给本地 CFST 实测。

默认还会从 https://ip.164746.xyz/ipTop10.html 获取由 cf-speed-dns 预筛的 Top 10 候选。该来源只加入 443 端口的 JP 重点范围，进入本地 TCP 粗筛和 CFST 后才可能发布，来源标记为 ip164746。Windows 可用 -EnableIp164746:$false 关闭，Linux 可用 ENABLE_IP164746=0 关闭；URL、数量和归属范围可分别通过 Ip164746Url / IP164746_URL、Ip164746Limit / IP164746_LIMIT、Ip164746Country / IP164746_COUNTRY 覆盖。

默认还会读取 gslege/CloudflareIP 的 JP/SG/US/DE/NL.txt，每个地区最多取前 20 个种子，仅加入 443 端口并由本机重新测速，来源标记为 gslege。Windows 可用 -EnableGslegeCloudflareIp:$false，Linux 可用 ENABLE_GSLEGE_CLOUDFLAREIP=0 关闭。

Windows 和 Linux 流程都会对所有地区进行独立热前缀挖掘：从上一轮优胜节点、cf-bestip、gslege 和 ip164746 种子中，按“地区+端口”学习活跃 /24；每池最多使用 4 个前缀，每个前缀按日期轮换生成 4 个新地址，再进入本机 TCP 粗筛和 CFST。它不是重复使用成品 IP，而是在优胜网段内持续探索新地址，来源标记为 hot-mine。Windows 使用 EnableHotPrefixMining 等参数，Linux 使用对应的 ENABLE_HOT_PREFIX_MINING、HOT_PREFIX_SAMPLES 和 HOT_PREFIX_MAX_PREFIXES_PER_COUNTRY_PORT 环境变量。

Windows 和 Linux 流程还会从电信入口候选段分层抽样，默认包括 104.16.0.0/13、104.24.0.0/14、172.64.0.0/13 以及 WARP/Tunnel/合作段中指定的 /24。每段默认轮换抽取 32 个 IPv4，并在 443/2053/2083/2087/2096/8443 每个已配置端口测试一次；不按 focus 重复，来源为 ct-pool。这只验证其作为 CF TLS/下载入口的实际表现，不启用 IPv6 或 7844 专用协议测试。通过 EnableCtEntryPool、CtEntryCidrs 和 CtEntrySamplesPerCidr 配置。

Windows 的 CandidatePoolMode=adaptive 与 Linux 的 CANDIDATE_POOL_MODE=adaptive 默认启用：地区工作项优先使用 previous + cf-bestip + gslege + ip164746 + hot-mine，不再默认灌入大批 ip.zip 地址；当某个地区/端口不足 20 个候选时自动用 ip.zip 补齐，避免冷门地区断档。hybrid 保留新旧全部来源，legacy 用于回归对照。成都 443 等量 A/B（各 320 个输入、各下载测试 40 个）中，旧池没有节点达到 5 MB/s，自适应池有 11 个达到 5 MB/s，最高 NRT 127.61 MB/s、SIN 38.46 MB/s。

最终地区以 CFST 返回的 Cloudflare Colo 为准，例如 NRT/KIX→JP、SIN→SG、HKG→HK、ICN→KR、FRA/TXL→DE、LHR→GB、AMS→NL、LAX/SJC/SEA→US。上一轮节点也按 Colo 重新归类后参与热前缀学习和发布保护，避免把 SIN 节点沿用为 JP/GB。DE、HK、KR 默认分别使用 3、2、3 倍热前缀探索预算，Windows 可通过 HotPrefixCountryMultipliers、Linux 可通过 HOT_PREFIX_COUNTRY_MULTIPLIERS 调整。

vps789 的 cfIpApi.data.CT 当前返回的电信候选很少，所以默认关闭。需要时手动开启：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -EnableVps789Ct

FORCE=1 ENABLE_VPS789_CT=1 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

脚本只取 CT，不会混入 CU、CM 或综合组。

端口和筛选

默认测速端口：

443,2053,2083,2087,2096,8443

默认地区：

HK,TW,JP,KR,SG,PH,VN,MY,KZ,MN,IE,US

默认额外重点测速地区：

SG,HK,TW,JP,KR,US,DE,GB

默认 CFST 参数：

-n 80
-t 2
-dn 10
-dt 4
-tl 420
-tlr 0
-sl 0
-p 0

普通与重点地区默认使用同一套快速参数；仍可通过 Cfst* / FocusCfst* 参数或对应的 CFST_* / FOCUS_CFST_* 环境变量分别覆盖。

默认外层 CFST 任务串行运行：

MaxParallelCfst=1
MAX_PARALLEL_CFST=1

最终 CSV 会按地区 / 分组保留 Top 20。

无代理测速

CFST 子进程默认不会继承 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 等代理环境变量，测速结果代表本机到候选 IP 的裸连质量。

如果确实要让 CFST 走代理：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -UseProxyForCfst

FORCE=1 USE_PROXY_FOR_CFST=1 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

城市列格式

城市列会包含国旗、地区、测速位置编号和候选来源，Windows/成都和 Linux/北京两边格式保持一致：国旗地区 [位置名称#编号来源]。

Windows / 成都测速：

🇭🇰 HK [成都测速#01 ip.zip]
🇭🇰 HK [成都测速#02 cf-bestip]
🇭🇰 HK [成都测速#03 vps789]

Linux / 北京测速：

🇭🇰 HK [北京测速#01 ip.zip]
🇯🇵 JP [北京测速#01 cf-bestip]

来源可能是：

ip.zip
cf-bestip
vps789
previous：从上一轮已发布 CSV 带回并复测的旧节点。
unknown：历史数据或异常情况下无法识别来源。
ip164746：ip.164746.xyz/ipTop10.html 的预筛候选，仅用于 JP/443。
gslege：gslege/CloudflareIP 的地区预筛种子，仅用于 443。
hot-mine：按地区和端口从优胜 /24 中轮换生成、由成都本机发现的新候选。
ct-pool：从电信入口候选 CIDR 分层抽样并进行多端口 TLS/下载验证。

每日滚动复测

脚本默认每天最多运行一次：

IntervalDays=1

每次运行会先下载 GitHub 上当前目标 CSV，把旧节点重新加入 CFST 输入进行复测。最终每个地区执行滚动保鲜：

本轮不达标的旧节点会被淘汰。
每个已有地区默认保留约 80% 的优质旧节点。
最多约 20% 的位置由本轮新测出的最佳候选替换；新地区直接追加。
如果新候选不足，才继续用达标旧节点补满。

默认替换比例：

0.33

调参

Windows 和 Linux 默认会在 CFST 深度测速前做一次本机 TCP 粗筛。只有候选数超过 120 的工作项才会粗筛；连接超时为 800ms，并发数为 128，每个地区和来源最多保留 30 个新候选。上一轮节点会合并到对应的 all/focus 工作项，不再额外创建一次全量 previous 下载任务，因此同一轮不会先发现后再整批重复测速。默认不向 CFST 传入 -sl，让 -dn 成为固定下载测试上限，速度门槛仍在 CSV 合并阶段执行；需要旧行为时可设置 CfstEnforceSpeedLimit=true / CFST_ENFORCE_SPEED_LIMIT=1。

临时关闭粗筛或调整参数：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -TcpPrecheckEnabled $false

FORCE=1 TCP_PRECHECK_ENABLED=0 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

可调参数为 TcpPrecheckMinCandidates / TCP_PRECHECK_MIN_CANDIDATES、TcpPrecheckTimeoutMs / TCP_PRECHECK_TIMEOUT_MS、TcpPrecheckThreads / TCP_PRECHECK_THREADS 和 TcpPrecheckMaxCandidates / TCP_PRECHECK_MAX_CANDIDATES。

提高下载测速数量和时间：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -CfstDownloadTestCount 100 -CfstDownloadTestTime 20 -CfstLossRateLimit 0

FORCE=1 CFST_DOWNLOAD_TEST_COUNT=100 CFST_DOWNLOAD_TEST_TIME=20 CFST_LOSS_RATE_LIMIT=0 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

如果下载速度全是 0.00 MB/s，开启调试：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -CfstDebug

FORCE=1 CFST_DEBUG=1 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

自动任务

Windows：

cd H:\Projects\CFOpt
powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Install-CFOptAutoPushTask.ps1"

Linux 容器：

GITHUB_TOKEN_CFOPT="你的 GitHub token" AUTORUN_BACKEND=cron bash -c "$(curl -fsSL https://raw.githubusercontent.com/GuardSkill/CFOpt/main/scripts/linux/install-and-run-cfopt-linux.sh)"

默认每天 03:30 检查并运行。

国家下载速度下限

默认的国家下载速度下限为 JP=10,US=5,KR=3,HK=2,DE=5,GB=3,SG=5。TW 默认不设国家下载速度下限。Windows 使用参数 CountryMinSpeedMBPerSec，Linux 使用环境变量 COUNTRY_MIN_SPEED_MB_PER_SEC；数值的单位是 CFST 原始 MB/s，而不是 Mbps。Windows 严格执行此门槛：发布节点的下载速度必须大于等于对应国家的下限。

默认重点测速范围（focus scope）是 SG,HK,TW,JP,KR,US,DE,GB；其中 US 与 TW 会作为独立重点范围测速。脚本先按国家和 IP 去重并保留本轮速度最高的测量，再执行国家下限。新旧节点一视同仁。最终 CSV 的城市栏不再显示来源，而显示一位小数的下载速度，例如 DE [CD#01 13.1MB/s]。

覆盖 Windows 下限：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -CountryMinSpeedMBPerSec "JP=12,US=6,KR=4,HK=3,DE=6,GB=4,SG=6"

禁用 Windows 国家下限：

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -CountryMinSpeedMBPerSec ""

覆盖 Linux 下限：

FORCE=1 COUNTRY_MIN_SPEED_MB_PER_SEC='JP=12,US=6,KR=4,HK=3,DE=6,GB=4,SG=6' ./scripts/linux/invoke-cfopt-auto-push-linux.sh

禁用 Linux 国家下限：

FORCE=1 COUNTRY_MIN_SPEED_MB_PER_SEC='' ./scripts/linux/invoke-cfopt-auto-push-linux.sh

默认外层 CFST 并发为单进程（MaxParallelCfst=1 / MAX_PARALLEL_CFST=1），避免同时进行的下载测试占满约 80 MB/s 的接入链路；如需提高并发，请结合实际带宽谨慎调整。

English

CFOpt automatically benchmarks Cloudflare candidate IPs, filters unstable results, generates Edge Tunnel compatible CSV files, and uploads them to GitHub.

Quick Start

Windows first run and daily task:

git clone https://github.com/GuardSkill/CFOpt.git H:\Projects\CFOpt
cd H:\Projects\CFOpt
[Environment]::SetEnvironmentVariable("GITHUB_TOKEN_CFOPT", "your GitHub token", "User")
powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force
powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Install-CFOptAutoPushTask.ps1"

Linux / container bootstrap with cron:

GITHUB_TOKEN_CFOPT="your GitHub token" AUTORUN_BACKEND=cron INSTALL_DAILY_AUTORUN=1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/GuardSkill/CFOpt/main/scripts/linux/install-and-run-cfopt-linux.sh)"

Outputs

CloudflareSpeedTest_CD.csv: default Windows / Chengdu output.
CloudflareSpeedTest_BJ.csv: default Linux / Beijing output.
proxyip-best.txt: daily ProxyIP list selected from https://zip.cm.edu.kg/all.txt after TLS/HTTP validation and ranked by response latency for Edge Tunnel subscription generation. Defaults to Top 10 per country, with HK expanded to Top 50 for downstream reachability filtering.
CFOpt_Subconverter.ini: Subconverter config.
CFOpt_Subconverter_lite.ini: lite Subconverter config.
CFOpt_Subconverter_lite_cmliussss.ini: lite config for CMLiussss / asdlokj1qpi233/subconverter backends, keeping ruleset= entries under the default limit of 64.
rules/: routing rules.

Use this repository's raw URLs as Subconverter config files:

https://raw.githubusercontent.com/GuardSkill/CFOpt/main/CFOpt_Subconverter.ini
https://raw.githubusercontent.com/GuardSkill/CFOpt/main/CFOpt_Subconverter_lite.ini
https://raw.githubusercontent.com/GuardSkill/CFOpt/main/CFOpt_Subconverter_lite_cmliussss.ini

For CMLiussss backends, prefer CFOpt_Subconverter_lite_cmliussss.ini to avoid stale backend cache for the older lite.ini URL.

The Subconverter configs are not part of candidate collection, benchmarking, filtering, or CSV merging, so they usually do not need changes when the benchmark scripts change.

Candidate Sources

Default source:

https://zip.cm.edu.kg/ip.zip

Extra source enabled by default:

https://zoroaaa.github.io/cf-bestip/ip_*.txt

The runners also fetch the pre-ranked Top 10 list from https://ip.164746.xyz/ipTop10.html. These candidates are injected only into the JP focus scope on port 443, tagged as ip164746, and must still pass the local TCP precheck and CFST benchmark. Disable the source with -EnableIp164746:$false on Windows or ENABLE_IP164746=0 on Linux. The URL, limit, and assigned focus country are configurable through Ip164746Url / IP164746_URL, Ip164746Limit / IP164746_LIMIT, and Ip164746Country / IP164746_COUNTRY.

The runners also load the first 20 seeds per country from gslege/CloudflareIP for JP/SG/US/DE/NL. They are injected only on port 443, tagged as gslege, and re-benchmarked locally. Disable with -EnableGslegeCloudflareIp:$false or ENABLE_GSLEGE_CLOUDFLAREIP=0.

vps789 CT candidates are disabled by default because the API currently returns very few usable entries. Enable it manually with -EnableVps789Ct on Windows or ENABLE_VPS789_CT=1 on Linux.

Ports and Filters

Default ports:

443,2053,2083,2087,2096,8443

Default CFST parameters:

-n 80
-t 2
-dn 10
-dt 4
-tl 420
-tlr 0
-sl 0
-p 0

All and focus scopes use the same fast defaults. They can still be overridden independently through the Cfst* / FocusCfst* parameters or matching CFST_* / FOCUS_CFST_* environment variables.

The final CSV keeps the Top 20 rows per region/group.

Direct, Non-Proxy Benchmarking

CFST child processes do not inherit proxy environment variables by default. This keeps benchmark results representative of direct connectivity from the host to candidate IPs.

To intentionally benchmark through a proxy, use -UseProxyForCfst on Windows or USE_PROXY_FOR_CFST=1 on Linux.

City Column

The city column includes the country flag, region, location index, and source:

🇭🇰 HK [成都测速#01 ip.zip]
🇭🇰 HK [成都测速#02 cf-bestip]
🇭🇰 HK [成都测速#03 vps789]
🇭🇰 HK [成都测速#04 previous]

Possible sources are ip.zip, cf-bestip, ip164746, gslege, vps789, previous, and unknown.

Rolling Retest

Each run fetches the current published CSV, retests old nodes, removes failing nodes, keeps about 80% of the best old nodes in existing groups, and fills the rest with the best newly tested candidates. The default replacement fraction is 0.20.

TCP Precheck

Windows and Linux perform a local TCP precheck before CFST deep testing. It runs only when a work item has more than 120 candidates, uses an 800ms timeout with 128 concurrent connects, and retains at most 30 new candidates per region/source group. Previous nodes are merged into their matching all/focus item instead of being download-tested again in a separate full-history job. By default CFST does not receive -sl, so -dn is a hard download-test cap; the speed floor is still applied during CSV merging. Restore the old replacement-queue behavior with CfstEnforceSpeedLimit=true / CFST_ENFORCE_SPEED_LIMIT=1.

Disable it for one run:

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -TcpPrecheckEnabled $false

FORCE=1 TCP_PRECHECK_ENABLED=0 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

The tuning pairs are TcpPrecheckMinCandidates / TCP_PRECHECK_MIN_CANDIDATES, TcpPrecheckTimeoutMs / TCP_PRECHECK_TIMEOUT_MS, TcpPrecheckThreads / TCP_PRECHECK_THREADS, and TcpPrecheckMaxCandidates / TCP_PRECHECK_MAX_CANDIDATES.

Debugging

If every download speed is 0.00 MB/s, enable CFST debug output:

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -CfstDebug

FORCE=1 CFST_DEBUG=1 ./scripts/linux/invoke-cfopt-auto-push-linux.sh

Country Download Speed Floors

The default country download-speed floors are JP=10,US=5,KR=3,HK=2,DE=5,GB=3,SG=5. TW has no country speed floor by default. Use the Windows CountryMinSpeedMBPerSec parameter or the Linux COUNTRY_MIN_SPEED_MB_PER_SEC environment variable. Values use CFST raw MB/s, not Mbps. Windows strictly applies each floor: published nodes must be greater than or equal to the corresponding country floor.

The default focus scope is SG,HK,TW,JP,KR,US,DE,GB; TW and US are benchmarked as dedicated focus scopes. The runner first deduplicates each country/IP to its fastest current measurement, then applies the country floor. Old and new candidates compete equally. The final CSV city field shows one-decimal measured speed instead of source, for example DE [CD#01 13.1MB/s].

Override Windows floors:

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -CountryMinSpeedMBPerSec "JP=12,US=6,KR=4,HK=3,DE=6,GB=4,SG=6"

Disable Windows country floors:

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\windows\Invoke-CFOptAutoPush.ps1" -Force -CountryMinSpeedMBPerSec ""

Override Linux floors:

FORCE=1 COUNTRY_MIN_SPEED_MB_PER_SEC='JP=12,US=6,KR=4,HK=3,DE=6,GB=4,SG=6' ./scripts/linux/invoke-cfopt-auto-push-linux.sh

Disable Linux country floors:

FORCE=1 COUNTRY_MIN_SPEED_MB_PER_SEC='' ./scripts/linux/invoke-cfopt-auto-push-linux.sh

The default outer CFST concurrency is one process (MaxParallelCfst=1 / MAX_PARALLEL_CFST=1) to avoid saturating an approximately 80 MB/s access link with simultaneous download tests. Increase it only with appropriate available bandwidth.