Cloudflare Speed Test

https://github.com/xiu2/cloudflarespeedtest
Admin
Cloudflare Speed Test is a tool that tests Cloudflare CDN IP latency and download speed to identify...
Tokens:56,035
Snippets:226
Trust Score:8.8
License:GPL-3.0
Update:1 day ago
Show doc for...
Tokens:
Raw
### Example -ip Parameter Usage

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/configuration.md

Shows how to pass IP addresses or CIDR blocks via the -ip command-line parameter. Multiple values are separated by commas, and surrounding whitespace is trimmed.

```bash
cfst -ip 1.1.1.1,2.2.2.2/24,2606:4700::/32
```

--------------------------------

### Example IP Address Data in ip.txt

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/configuration.md

Shows the expected format for the default IP segment data file (ip.txt or ipv6.txt). Each line contains a CIDR block, and IPv4 and IPv6 can be mixed. Lines without a slash are automatically treated as a single IP with /32 for IPv4 or /128 for IPv6.

```plaintext
173.245.48.0/20
104.16.0.0/12
2606:4700::/32
```

--------------------------------

### File relative/absolute path examples

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

Shows how to specify input and output file paths for cfst, both relative and absolute, on Linux and Windows. On Windows, use backslashes. When running cfst with an absolute path, the -f and -o arguments must also be absolute paths, otherwise an error occurs.

```bash
# 指定 IPv4 数据文件，不显示结果直接退出，输出结果到文件（-p 值为 0）
cfst -f 1.txt -p 0 -dd

# 指定 IPv4 数据文件，不输出结果到文件，直接显示结果（-p 值为 10 条，-o 值为空但引号不能少）
cfst -f 2.txt -o "" -p 10 -dd

# 指定 IPv4 数据文件 及 输出结果到文件（相对路径，即当前目录下，如含空格请加上引号）
cfst -f 3.txt -o result.txt -dd


# 指定 IPv4 数据文件 及 输出结果到文件（相对路径，即当前目录内的 abc 文件夹下，如含空格请加上引号）
# Linux（CFST 程序所在目录内的 abc 文件夹下）
./cfst -f abc/3.txt -o abc/result.txt -dd

# Windows（注意是反斜杠）
cfst -f abc\3.txt -o abc\result.txt -dd


# 指定 IPv4 数据文件 及 输出结果到文件（绝对路径，即 C:\abc\ 目录下，如含空格请加上引号）
# Linux（/abc/ 目录下）
./cfst -f /abc/4.txt -o /abc/result.csv -dd

# Windows（注意是反斜杠）
cfst -f C:\abc\4.txt -o C:\abc\result.csv -dd


# 如果要以【绝对路径】运行 CFST，那么 -f / -o 参数中的文件名也必须是【绝对路径】，否则会报错找不到文件！
# Linux（/abc/ 目录下）
/abc/cfst -f /abc/4.txt -o /abc/result.csv -dd

# Windows（注意是反斜杠）
C:\abc\cfst -f C:\abc\4.txt -o C:\abc\result.csv -dd
```

--------------------------------

### HTTPing latency test mode examples

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

Shows how to enable HTTPing mode with -httping, set valid HTTP status codes with -httping-code, specify a test URL with -url, and adjust the port with -tp. HTTPing uses response headers only, has a 2-second timeout, and is more sensitive to network loss than TCPing. Lower concurrency (-n) is advised to avoid being flagged as network scanning.

```bash
# 只需加上 -httping 参数即可切换到 HTTP 协议延迟测速模式
cfst -httping

# 软件会根据访问时网页返回的有效 HTTP 状态码来判断可用性（当然超时也算），默认对返回 200 301 302 这三个 HTTP 状态码的视为有效，可以手动指定认为有效的 HTTP 状态码，但只能指定一个（你需要提前确定测试地址正常情况下会返回哪个状态码）
cfst -httping -httping-code 200

# 通过 -url 参数来指定 HTTPing 测试地址（可以是任意网页 URL，不局限于具体文件地址）
cfst -httping -url https://cf.xiu2.xyz/url
# 如果你要 HTTPing 测试其他网站/CDN，那么指定一个该网站/使用该 CDN 的地址（因为软件默认地址是 Cloudflare 的，只能用于测试 Cloudflare 的 IP）

# 注意：如果测速地址为 HTTP 协议，记得加上 -tp 80（这个参数会影响 延迟测速/下载测速 时使用的端口）
# 同理，如果要测速 80 端口，那么也需要加上 -url 参数来指定一个 http:// 协议的地址才行（且该地址不会强制重定向至 HTTPS），如果是非 80 443 端口，那么需要确定该下载测速地址是否支持通过该端口访问。
cfst -httping -tp 80 -url http://cdn.cloudflare.steamstatic.com/steam/apps/5952/movie_max.webm
```

