yx-tools

README

yx-tools

Cloudflare 优选 IP 测速工具。单个二进制，命令行和网页界面都能用。

测速内核基于 XIU2/CloudflareSpeedTest， 补了反代场景需要的 IP:端口 支持。

能做什么

• 测 Cloudflare 各数据中心的延迟和下载速度，支持 IPv4 / IPv6
• 按机场码筛地区，全球 97 个数据中心
• 反代模式：输入 IP:端口，结果保留端口信息
• 一键上报到 cfnew 面板，或推到 GitHub 仓库
• 网页界面实时看进度，也能纯命令行跑，适合塞进定时任务

装

去 Releases 下对应平台的包，解压就能跑。不用装 Python，不用装依赖。

# Linux / macOS
tar -xzf yx_linux_amd64.tar.gz
chmod +x yx_linux_amd64
./yx_linux_amd64

自己编译也行：

git clone https://github.com/byJoey/yx-tools.git
cd yx-tools
go build -o yx ./cmd/yx

用

网页界面

./yx

默认监听 127.0.0.1:8080 并自动开浏览器。放服务器上跑就换个监听地址：

./yx web -listen 0.0.0.0:8080

左边配参数，右边看结果。地区搜索框输中文或机场码都行，留空就是不限地区。

命令行

# 测 10 个，速度下限 1MB/s
./yx test -n 10 -sl 1

# 只测香港和新加坡
./yx test -colo HKG,SIN -n 20

# 测完直接上报到 cfnew
./yx test -n 10 -upload api -domain your.workers.dev -uuid 你的UUID -clear

# 从已有结果生成反代列表
./yx proxy -limit 20

-h 看完整参数。

Docker

docker compose up -d

浏览器打开 http://服务器IP:8080。结果和配置存在 ./data。

参数

测速：

参数	说明	默认
-colo	机场码，逗号分隔，如 HKG,SIN；留空不限	空
-ipv6	测 IPv6 段	否
-n	测速数量	10
-sl	下载速度下限 MB/s	1
-tl	平均延迟上限 ms	1000
-t	延迟测速线程数，路由器上别开太高	200
-port	测速端口	443
-url	测速地址	内置
-f	自定义 IP 文件，每行一条，支持 IP:端口	自动下载
-nodl	只测延迟，跳过下载测速	否
-o	结果文件	result.csv

上报（跟在 test 后面，或单独用 upload）：

参数	说明
-upload	api 上报 cfnew，github 推到仓库
-domain -uuid	cfnew 的 Worker 域名和 UUID
-repo -token	GitHub 仓库 owner/repo 和 Token
-path	仓库内文件路径，默认 cloudflare_ips.txt
-limit	上报数量，默认 10
-clear	上报前清空已有 IP，建议带上，否则会越堆越多

界面：

参数	说明	默认
-listen	监听地址	127.0.0.1:8080
-no-open	不自动开浏览器	否

定时任务

Linux / macOS 直接用内置命令挂 cron，不用自己编辑 crontab：

# 每 6 小时测一次并上报
./yx cron -add "test -n 10 -sl 2 -upload api -clear" -at "0 */6 * * *"

# 看已登记的任务
./yx cron

# 清掉（只删本程序加的，不动你自己的任务）
./yx cron -remove

配置存在二进制同目录的 yx-config.json，-domain -uuid 填过一次之后命令里就能省掉。 任务输出写到程序目录的 yx-cron.log。

Windows 用「任务计划程序」调用 yx.exe test ... 即可。

文件

跑完会在当前目录生成：

• result.csv — 完整测速结果
• ips_ports.txt — 反代列表，IP:端口 一行一条
• yx-config.json — 配置，含 Token，注意别泄露
• Cloudflare.txt / Cloudflare_ipv6.txt — 缓存的官方 IP 段
• yx-cron.log — 定时任务的输出（设了定时任务才有）

相关

• cfnew — 配套的 Worker 面板
• 博客 ｜ YouTube ｜ TG 群

致谢

测速内核来自 XIU2/CloudflareSpeedTest，MIT。

许可

MIT