终端里的网速测试神器cloudflare-speed-cli:基于Cloudflare网络的终极指南
终端里的网速测试神器cloudflare-speed-cli:基于Cloudflare网络的终极指南
cloudflare-speed-cli 是一款运行在终端里的免费网速测试工具,它基于 Cloudflare 全球边缘网络测速,不仅能测出下载/上传带宽和延迟,还能一键完成 DNS、TLS 握手、丢包、抖动等全套网络诊断,并用漂亮的 TUI 图表实时展示结果。对于经常在服务器、命令行环境下工作,或者想长期记录网速变化的新手和普通用户来说,这是一个开箱即用的"终端测速神器"。
为什么选择 cloudflare-speed-cli?
大多数测速网页只能给你两个数字:下载速度和上传速度。而 cloudflare-speed-cli 做的事情要多得多:
- ⚡ 速度测试:下载/上传吞吐量、空闲延迟、加载时延迟一次测全
- 🔍 网络诊断:每次测试自动附带 DNS 解析耗时和 TLS 握手耗时
- 📶 UDP 质量:丢包率、抖动(jitter)、MOS 风格链路评分
- 🌐 IPv4 vs IPv6:支持两种协议并排对比,也可强制只用其中一种
- 🧭 路由追踪:可选 ICMP traceroute,看清到 Cloudflare 边缘节点的路径
- 📊 交互式 TUI:实时曲线图、统计面板、历史记录一应俱全
- 💾 历史与导出:自动保存每次结果,支持导出 JSON / CSV,方便做长期网速趋势分析
测试数据来自 Cloudflare 官方的 speed.cloudflare.com 测速服务,节点分布在全球各地,通常会自动选择离你最近的边缘节点,测得又快又准。
快速安装:一行命令搞定
cloudflare-speed-cli 用 Rust 编写(见 Cargo.toml),安装方式非常丰富,选一种适合你的即可。
方式一:Cargo 安装(推荐 Rust 用户)
cargo install cloudflare-speed-cli
方式二:Homebrew(macOS 用户)
brew install kavehtehrani/tap/cloudflare-speed-cli
Intel 和 Apple Silicon 芯片的 Mac 都支持。
方式三:一键安装脚本(最省事)
脚本会自动识别系统架构、下载对应的预编译二进制并校验 SHA256 后安装(脚本源码:install.sh):
curl -fsSL https://raw.githubusercontent.com/kavehtehrani/cloudflare-speed-cli/main/install.sh | sh
方式四:Docker 运行
docker pull ghcr.io/kavehtehrani/cloudflare-speed-cli:latest
docker run --rm -it ghcr.io/kavehtehrani/cloudflare-speed-cli
提示:Arch Linux 可直接
pacman -S cloudflare-speed-cli;更多发行版包与编译产物见仓库的 Dockerfile 与发布流程。
第一次测速:TUI 界面怎么玩
安装完成后,直接运行即可进入交互式 TUI 界面,并自动开始测试:
cloudflare-speed-cli
默认会依次执行:空闲延迟探测 → 下载测试(默认 10 秒)→ 上传测试(默认 10 秒)→ UDP 丢包探测。Dashboard 页面实时显示下载/上传 Mbps 曲线,以及 avg / med(中位数)/ p25 / p75 等统计值,底部还有 DNS 解析耗时、TLS 握手耗时和服务器位置等网络信息。
常用键盘快捷键
| 按键 | 功能 |
|---|---|
Tab |
切换 Dashboard / History / Charts 标签页 |
r |
重新测试 |
p |
暂停 / 继续测试 |
s |
手动保存本次结果为 JSON |
a |
开关自动保存 |
? |
查看帮助 |
q |
退出 |
所有参数都可以通过 cloudflare-speed-cli --help 查看,例如 --download-duration 20s 可以延长下载测试时间,--concurrency 8 可以提高并发数(参数定义见 src/cli.rs)。
脚本与自动化:无界面测速模式
如果你在 CI 或 cron 任务中使用,可以跳过 TUI 直接输出结果:
cloudflare-speed-cli --text # 输出文本摘要
cloudflare-speed-cli --json # 输出 JSON,方便脚本解析
还可以把结果直接落盘,用于归档分析:
cloudflare-speed-cli --export-json result.json --export-csv result.csv
无 TUI 模式的输出格式实现位于 src/event_format.rs,主入口在 src/main.rs。
进阶玩法:网络诊断与对比
除了测速,cloudflare-speed-cli 还是一套轻量网络诊断工具,常用参数如下:
# 对比 IPv4 与 IPv6 的速度差异
cloudflare-speed-cli --compare-ip-versions
# 强制只用 IPv4 / IPv6
cloudflare-speed-cli -4
cloudflare-speed-cli -6
# 附带 traceroute,查看到 Cloudflare 边缘的路由路径
cloudflare-speed-cli --traceroute
# 指定网卡或源 IP 测速(适合多网卡服务器)
cloudflare-speed-cli --interface eth0
# 通过代理测速(HTTP / HTTPS / SOCKS5)
cloudflare-speed-cli --proxy socks5://127.0.0.1:1080
UDP 丢包与抖动的探测逻辑在 src/engine/turn_udp.rs,traceroute 实现在 src/engine/traceroute.rs,DNS 与 TLS 诊断分别在 src/engine/dns.rs 和 src/engine/tls.rs。
测完后工具还会给出"连接质量"评分:基于 bufferbloat(加载延迟增量)、吞吐稳定性(变异系数)等指标打分,实现位于 src/quality.rs,帮你一眼判断这条链路到底稳不稳。
历史记录:长期追踪你的网速变化
每次测试结果默认自动保存。按 Tab 切换到 History 标签页,可以看到按时间排列的所有测试记录,包含下载、上传、Ping、网卡和所在网络(SSID)等列:
Enter查看某次测试的完整 JSON 详情/按关键字过滤(比如只看某张 Wi-Fi 网络)d删除记录,e/c导出为 JSON / CSVr刷新列表
数据按 JSON 文件存储在本地用户目录下(加载逻辑见 src/storage.rs)。切到 Charts 标签页,还能把不同网络的历次测速画成柱状图对比——换运营商、升级宽带、折腾路由器之后效果如何,一目了然。
TUI 的渲染与交互逻辑都在 src/tui/ 目录下,想深入了解可以看看 src/tui/mod.rs 和 src/tui/history.rs。
常见问题
Windows / macOS 上网络信息不完整? 这是已知限制:Windows 的网络信息展示不完整;macOS Sonoma 14.4 之后因隐私政策无法读取 SSID,详见 README.md 的 Outstanding Issues 部分。
测速结果和网页版不一样?
属正常现象。测速结果受并发数(默认 6)、测试时长(默认各 10 秒)影响,可用 --concurrency 和 --download-duration 调整。
想更新到最新版? TUI 启动时会自动在后台检查更新并提示;CLI 用户按上面任一安装方式重装即可。
小结
cloudflare-speed-cli 把"网页测速"搬进了终端,并且做得更完整:一条命令完成带宽、延迟、DNS、TLS、丢包、路由的全方位体检,历史记录 + 图表让你轻松追踪长期网速变化。如果你经常使用命令行,或者想给家里的网络建一份"体检档案",不妨现在就装上一个试试。