--------------------------------

### task/download.go:27 导出变量 URL、Timeout、Disable、TestCount、MinSpeed

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/task.md

定义下载测速相关的导出变量。URL 为测速地址，HTTPing 延迟测速与下载测速共用；Timeout 为单 IP 下载测速最长时长，默认 10s；Disable 为 true 时跳过下载测速（结果按延迟排序）；TestCount 为下载测速数量（期望凑够的满足条件 IP 数）；MinSpeed 为下载速度下限（单位 MB/s）。

```go
var (
	URL     = defaultURL
	Timeout = defaultTimeout
	Disable = defaultDisableDownload

	TestCount = defaultTestNum
	MinSpeed  = defaultMinSpeed
)
```

--------------------------------

### 调用 TestDownloadSpeed 进行下载测速

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/task.md

在 main 中调用 task.NewPing().Run().FilterDelay().FilterLossRate() 获取延迟测速结果，再传给 task.TestDownloadSpeed 执行下载测速，返回按下载速度降序的 DownloadSpeedSet。

```go
pingData := task.NewPing().Run().FilterDelay().FilterLossRate()
speedData := task.TestDownloadSpeed(pingData)
```

--------------------------------

### Windows 快捷方式带参数运行 CFST

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

通过修改快捷方式的目标来配置运行参数。若要不输出结果文件，需添加 `-o " "`（引号内为空格）。若文件路径包含引号，需将启动参数放在引号外，并确保引号和 `-` 之间有空格。注意快捷方式的起始位置不能为空，否则会因绝对路径找不到 ip.txt。

```bash
# 如果要不输出结果文件，那么请加上 -o " "，引号里的是空格（不加空格会导致该空参数被忽略从而报错）。
D:\ABC\cfst\cfst.exe -tl 200 -dn 20 -o " "

# 如果文件路径包含引号，则需要把启动参数放在引号外面，记得引号和 - 之间有空格。
"D:\Program Files\cfst\cfst.exe" -tl 200 -dn 20 -o " "

# 注意！快捷方式 - 起始位置 不能是空的，否则就会因为绝对路径而找不到 ip.txt 文件
```

--------------------------------

### task/ip.go:16 导出变量 TestAll、IPFile、IPText

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/task.md

定义 IP 段装载相关的导出变量。TestAll 为 true 时逐一测试每个 IPv4，否则每个 /24 段随机采样一个；IPFile 为 IP 段数据文件名，为空时回落为 defaultInputFile；IPText 直接通过参数指定 IP 段数据，非空时优先于 IPFile。

```go
var (
	// TestAll test all ip
	TestAll = false
	// IPFile is the filename of IP Rangs
	IPFile = defaultInputFile
	IPText string
)
```

--------------------------------

### 预置颜色输出变量 (utils/color.go)

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/utils.md

定义了一组预置的 *color.Color 变量，用于终端彩色输出。Blue 和 Cyan 使用 Bold 样式，其余为普通前景色。用法与 github.com/fatih/color 一致。

```go
var (
	Red     = color.New(color.FgRed)                // 红色 31
	Green   = color.New(color.FgGreen)              // 绿色 32
	Yellow  = color.New(color.FgYellow)             // 黄色 33
	Blue    = color.New(color.FgBlue, color.Bold)   // 蓝色 34
	Magenta = color.New(color.FgMagenta)            // 紫红色 35
	Cyan    = color.New(color.FgHiCyan, color.Bold) // 青色 36
	White   = color.New(color.FgWhite)              // 白色 37
)
```

--------------------------------

### main 函数：测速流水线

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/main.md

main 函数执行完整的测速流程：初始化随机种子，进行延迟测速并过滤，下载测速，导出 CSV，打印结果，最后根据平台决定退出方式。

```go
func main() {
	task.InitRandSeed() // 置随机数种子

	fmt.Printf("# XIU2/CloudflareSpeedTest %s \n\n", version)

	// 开始延迟测速 + 过滤延迟/丢包
	pingData := task.NewPing().Run().FilterDelay().FilterLossRate()
	// 开始下载测速
	speedData := task.TestDownloadSpeed(pingData)
	utils.ExportCsv(speedData) // 输出文件
	speedData.Print()          // 打印结果
	endPrint()                 // 根据情况选择退出方式（针对 Windows）
}
```

--------------------------------

### 包级配置变量 (utils/csv.go)

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/utils.md

定义包级配置变量，用于控制测速结果的过滤和输出。这些变量对应命令行参数，如 -tl、-tll、-tlr、-o、-p 和 -debug。

```go
var (
	InputMaxDelay    = maxDelay
	InputMinDelay    = minDelay
	InputMaxLossRate = maxLossRate
	Output           = defaultOutput
	PrintNum         = 10
	Debug            = false // 是否开启调试模式
)
```

