终端里的网速测试神器cloudflare-speed-cli:基于Cloudflare网络的终极指南

原创2026-10-14 14:24:541,605 阅读

终端里的网速测试神器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 终端网速测试仪表盘,实时显示下载上传带宽与延迟曲线

快速安装:一行命令搞定

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 网速测试历史图表,对比多个网络下的下载上传带宽

进阶玩法:网络诊断与对比

除了测速,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 / CSV
  • r 刷新列表

cloudflare-speed-cli 网速测试历史记录页面,展示多次测速的下载上传与延迟数据

数据按 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、丢包、路由的全方位体检,历史记录 + 图表让你轻松追踪长期网速变化。如果你经常使用命令行,或者想给家里的网络建一份"体检档案",不妨现在就装上一个试试。

登录后查看全文
cloudflare-speed-cli