cloudflare-speed-cli：实践指南

工作中遇到相关需求时，cloudflare-speed-cli值得先读说明，因为它主要用于CLI 通过 cloudflare 进行互联网速度测试。这类软件开发工具真正难在依赖、接口和异常处理往往比主路径更影响采用，仓库说明只能作为第一层证据。更实际的做法是在隔离分支完成一个可回滚的小任务，同时核对安装步骤、接口契约、测试结果和错误信息，不要直接在关键项目上。它对需要可检查开发流程而非单次演示的工程师更有价值，但正式采用前仍要复查许可证、近期提交和问题区回应。

cloudflare-speed-cli

CLI 工具，可在 TUI 界面中显示 Cloudflare 速度测试服务的网络速度测试结果。

demo.webm

特点

• 速度测试：Download/upload 吞吐量、空闲延迟和加载延迟
• 诊断：DNS 分辨率和 TLS 握手时序与每次测试一起运行
• UDP 质量：丢包、抖动和 MOS- 样式链路评分
• IPv4 与 IPv6：可选并排比较 (--compare-ip-versions)，或强制使用 -4/--ipv4-only 和 -6/--ipv6-only 的单个系列
• Traceroute：可选 ICMP 到 Cloudflare 边缘的跟踪路由 (--traceroute)
• 代理支持：通过 HTTP、HTTPS 或 SOCKS5 代理 (--proxy) 进行路由
• TLS 信任：加载 OS 信任库，或使用 --certificate 提供私有 CA
• 接口绑定：绑定到特定网络接口或源 IP
• 交互式TUI：实时图表和统计
• 历史记录：查看和管理过去的测试结果
• 导出：将结果保存为 JSON 或 CSV。用于脚本编写的无头 text/JSON 模式

使用 --help 运行以查看完整的功能列表

安装

货物（crates.io）

如果您安装了货物，我的首选方式：

cargo install cloudflare-speed-cli

要从 git 安装最新的未发布版本：

cargo install --git https://github.com/kavehtehrani/cloudflare-speed-cli --features tui

自制

这适用于较旧的 Intel 和较新的 Silicon Mac 计算机。

brew tap kavehtehrani/tap
brew install cloudflare-speed-cli

MacPorts

支持 Intel 和 Apple Silicon Mac。该软件包可在 官方 MacPorts 存储库 上找到，并且可以通过以下方式安装：

sudo port install cloudflare-speed-cli

安装脚本

对于懒人：

curl -fsSL https://raw.githubusercontent.com/kavehtehrani/cloudflare-speed-cli/main/install.sh | sh

Linux 发行包

正如其他人的善意贡献，我合并了他们对他们拥有的发行版的拉取请求 做出了贡献。我的主要OS是Ubuntu和Fedora，这个包的主要分发机制是通过 'cargo-dist' 我发现它有助于生成兼容的二进制文件 通过 github 操作。如果您想为其他发行版做出贡献，请提出问题或发送拉取请求。

架构Linux

该软件包可以从 官方存储库 安装：

pacman -S cloudflare-speed-cli

NixOS

 nix run github:kavehtehrani/cloudflare-speed-cli

二进制文件

从以下地址下载适合您系统的静态二进制文件 最新发布。

注意：我已经检查了 Linux（x64 和 ARM64）和 Windows 11 上的二进制文件，但我没有 Apple 设备。如果有任何问题请告诉我！

码头工人

如果安装了 docker，则可以通过拉入映像来运行速度测试：

docker pull ghcr.io/kavehtehrani/cloudflare-speed-cli:latest
docker run --rm -it ghcr.io/kavehtehrani/cloudflare-speed-cli

如果您还希望保留运行历史记录，则必须安装一个卷 e.g。 docker run --rm -it -v cloudflare-speed-data:/root/.local/share/cloudflare-speed-cli ghcr.io/kavehtehrani/cloudflare-speed-cli

用途

使用 TUI 运行（默认）：

cloudflare-speed-cli

文本输出方式：

cloudflare-speed-cli --text

要查看所有选项：

cloudflare-speed-cli --help

来源

使用来自 speed.cloudflare.com 的端点 您可以在此处 详细了解 Cloudflare 速度测试的工作原理 [。

未决问题

• Windows 上的网络信息不完整。我已经很多年没有使用 Windows（游戏之外）了，除非有需求，否则我可能不会实现这部分。请随意打开 PR 或问题，我们可以聊天。老实说，存在 Windows 二进制文件的唯一原因是 'cargo-dist' 使得这样做变得如此容易。
• 无法在 macOS Sonoma 14.4 及更高版本上检测到 SSID，因为它现在被视为位置敏感数据。