--------------------------------

### task/tcping.go:22 导出变量 Routines、TCPPort、PingTimes

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/task.md

定义 TCP 延迟测速相关的导出变量。Routines 为延迟测速并发数（控制 channel 容量），默认 200；TCPPort 为测速端口（延迟与下载测速共用），默认 443；PingTimes 为单 IP 延迟测速次数，默认 4。

```go
var (
	Routines      = defaultRoutines
	TCPPort   int = defaultPort
	PingTimes int = defaultPingTimes
)
```

--------------------------------

### 目录结构树

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/overview.md

展示项目主要目录与文件布局，包括 main.go、task/、utils/ 和 script/ 目录及其职责。

```text
main.go      —— 入口点：注册全部 CLI 参数（flag）、组装测速流水线、版本检查
task/        —— 测速业务逻辑包（import "github.com/XIU2/CloudflareSpeedTest/task"）
  ├── ip.go        —— IP 段装载与随机采样
  ├── tcping.go    —— TCP 延迟测速（Ping 类型）
  ├── httping.go   —— HTTP 延迟测速与地区码（Colo）提取
  └── download.go  —— 下载测速
utils/       —— 数据结构、排序/过滤、CSV 导出、终端输出（import "github.com/XIU2/CloudflareSpeedTest/utils"）
  ├── csv.go      —— PingData / CloudflareIPData / PingDelaySet / DownloadSpeedSet
  ├── color.go    —— 预置颜色输出变量
  └── progress.go —— 进度条封装（Bar）
script/      —— 外置 shell/bat 脚本（调用 cfst 后处理结果，如更新 Hosts、DDNS 等），不属于 Go 源码
```

--------------------------------

### 使用 scoop 安装 cloudflare-speedtest

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

在 Windows 系统下，通过 scoop 命令行安装程序添加 dorado 仓库并安装 cloudflare-speedtest。

```sh
# 添加最多人使用的中文软件包仓库：dorado
scoop bucket add dorado https://github.com/chawyehsu/dorado
# 安装cloudflare-speedtest
scoop install dorado/cloudflare-speedtest
```

--------------------------------

### 同时指定平均延迟上限和下载速度下限 (cfst -tl 200 -sl 5.6 -dn 10)

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

使用 -tl、-sl 和 -dn 参数设置延迟上限、速度下限和数量。支持小数。若未找到满足条件的 IP，则输出空；可加 -debug 忽略条件输出所有结果。建议先不指定条件测速一遍以了解范围。

```bash
# 平均延迟上限、下载速度下限均支持小数（如 -sl 0.5）
# 平均延迟上限：200 ms，下载速度下限：5.6 MB/s，数量：10 个（可选）
# 即需要找到 10 个平均延迟低于 200 ms 且下载速度高于 5 .6MB/s 的 IP 才会停止测速
cfst -tl 200 -sl 5.6 -dn 10
```

--------------------------------

### Compile with version number using go build -ldflags

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

Run this command in the CloudflareSpeedTest directory to compile a binary for the current system with version v1.0.0. Go automatically detects the system's bits and architecture.

```bash
go build -ldflags "-s -w -X main.version=v1.0.0"
# 在 CloudflareSpeedTest 目录中通过命令行（例如 CMD、Bat 脚本）运行该命令，即可编译一个可在和当前设备同样系统、位数、架构的环境下运行的二进制程序（Go 会自动检测你的系统位数、架构）且版本号为 v1.0.0
```

--------------------------------

### Bar 结构体定义（utils/progress.go:9）

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/utils.md

定义 Bar 结构体，内部封装了 pb.ProgressBar 实例，字段为包私有。

```go
type Bar struct {
	pb *pb.ProgressBar
}
```

--------------------------------

### NewBar 调用示例（task/tcping.go:60）

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/utils.md

在 task.NewPing 中创建进度条，传入 IP 数量作为总数，并设置起始和结束装饰文本。

```go
bar := utils.NewBar(len(ips), "可用:", "") // task/tcping.go:60
```

--------------------------------

### Linux/macOS 下载、解压并运行 CFST

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

在 Linux 或 macOS 系统上，通过命令行创建文件夹、下载最新版 CFST 压缩包、解压、赋予执行权限并运行。包含带参数运行示例和国内镜像加速选项。

```yaml
# 如果是第一次使用，则建议创建新文件夹（后续更新时，跳过该步骤）
mkdir cfst

# 进入文件夹（后续更新，只需要从这里重复下面的下载、解压命令即可）
cd cfst

# 下载 CFST 压缩包（这个地址是始终指向最新版本，可自行根据需求替换 URL 末尾的 [文件名]）
wget -N https://github.com/XIU2/CloudflareSpeedTest/releases/latest/download/cfst_linux_amd64.tar.gz
# 如果你是在国内网络环境中下载，那么请使用下面这几个镜像加速之一：
# wget -N https://wget.la/https://github.com/XIU2/CloudflareSpeedTest/releases/latest/download/cfst_linux_amd64.tar.gz
# wget -N https://ghfast.top/https://github.com/XIU2/CloudflareSpeedTest/releases/latest/download/cfst_linux_amd64.tar.gz
# wget -N https://ghproxy.it/https://github.com/XIU2/CloudflareSpeedTest/releases/latest/download/cfst_linux_amd64.tar.gz
# wget -N https://gh-proxy.org/https://github.com/XIU2/CloudflareSpeedTest/releases/latest/download/cfst_linux_amd64.tar.gz
# wget -N https://cdn.gh-proxy.org/https://github.com/XIU2/CloudflareSpeedTest/releases/latest/download/cfst_linux_amd64.tar.gz
# 如果下载失败的话，尝试删除 -N 参数（如果是为了更新，则记得提前删除旧压缩包 rm cfst_linux_amd64.tar.gz ）
# 如果要下载特定版本的，可以改用这种，例如：wget -N https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.4/cfst_linux_amd64.tar.gz

# 解压（不需要删除旧文件，会直接覆盖，自行根据需求替换 文件名）
tar -zxf cfst_linux_amd64.tar.gz

# 赋予执行权限
chmod +x cfst

# 运行（不带参数）
./cfst

# 运行（带参数示例）
./cfst -tl 200 -dn 20
```

--------------------------------

### CloudflareIPData 结构体 (utils/csv.go)

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/utils.md

定义测速结果的数据结构，嵌入 *PingData 并增加下载速度和私有丢包率字段。

```go
type CloudflareIPData struct {
	*PingData
	lossRate      float32
	DownloadSpeed float64
}
```

--------------------------------

### task/httping.go:18 导出变量 Httping、HttpingStatusCode、HttpingCFColo、HttpingCFColomap 及正则表达式

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/task.md

定义 HTTP 延迟测速与地区码提取相关的导出变量和正则表达式。Httping 为 true 时延迟测速改用 HTTP 协议；HttpingStatusCode 为有效状态码，0 或非法值（<100 或 >599）时按默认 200/301/302 判定；HttpingCFColo 为需匹配的地区码，逗号分隔，大小写均可；HttpingCFColomap 为大写地区码到自身的映射表，供 filterColo 查表。正则表达式分别匹配 IATA 三字机场码、二字国家码和 Gcore 二字小写城市码。

```go
var (
	Httping           bool
	HttpingStatusCode int
	HttpingCFColo     string
	HttpingCFColomap  *sync.Map
	RegexpColoIATACode    = regexp.MustCompile(`[A-Z]{3}`)  // 匹配 IATA 机场地区码（俗称 机场三字码）的正则表达式
	RegexpColoCountryCode = regexp.MustCompile(`[A-Z]{2}`)  // 匹配国家地区码的正则表达式（如 US、CN、UK 等）
	RegexpColoGcore       = regexp.MustCompile(`^[a-z]{2}`) // 匹配城市地区码的正则表达式（小写，如 us、cn、uk 等）
)
```

--------------------------------

### 通过文件指定 IP 段 (cfst -f 1.txt)

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/README.md

将 IP 段按格式写入文本文件，使用 -f 参数指定该文件。单个 IP 可省略 /32 子网掩码。若需测速 /24 段内所有 IP，需加 -allip 参数。

```text
1.1.1.1
1.1.1.200
1.0.0.1/24
2606:4700::/32
```

```bash
# 先进入 CFST 所在目录，然后运行：
# Windows 系统（在 CMD 中运行）
cfst -f 1.txt

# Linux 系统
./cfst -f 1.txt

# 对于 1.0.0.1/24 这样的 IP 段只会随机最后一段（1.0.0.1~255），如果要测速该 IP 段中的所有 IP，请加上 -allip 参数。
```

--------------------------------

### 常量定义 (utils/csv.go)

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/utils.md

定义默认输出文件名、延迟和丢包率的常量。这些常量用于初始化配置变量。

```go
const (
	defaultOutput         = "result.csv"
	maxDelay              = 9999 * time.Millisecond
	minDelay              = 0 * time.Millisecond
	maxLossRate   float32 = 1.0
)
```

--------------------------------

### 版本检查与帮助命令

Source: https://github.com/xiu2/cloudflarespeedtest/blob/master/_autodocs/api-reference/main.md

打印版本并检查更新（网络失败时静默忽略），以及显示帮助信息。

```bash
# 打印版本并检查更新（网络失败时静默忽略）
cfst -v

# 帮助
cfst -h
```
Tokens:
Raw