新增支持显示地区码(机场三字码，仅限 Cloudflare、AWS CloudFront，HTTPing 和下载测速(无论是哪个测速模式)过程中都会自动获取);

新增调试模式运行参数(-debug 方便排查下载测速过程中遇到的问题); 新增彩色输出内容; 调整当没找到符合速度条件的 IP 时，默认不再直接忽略条件输出所有 IP 测速结果了，而是只有在调试模式下才会输出;
Merge pull request #538 from ipcjs/patch-1
2026-03-08 15:45:53 +08:00 · 2025-06-29 00:30:05 +08:00 · 2025-05-11 14:49:04 +08:00 · 2025-03-25 13:17:30 +08:00 · 2025-01-22 23:58:37 +08:00 · 2025-01-22 23:56:45 +08:00
14 changed files with 564 additions and 154 deletions
--- a/.github/ISSUE_TEMPLATE/01-bugReport.yml
+++ b/.github/ISSUE_TEMPLATE/01-bugReport.yml
@@ -7,7 +7,8 @@ body:
      value: |
        发之前，请先搜下有没有类似的 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues)、[**Discussions**](https://github.com/XIU2/CloudflareSpeedTest/discussions) 问题（包括[**已关闭**](https://github.com/XIU2/CloudflareSpeedTest/issues?q=is%3Aissue+is%3Aclosed)的），请勿重复发起！

-        注意！如果你反馈的问题和 CloudflareST **软件本身功能无关**（如关于 Cloudflare CDN 的网络问题），请**前往讨论区** (💬 [**Discussions**](https://github.com/XIU2/CloudflareSpeedTest/discussions)) 发帖交流！（不合适的 Issues 会被转过去
+        > [!NOTE]
+        > 注意！如果你反馈的问题和 CloudflareST **软件本身功能无关**（如关于 Cloudflare CDN 的网络问题），请**前往讨论区** (💬 [**Discussions**](https://github.com/XIU2/CloudflareSpeedTest/discussions)) 发帖交流！（不合适的 Issues 会被转过去
        ****
  - type: textarea
    id: description
--- a/.github/ISSUE_TEMPLATE/02-featureRequest.yml
+++ b/.github/ISSUE_TEMPLATE/02-featureRequest.yml
@@ -7,9 +7,11 @@ body:
      value: |
        发之前，请先搜下有没有类似的 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues)、[**Discussions**](https://github.com/XIU2/CloudflareSpeedTest/discussions) 问题（包括[**已关闭**](https://github.com/XIU2/CloudflareSpeedTest/issues?q=is%3Aissue+is%3Aclosed)的），请勿重复发起！

-        注意！如果你提的功能建议和 CloudflareST **软件本身功能无关**，请**前往讨论区** (💬 [**Discussions**](https://github.com/XIU2/CloudflareSpeedTest/discussions)) 发帖交流！
+        > [!NOTE]
+        > 注意！如果你提的功能建议和 CloudflareST **软件本身功能无关**，请**前往讨论区** (💬 [**Discussions**](https://github.com/XIU2/CloudflareSpeedTest/discussions)) 发帖交流！

-        > 另外，不接受**个性化**的功能请求（即 **很少人** 或 **只有你自己** 才会用到的功能）
+        > [!TIP]
+        > 另外，不接受**个性化**的小众功能请求（即 **很少人** 或 **只有你自己** 才会用到的功能）
        ****
  - type: textarea
    id: description
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -2,4 +2,4 @@ blank_issues_enabled: false
 contact_links:
  - name: 前往讨论区 (💬 Discussions)
    url: https://github.com/XIU2/CloudflareSpeedTest/discussions
-    about: Issues 仅用于反馈问题、功能建议，其他话题请到 💬 Discussions 发帖讨论（不合适的 Issues 会被转过去
+    about: Issues 仅用于对 CloudflareST 本身的反馈问题、功能建议，其他话题请到 💬 Discussions 发帖讨论（不合适的 Issues 会被转过去
--- a/README.md
+++ b/README.md
@@ -17,16 +17,32 @@

 > 本项目也支持对**其他 CDN / 网站 IP** 延迟测速（如：[CloudFront](https://github.com/XIU2/CloudflareSpeedTest/discussions/304)、[Gcore](https://github.com/XIU2/CloudflareSpeedTest/discussions/303) CDN），但下载测速需自行寻找地址

-> 对于**代理套 Cloudflare CDN** 的用户，须知这应为**备用方案**，而不应该是**唯一方案**，请勿过度依赖 [#382](https://github.com/XIU2/CloudflareSpeedTest/discussions/382) [#383](https://github.com/XIU2/CloudflareSpeedTest/discussions/383)
+> [!IMPORTANT]
+> Cloudflare CDN 已**明文禁止代理**方式使用，对于**代理套 CDN** 的自行承担风险，请勿过度依赖 [#382](https://github.com/XIU2/CloudflareSpeedTest/discussions/382) [#383](https://github.com/XIU2/CloudflareSpeedTest/discussions/383)

 ****
 ## \# 快速使用

 ### 下载运行

-1. 下载编译好的可执行文件（ [Github Releases](https://github.com/XIU2/CloudflareSpeedTest/releases) / [蓝奏云](https://pan.lanzouj.com/b0742hkxe) ）并解压。  
+1. 下载编译好的可执行文件（ [Github Releases](https://github.com/XIU2/CloudflareSpeedTest/releases) / [蓝奏云](https://pan.lanpw.com/b0742hkxe) ）并解压。  
 2. 双击运行 `CloudflareST.exe` 文件（Windows 系统），等待测速完成...

+<details>
+<summary><code><strong>「 点击查看 Windows 系统下其他安装方式」</strong></code></summary>
+
+****
+
+通过scoop安装:
+```sh
+# 添加最多人使用的中文软件包仓库：dorado
+scoop bucket add dorado https://github.com/chawyehsu/dorado
+# 安装cloudflare-speedtest
+scoop install dorado/cloudflare-speedtest
+```
+
+</details>
+
 <details>
 <summary><code><strong>「 点击查看 Linux 系统下的使用示例 」</strong></code></summary>

@@ -42,11 +58,12 @@ mkdir CloudflareST
 cd CloudflareST

 # 下载 CloudflareST 压缩包（自行根据需求替换 URL 中 [版本号] 和 [文件名]）
-wget -N https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.2.4/CloudflareST_linux_amd64.tar.gz
-# 如果你是在国内服务器上下载，那么请使用下面这几个镜像加速：
-# wget -N https://download.fgit.ml/XIU2/CloudflareSpeedTest/releases/download/v2.2.4/CloudflareST_linux_amd64.tar.gz
-# wget -N https://download.fgit.gq/XIU2/CloudflareSpeedTest/releases/download/v2.2.4/CloudflareST_linux_amd64.tar.gz
-# wget -N https://ghproxy.com/https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.2.4/CloudflareST_linux_amd64.tar.gz
+wget -N https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.0/CloudflareST_linux_amd64.tar.gz
+# 如果你是在国内网络环境中下载，那么请使用下面这几个镜像加速之一：
+# wget -N https://ghp.ci/https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.0/CloudflareST_linux_amd64.tar.gz
+# wget -N https://ghproxy.cc/https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.0/CloudflareST_linux_amd64.tar.gz
+# wget -N https://ghproxy.net/https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.0/CloudflareST_linux_amd64.tar.gz
+# wget -N https://gh-proxy.com/https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.0/CloudflareST_linux_amd64.tar.gz
 # 如果下载失败的话，尝试删除 -N 参数（如果是为了更新，则记得提前删除旧压缩包 rm CloudflareST_linux_amd64.tar.gz ）

 # 解压（不需要删除旧文件，会直接覆盖，自行根据需求替换 文件名）
@@ -71,24 +88,25 @@ chmod +x CloudflareST

 > _在**手机**上独立运行 CloudflareST 测速的简单教程：**[Android](https://github.com/XIU2/CloudflareSpeedTest/discussions/61)、[Android APP](https://github.com/xianshenglu/cloudflare-ip-tester-app)、[IOS](https://github.com/XIU2/CloudflareSpeedTest/discussions/321)**_

-> 注意！本软件仅适用于网站，**不支持给 Cloudflare WARP 优选 IP**，具体见：[#392](https://github.com/XIU2/CloudflareSpeedTest/discussions/392)
+> [!NOTE]
+> 注意！本软件仅适用于网站，**不支持给使用 UDP 协议的 Cloudflare WARP 优选 IP**，具体见：[#392](https://github.com/XIU2/CloudflareSpeedTest/discussions/392)

 ### 结果示例

-测速完毕后，默认会显示**最快的 10 个 IP**，示例：
+测速完毕后，默认会显示**最快的 10 个 IP**，示例（仅为输出内容示例）：

 ``` bash
-IP 地址           已发送  已接收  丢包率  平均延迟  下载速度 (MB/s)
-104.27.200.69     4       4       0.00    146.23    28.64
-172.67.60.78      4       4       0.00    139.82    15.02
-104.25.140.153    4       4       0.00    146.49    14.90
-104.27.192.65     4       4       0.00    140.28    14.07
-172.67.62.214     4       4       0.00    139.29    12.71
-104.27.207.5      4       4       0.00    145.92    11.95
-172.67.54.193     4       4       0.00    146.71    11.55
-104.22.66.8       4       4       0.00    147.42    11.11
-104.27.197.63     4       4       0.00    131.29    10.26
-172.67.58.91      4       4       0.00    140.19    9.14
+IP 地址           已发送  已接收  丢包率  平均延迟  下载速度(MB/s)  地区码
+104.27.200.69     4      4       0.00   146.23    28.64          LAX
+172.67.60.78      4      4       0.00   139.82    15.02          SEA
+104.25.140.153    4      4       0.00   146.49    14.90          SJC
+104.27.192.65     4      4       0.00   140.28    14.07          LAX
+172.67.62.214     4      4       0.00   139.29    12.71          LAX
+104.27.207.5      4      4       0.00   145.92    11.95          LAX
+172.67.54.193     4      4       0.00   146.71    11.55          LAX
+104.22.66.8       4      4       0.00   147.42    11.11          SEA
+104.27.197.63     4      4       0.00   131.29    10.26          FRA
+172.67.58.91      4      4       0.00   140.19    9.14           SJC
 ...

 # 如果平均延迟非常低（如 0.xx），则说明 CloudflareST 测速时走了代理，请先关闭代理软件后再测速。
@@ -101,10 +119,12 @@ IP 地址           已发送  已接收  丢包率  平均延迟  下载速度

 # 软件在 默认参数 下的整个流程大概步骤：
 # 1. 延迟测速（默认 TCPing 模式，HTTPing 模式需要手动加上参数）
-# 2. 延迟排序（延迟从低到高排序并按条件过滤，不同丢包率的会分开独立排序，因此可能会有一些延迟低但丢包的 IP 被排到后面）
+# 2. 延迟排序（延迟 从低到高 排序并按条件过滤，不同丢包率会分开排序，因此可能会有一些延迟低但丢包的 IP 排到后面）
 # 3. 下载测速（从延迟最低的 IP 开始依次下载测速，默认测够 10 个就会停止）
 # 4. 速度排序（速度从高到低排序）
 # 5. 输出结果（通过参数控制是否输出到命令行(-p 0)或输出到文件(-o "")）
+
+# 注意：输出的结果文件 result.csv 通过微软 Excel 表格打开会中文乱码，这是正常的，其他表格软件/记事本都显示正常
 ```

 测速结果第一行就是**既下载速度最快、又平均延迟最低的最快 IP**！
@@ -112,8 +132,8 @@ IP 地址           已发送  已接收  丢包率  平均延迟  下载速度
 完整结果保存在当前目录下的 `result.csv` 文件中，用**记事本/表格软件**打开，格式如下：

 ```
-IP 地址, 已发送, 已接收, 丢包率, 平均延迟, 下载速度 (MB/s)
-104.27.200.69,4,4,0.00,146.23,28.64
+IP 地址,已发送,已接收,丢包率,平均延迟,下载速度(MB/s),地区码
+104.27.200.69,4,4,0.00,146.23,28.64,LAX
 ```

 > _大家可以按自己需求，对完整结果**进一步筛选处理**，或者去看一看进阶使用**指定过滤条件**！_
@@ -123,7 +143,7 @@ IP 地址, 已发送, 已接收, 丢包率, 平均延迟, 下载速度 (MB/s)

 直接运行使用的是默认参数，如果想要测速结果更全面、更符合自己的要求，可以自定义参数。

-```css
+```Dart
 C:\>CloudflareST.exe -h

 CloudflareSpeedTest vX.X.X
@@ -143,15 +163,17 @@ https://github.com/XIU2/CloudflareSpeedTest
        指定测速端口；延迟测速/下载测速时使用的端口；(默认 443 端口)
    -url https://cf.xiu2.xyz/url
        指定测速地址；延迟测速(HTTPing)/下载测速时使用的地址，默认地址不保证可用性，建议自建；
+        当下载测速时，软件会从 HTTP 响应头中获取该 IP 当前的机场地区码（支持 Cloudflare、AWS CloudFront）并显示出来。

    -httping
        切换测速模式；延迟测速模式改为 HTTP 协议，所用测试地址为 [-url] 参数；(默认 TCPing)
+        当使用 HTTP 测速模式时，软件会从 HTTP 响应头中获取该 IP 当前的机场地区码（支持 Cloudflare、AWS CloudFront）并显示出来。
        注意：HTTPing 本质上也算一种 网络扫描 行为，因此如果你在服务器上面运行，需要降低并发(-n)，否则可能会被一些严格的商家暂停服务。
        如果你遇到 HTTPing 首次测速可用 IP 数量正常，后续测速越来越少甚至直接为 0，但停一段时间后又恢复了的情况，那么也可能是被 运营商、Cloudflare CDN 认为你在网络扫描而 触发临时限制机制，因此才会过一会儿就恢复了，建议降低并发(-n)减少这种情况的发生。
    -httping-code 200
        有效状态代码；HTTPing 延迟测速时网页返回的有效 HTTP 状态码，仅限一个；(默认 200 301 302)
    -cfcolo HKG,KHH,NRT,LAX,SEA,SJC,FRA,MAD
-        匹配指定地区；地区名为当地机场三字码，英文逗号分隔，支持小写，支持 Cloudflare、AWS CloudFront，仅 HTTPing 模式可用；(默认 所有地区)
+        匹配指定地区；地区名为当地机场地区码，英文逗号分隔，支持小写，支持 Cloudflare、AWS CloudFront，仅 HTTPing 模式可用；(默认 所有地区)

    -tl 200
        平均延迟上限；只输出低于指定平均延迟的 IP，各上下限条件可搭配使用；(默认 9999 ms)
@@ -176,6 +198,9 @@ https://github.com/XIU2/CloudflareSpeedTest
    -allip
        测速全部的IP；对 IP 段中的每个 IP (仅支持 IPv4) 进行测速；(默认 每个 /24 段随机测速一个 IP)

+    -debug
+        调试输出模式；会在一些非预期情况下输出更多日志以便判断原因；(默认 关闭)
+
    -v
        打印程序版本 + 检查版本更新
    -h
@@ -184,32 +209,34 @@ https://github.com/XIU2/CloudflareSpeedTest

 ### 界面解释

-为了避免大家对 CloudflareST 测速过程中的界面内容有所误解（可用、队列等数字），我特意做个示例解释下。
+为了避免大家对测速过程中的**输出内容产生误解（可用、队列等数字，下载测速一半就"中断"？下载测速"卡住"不动？）**，我特意解释下。

 <details>
 <summary><code><strong>「 点击展开 查看内容 」</strong></code></summary>

 ****

-> 该实例把常用参数都给加上了，即为：`-ttl 40 -tl 150 -sl 1 -dn 5`，最后输出结果如下：
+> 该示例把常用参数都给加上了，即为：`-tll 40 -tl 150 -sl 1 -dn 5`，最后输出结果如下：

-``` bash
+```python
 # XIU2/CloudflareSpeedTest vX.X.X

 开始延迟测速（模式：TCP, 端口：443, 范围：40 ~ 150 ms, 丢包：1.00)
-321 / 321 [----------------------------------------------------------------------------------] 可用: 30
+321 / 321 [-----------------------------------------------------------] 可用: 30
 开始下载测速（下限：1.00 MB/s, 数量：5, 队列：10）
-3 / 5 [---------------------------------------------------------↗---------------------------]
-IP 地址           已发送  已接收  丢包率  平均延迟  下载速度 (MB/s)
-XXX.XXX.XXX.XXX    4       4       0.00    83.32     3.66
-XXX.XXX.XXX.XXX    4       4       0.00    107.81    2.49
-XXX.XXX.XXX.XXX    4       3       0.25    149.59    1.04
+3 / 5 [-----------------------------------------↗--------------------]
+IP 地址           已发送  已接收  丢包率  平均延迟  下载速度(MB/s)  地区码
+XXX.XXX.XXX.XXX   4      4       0.00   83.32     3.66           LAX
+XXX.XXX.XXX.XXX   4      4       0.00   107.81    2.49           LAX
+XXX.XXX.XXX.XXX   4      3       0.25   149.59    1.04           N/A

 完整测速结果已写入 result.csv 文件，可使用记事本/表格软件查看。
 按下 回车键 或 Ctrl+C 退出。
 ```

-> 刚接触 CloudflareST 的人，可能会迷惑明明延迟测速可用 IP 有 30 个，怎么最后只剩下 3 个了呢？  
+****
+
+> 刚接触 CloudflareST 的人，可能会迷惑**明明延迟测速可用 IP 有 30 个，怎么最后只剩下 3 个了呢？**  
 > 下载测速里的队列又是什么意思？难道我下载测速还要排队？

 CloudflareST 会先延迟测速，在这过程中进度条右侧会实时显示可用 IP 数量（`可用: 30`），但注意该可用数量指的是**测试通过没有超时的 IP 数量**，和延迟上下限、丢包条件无关。当延迟测速完成后，因为还指定了**延迟上下限、丢包**的条件，所以按照条件过滤后只剩下 `10` 个了（也就是等待下载测速的 `队列：10`）。
@@ -220,7 +247,7 @@ CloudflareST 会先延迟测速，在这过程中进度条右侧会实时显示

 ****

-> 你可能注意到了，明明指定了要找到 5 个满足下载速度条件的 IP，怎么才 3 个就 “中断” 了呢？
+> 你可能注意到了，**明明指定了要找到 5 个满足下载速度条件的 IP，怎么才 3 个就 “中断” 了呢？**

 下载测速进度条中的 `3 / 5`，前者指的是找到了 `3` 个满足下载速度下限条件的 IP（即下载速度高于 `1 MB/s` ），后者 `5` 指的是你要求找到 `5` 个满足下载速度下限条件的 IP（`-dn 5`）。

@@ -230,6 +257,26 @@ CloudflareST 会先延迟测速，在这过程中进度条右侧会实时显示

 因此，这不是 `“每次测速都不到 5 就中断了”`，而是所有 IP 都下载测速完了，但却只找到了 `3` 个满足条件的。

+****
+
+还有一种情况，那就是当可用 IP 很多时（几百几千），你还设置了下载速度条件，那么可能就会遇到：**怎么下载测速进度条老是卡在 `X / 5` 了呢？**
+
+这其实并不是卡住了，而是只有当找到一个满足条件的 IP 时，进度条才会 +1，因此如果一直找不到，那么 CloudflareST 就会一直下载测速下去，因此在表现为进度条卡住不动，但这也是在提醒你：你设置的下载速度条件对你来说已经高于实际了，你需要适当调低预期。
+
+****
+
+如果不想遇到这种全部测速一遍都没几个满足条件的情况，那么就要**调低下载速度上限参数 `-sl`**，或者移除。
+
+因为只要指定了 `-sl` 参数，那么只要没有凑够 `-dn` 的数量（默认 10 个），就会一直测速下去，直到凑够或全部测速完。移除 `-sl` 并添加 `-dn 20` 参数，这样就是只测速延迟最低的前 20 个 IP，测速完就停止，节省时间。
+
+****
+
+另外，如果全部队列 IP 都测速完了，但一个满足下载速度条件的 IP 都没有，你可能需要调低预期的下载测速下限条件，但你需要知道当前的大概测速速度都在什么范围，那么你就可以加上 `-debug` 参数开启调试模式，这样再遇到这种情况时，就会**忽略条件返回所有测速数据**，你就能看到这些 IP 的下载速度都有多少，心里也就有数了，然后**适当调低 `-sl` 再试试**。
+
+同样，延迟测速方面，`可用: 30`、`队列：10` 这两个数值也可以让你清楚，你设置的延迟条件对你来说是否过于苛刻。如果可用 IP 一大堆，但条件过滤后只剩下 2、3 个，那不用说就知道需要**调低预期的延迟/丢包条件**了。
+
+这两个机制，一个是告诉你**延迟丢包条件**是否合适的，一个是告诉你**下载速度条件**是否合适的。
+
 </details>

 ****
@@ -238,9 +285,10 @@ CloudflareST 会先延迟测速，在这过程中进度条右侧会实时显示

 Windows 要指定参数需要在 CMD 中运行，或者把参数添加到快捷方式目标中。

-> **注意**：各参数均有**默认值**，使用默认值的参数是可以省略的（**按需选择**），参数**不分前后顺序**。  
-> **提示**：Windows **PowerShell** 只需把下面命令中的 `CloudflareST.exe` 改为 `.\CloudflareST.exe` 即可。  
-> **提示**：Linux 系统只需要把下面命令中的 `CloudflareST.exe` 改为 `./CloudflareST` 即可。
+> [!TIP]
+> - 各参数均有**默认值**，使用默认值的参数是可以省略的（**按需选择**），参数**不分前后顺序**。  
+> - Windows **PowerShell** 只需把下面命令中的 `CloudflareST.exe` 改为 `.\CloudflareST.exe` 即可。  
+> - Linux 系统只需要把下面命令中的 `CloudflareST.exe` 改为 `./CloudflareST` 即可。

 ****

@@ -340,6 +388,8 @@ HTTP 协议适用于快速测试某域名指向某 IP 时是否可以访问，

 > 另外，本软件 HTTPing 仅获取**响应头(response headers)**，并不获取正文内容（即 URL 文件大小不影响 HTTPing 测试，但如果你还要下载测速的话，那么还是需要一个大文件的），类似于 curl -i 功能。

+> 另外，HTTPing 过程中，软件会从 HTTP 响应头中获取该 IP 当前的机场地区码（支持 Cloudflare、AWS CloudFront）并显示出来，而 TCPing 过程中无法这样做（但 下载测速 时也会这样做来获取地区码，毕竟下载测速也是个 HTTP 链接）
+
 ``` bash
 # 只需加上 -httping 参数即可切换到 HTTP 协议延迟测速模式
 CloudflareST.exe -httping
@@ -360,26 +410,41 @@ CloudflareST.exe -httping -tp 80 -url http://cdn.cloudflare.steamstatic.com/stea

 ****

-#### \# 匹配指定地区(colo 机场三字码)
+#### \# 匹配指定地区(colo 机场地区码)

 <details>
 <summary><code><strong>「 点击展开 查看内容 」</strong></code></summary>

 ****

+Cloudflare CDN 的节点 IP 是 Anycast IP，即每个 IP 对应的服务器节点及地区不是固定的，而是动态变化的，**不同地区、不同运营商、不同时间段**访问**同一个 IP** 分配到的服务器节点地区和路线也都是不一样的（比如同一个 IP，美国人访问就是分配到就近的美国节点服务器，日本人访问则就又变成了就近的日本节点服务器了，国内内地就比较特殊了，只能给你分配到其他国家，当然不同的 IP 段路由变化/分配逻辑也是不同的，有的 IP 段会较为固定）。
+
+> **注意**！虽然 Cloudflare CDN 有很多亚洲节点，但**不代表你就能用上**，新加坡人测速可能随便一抓一大把的新加坡节点，但你全部扫一遍可能都遇不到一个，因为这是由 CDN 控制的。Anycast IP 的路由是经常变的，同一个 IP 今天可能是美国，明天你再访问可能就又分配到欧洲节点了（当然这只是个例子，一般没有那么频繁，这也和很多因素有关，比如线路拥塞程度，成本变动等），因此**不要对该功能有过高期待**~
+
+或者你随便找个 Cloudflare CDN 的 IP（比如官网域名的解析 IP `104.16.123.96`），然后去那些有全球节点的[在线 Ping 测试](https://ping.sx/ping?t=104.16.123.96)网站，你就会发现这个 IP 在全球大部分地区的延迟都是个位数（而且很多都是 0.X ms），就算一些地方延迟高一些但也基本都控制在 几十ms，只有在国内才会发现突然变成了 上百ms 了。
+
+这就是 Anycast 技术，也就只有国内大陆这种特殊的网络情况，才需要对 Anycast 的 CDN IP 进行优选。
+
+因此，对于这种 Anycast IP 的实际服务器位置，就不能靠那些在线 IP 地址位置查询网站来判断了。
+
+除了通过 **HTTP 响应头**获取机场地区码外（该功能的实现方式），还可以手动访问 `http://CloudflareIP/cdn-cgi/trace` 来获知 CDN 分配给你的实际节点地区机场地区码。
+
+> 该功能支持 Cloudflare CDN 和 AWS CloudFront CDN，且这两个 CDN 的机场地区码是通用的（算是惯例）。  
+> **注意**：如果你要用于筛选 AWS CloudFront CDN 地区，那么要通过 `-url` 参数指定一个使用 AWS CloudFront CDN 的下载测速地址（因为软件默认下载测速地址是 Cloudflare CDN 的）
+
 ``` bash
-# 该功能支持 Cloudflare CDN、AWS CloudFront CDN，且这两个 CDN 的机场三字码是通用的
-# 注意：如果你要用于筛选 AWS CloudFront CDN 地区，那么要通过 -url 参数指定一个使用该 CDN 的地址（因为软件默认地址是 Cloudflare 的）
+# 指定地区名后，延迟测速后得到的结果就都是指定地区的 IP 了（如果没有指定 -dd 的话则会继续进行下载测速）
+# 如果延迟测速后结果为 0，则说明没有找到任何一个（未超时可用的）指定地区的 IP。
+# 节点地区名为当地 机场地区码，指定多个时用英文逗号分隔，v2.2.3 版本后支持小写

-# 指定地区名后，延迟测速后得到的结果就都是指定地区的 IP 了（也可以继续进行下载测速）
-# 节点地区名为当地 机场三字码，指定多个时用英文逗号分隔，v2.2.3 版本后支持小写
+CloudflareST.exe -httping -cfcolo HKG,KHH,NRT,LAX,SEA,SJC,FRA,MAD

-CloudflareST.exe -cfcolo HKG,KHH,NRT,LAX,SEA,SJC,FRA,MAD
+# 注意，该参数只有在 HTTPing 延迟测速模式下才可用（因为软件是通过 HTTP 链接中的响应头来获得该 IP 的实际地区机场地区码）

-# 注意，该参数只有在 HTTPing 延迟测速模式下才可用（因为要访问网页来获得）
+# 另外，HTTPing 过程中，软件会从 HTTP 响应头中获取该 IP 当前的机场地区码（支持 Cloudflare、AWS CloudFront）并显示出来，而 TCPing 过程中无法这样做（但 下载测速 时也会这样做来获取地区码，毕竟下载测速也是个 HTTP 链接）
 ```

-> 两个 CDN 机场三字码通用，因此各地区名可见：https://www.cloudflarestatus.com/
+> 两个 CDN 机场地区码通用，因此各地区名可见：https://www.cloudflarestatus.com/

 </details>

@@ -518,7 +583,7 @@ CloudflareST.exe -tlr 0.25
 CloudflareST.exe -sl 5 -dn 10
 ```

-> 如果**没有找到一个满足速度**条件的 IP，那么会**忽略条件输出所有 IP 测速结果**（方便你下次测速时调整条件）。
+> 如果**没有找到一个满足速度**条件的 IP，那么不会输出任何内容，你可能需要调低预期的下载测速下限条件，但你需要知道当前的大概测速速度都在什么范围，那么你就可以加上 `-debug` 参数开启调试模式，这样再遇到这种情况时，就会**忽略条件返回所有测速数据**，你就能看到这些 IP 的下载速度都有多少，心里也就有数了，然后**适当调低 `-sl` 再试试**。

 > 没有指定平均延迟上限时，如果一直**凑不够**满足条件的 IP 数量，就会**一直测速**下去。  
 > 所以建议**同时指定 [下载速度下限] + [平均延迟上限]**，这样测速到指定延迟上限还没凑够数量，就会终止测速。
@@ -535,7 +600,7 @@ CloudflareST.exe -tl 200 -sl 5.6 -dn 10
 ```

 > 如果**没有找到一个满足延迟**条件的 IP，那么不会输出任何内容。  
-> 如果**没有找到一个满足速度**条件的 IP，那么会忽略条件输出所有 IP 测速结果（方便你下次测速时调整条件）。  
+> 如果**没有找到一个满足速度**条件的 IP，那么不会输出任何内容，但可以通过加上 `-debug` 参数开启调试模式，这时会忽略条件输出所有 IP 测速结果（方便你下次测速时调整条件）。  
 > 所以建议先不指定条件测速一遍，看看平均延迟和下载速度大概在什么范围，避免指定条件**过低/过高**！

 > 因为 Cloudflare 公开的 IP 段是**回源 IP+任播 IP**，而**回源 IP**是无法使用的，所以下载测速是 0.00。  
@@ -596,6 +661,64 @@ CloudflareST.exe -f 1.txt

 ****

+#### \# 下载测速都是 0.00 ？
+
+<details>
+<summary><code><strong>「 点击展开 查看内容 」</strong></code></summary>
+
+****
+
+首先要明白，本软件的下载测速过程，本质上和你将 `IP 下载测速地址的域名` 写入 hosts 文件，然后浏览器去访问下载测速地址是一样的，只不过软件将其自动化了（类似于 `curl -I --resolve 下载测速地址的域名:443:IP https://下载测速地址`）。
+
+因此如果下载测速结果全都是 0.00 MB/s，那么以为着下载测速失败，就只有这几种可能性。
+
+1. **下载测速地址有问题**
+2. **测速的 IP 地址有问题**
+3. **你的网络有问题**
+
+但在排查具体是哪个问题前，可以先在你原先的 CloudflareST 运行命令后追加一个 `-debug` 参数来开启调试模式，重新跑一边测速，这样下载过程中报错了就能直接看到下载测速失败的具体原因。
+
+常见的下载测速失败报错原因有（因为是原生报错信息，因此基本都是英文）：
+
+1. `... read: connection reset by peer ...  `  
+下载测速地址被阻断了，可能是蔷干的，也可能是运营商干的（比如移动或部分地区的白名单）
+2. `... HTTP 状态码: 403 ...`  
+像这种直接提示 HTTP 状态码的，比较好判断，如 403 就是测速地址禁止你访问，404 就是测速地址找不到文件，具体可以搜索 HTTP 状态码含义
+3. `... context deadline exceeded (Client.Timeout exceeded while awaiting headers) ...`  
+这种一般是超时引起的，可能是 IP 等网络问题，也可能是 -dt 下载测速时间设置的太短了，当然默认的 10 秒到不至于超时
+
+> 如果你遇到了其他报错原因，且翻译后还是不懂，可以发 Issues 或 Discussions 询问。
+
+根据上面的报错原因排查一遍后，如果还是无法解决，那么可以尝试下面这些：
+
+**一、下载测速地址有问题**：
+
+先去 [#490](https://github.com/XIU2/CloudflareSpeedTest/discussions/490) 找几个其他的下载测速地址都试试。
+
+如果其中有能下载测速出结果的，则就代表你之前使用的下载测速地址有问题（注意，目前默认下载测速地址仅为一个带负载均衡轮询的重定向链接，会自动重定向到上面帖子里大家分享的公益下载测速地址，而这些地址在**不同地区的可用性可能有差异**，因此可能出现之前不行现在又正常的情况，如果**想要稳定，建议自建**，上面帖子写了几种自建方法）。
+
+如果找了很多，都是一样 0.00，那么就要考虑其他可能性了。
+
+****
+
+**二、测速的 IP 地址有问题**：
+
+你用来测速的 IP 地址，可能一些 TCP 测试是通的，但实际上因为各种原因导致不能建立 HTTP 链接（比如是回源 IP，比如是企业用户专用 IP 等等），因此你可以多尝试一些其他的 IP 看是否可行。
+
+****
+
+**三、你的网络有问题**：
+
+这个就比较麻烦了，如果你现在是用电脑+宽带来使用 CloudflareST 测速的，那么可以尝试关闭手机 WIFI 并打开流量，然后数据线连接电脑，设置好 USB 网络共享（不同手机系统不太一样，具体自行搜索哈），并拔掉电脑的网线，这样你的电脑现在就是走的手机流量数据网络了（如果手机流量数据和宽带不是一个运营商会更好排查），然后再次运行 CloudflareST 测速看看结果是否改变（也可以同时尝试上面的排查方法来交叉验证）。
+
+如果测速结果正常了，那么显然就是宽带网络的问题，如果还是一样的 0.00，那么就麻烦了。。。
+
+****
+
+</details>
+
+****
+
 #### \# 一劳永逸加速所有使用 Cloudflare CDN 的网站（不需要再一个个添加域名到 Hosts 了）

 我以前说过，开发该软件项目的目的就是为了通过**改 Hosts 的方式来加速访问使用 Cloudflare CDN 的网站**。
@@ -617,11 +740,12 @@ CloudflareST.exe -f 1.txt
 如果你遇到什么问题，可以先去 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues)、[Discussions](https://github.com/XIU2/CloudflareSpeedTest/discussions) 里看看是否有别人问过了（记得去看下  [**Closed**](https://github.com/XIU2/CloudflareSpeedTest/issues?q=is%3Aissue+is%3Aclosed) 的）。  
 如果没找到类似问题，请新开个 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues/new) 来告诉我！

-> **注意**！_与 `反馈问题、功能建议` 无关的，请前往项目内部 论坛 讨论（上面的 `💬 Discussions`_  
+> [!NOTE]
+> **注意**！_与 CloudflareST 本身 `反馈问题、功能建议` 无关的，请前往项目内部 论坛 讨论（顶部的 `💬 Discussions`_  

 ****

-## 赞赏支持
+## 如果帮到你的话就 "打赏" 一下吧~🎉✨

 ![微信赞赏](https://github.com/XIU2/XIU2/blob/master/img/zs-01.png)![支付宝赞赏](https://github.com/XIU2/XIU2/blob/master/img/zs-02.png)

@@ -715,4 +839,4 @@ go build -o Releases/CloudflareST_windows_386/CloudflareST.exe -ldflags "-s -w -

 ## License

-The GPL-3.0 License.
+The GPL-3.0 License.
--- a/main.go
+++ b/main.go
@@ -3,7 +3,7 @@ package main
 import (
 	"flag"
 	"fmt"
-	"io/ioutil"
+	"io"
 	"net/http"
 	"os"
 	"runtime"
@@ -43,7 +43,7 @@ https://github.com/XIU2/CloudflareSpeedTest
    -httping-code 200
        有效状态代码；HTTPing 延迟测速时网页返回的有效 HTTP 状态码，仅限一个；(默认 200 301 302)
    -cfcolo HKG,KHH,NRT,LAX,SEA,SJC,FRA,MAD
-        匹配指定地区；地区名为当地机场三字码，英文逗号分隔，仅 HTTPing 模式可用；(默认 所有地区)
+        匹配指定地区；地区名为当地机场地区码，英文逗号分隔，仅 HTTPing 模式可用；(默认 所有地区)

    -tl 200
        平均延迟上限；只输出低于指定平均延迟的 IP，各上下限条件可搭配使用；(默认 9999 ms)
@@ -68,6 +68,9 @@ https://github.com/XIU2/CloudflareSpeedTest
    -allip
        测速全部的IP；对 IP 段中的每个 IP (仅支持 IPv4) 进行测速；(默认 每个 /24 段随机测速一个 IP)

+    -debug
+        调试输出模式；会在一些非预期情况下输出更多日志以便判断原因；(默认 关闭)
+
    -v
        打印程序版本 + 检查版本更新
    -h
@@ -99,12 +102,14 @@ https://github.com/XIU2/CloudflareSpeedTest
 	flag.BoolVar(&task.Disable, "dd", false, "禁用下载测速")
 	flag.BoolVar(&task.TestAll, "allip", false, "测速全部 IP")

+	flag.BoolVar(&utils.Debug, "debug", false, "调试输出模式")
+
 	flag.BoolVar(&printVersion, "v", false, "打印程序版本")
 	flag.Usage = func() { fmt.Print(help) }
 	flag.Parse()

 	if task.MinSpeed > 0 && time.Duration(maxDelay)*time.Millisecond == utils.InputMaxDelay {
-		fmt.Println("[小提示] 在使用 [-sl] 参数时，建议搭配 [-tl] 参数，以避免因凑不够 [-dn] 数量而一直测速...")
+		fmt.Println("\033[33m[提示] 在使用 [-sl] 参数时，建议搭配 [-tl] 参数，以避免因凑不够 [-dn] 数量而一直测速...\033[0m")
 	}
 	utils.InputMaxDelay = time.Duration(maxDelay) * time.Millisecond
 	utils.InputMinDelay = time.Duration(minDelay) * time.Millisecond
@@ -162,7 +167,7 @@ func checkUpdate() {
 		return
 	}
 	// 读取资源数据 body: []byte
-	body, err := ioutil.ReadAll(res.Body)
+	body, err := io.ReadAll(res.Body)
 	if err != nil {
 		return
 	}
--- a/script/README.md
+++ b/script/README.md
@@ -1,16 +1,28 @@
-# XIU2/CloudflareSpeedTest - Script
+# XIU2/CloudflareSpeedTest - Script(脚本)

-这里都是一些基于 **XIU2/CloudflareSpeedTest** 并**扩展更多功能**的脚本。  
-有什么现有脚本功能上的建议可以告诉我，如果你有一些自用好用的脚本也可以通过 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues) 或 Pull requests 发给我添加到这里让更多人用到（会标注作者的~
-
-> 小提示：点击↖左上角的三横杠图标按钮即可查看目录~
+这里都是一些通过调用 **CloudflareST** 并**扩展实现更多个性化功能**的脚本。  

 ****
-## 📑 cfst_hosts.sh / cfst_hosts.bat (已内置)
+> [!TIP]
+> 我之所以将 CloudflareST 制作为一个**命令行程序**，就是考虑到**通用性**，因为毕竟不可能把所有需求都塞到软件内（特别是一些**个性化、小众**的需求），这样增加维护难度和精力不说，还会导致软件异常臃肿（`“变成我讨厌的样子”`），而命令行程序的优势之一就在于**可以很方便的和其他软件、脚本搭配使用**。

-运行 CloudflareST 获得最快 IP 后，脚本会替换 Hosts 文件中的旧 CDN IP。
+比如像下面这些我写的几个脚本，就是把一些需求以外置脚本方式实现。  

-> **使用说明：https://github.com/XIU2/CloudflareSpeedTest/issues/42**
+> 即脚本调用 CloudflareST 测速并获取结果，然后***按照自己的需求自由决定***如何处理得到的测速结果（比如修改 Hosts 等）。  
+
+总的来说，我写的这几个脚本都比较简单，功能也很单一，除了满足部分用户的需求外，***更像是一个 CloudflareST 与脚本搭配使用的示例参考***，对于一些会写脚本、软件的用户来说，完全可以**自给自足**来实现一些个性化需求。
+
+当然，如果你有一些自用好用的脚本也可以通过 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues)、[**Discussions**](https://github.com/XIU2/CloudflareSpeedTest/discussions) 或 **Pull requests** 发给我添加到这里让更多人用到！
+
+> 小提示：点击↗右上角的三横杠图标按钮即可查看目录~
+
+****
+## 📑 cfst_hosts.sh / cfst_hosts.bat (已内置压缩包)
+
+脚本会运行 CloudflareST 获得最快 IP，并替换掉 Hosts 文件中的旧 CDN IP。
+
+> **作者：**[@XIU2](https://github.com/xiu2)  
+> **使用说明/问题反馈：https://github.com/XIU2/CloudflareSpeedTest/discussions/312**

 <details>
 <summary><code><strong>「 更新日志」</strong></code></summary>
@@ -37,12 +49,13 @@

 ****

-## 📑 cfst_3proxy.bat (已内置)
+## 📑 cfst_3proxy.bat (已内置压缩包)

-该脚本的作用为 CloudflareST 测速后获取最快 IP 并替换 3Proxy 配置文件中的 Cloudflare CDN IP。  
+脚本会运行 CloudflareST 测速后获取最快 IP 并替换 3Proxy 配置文件中的旧 Cloudflare CDN IP。  
 可以把所有 Cloudflare CDN IP 都重定向至最快 IP，实现一劳永逸的加速所有使用 Cloudflare CDN 的网站（不需要一个个添加域名到 Hosts 了）。

-> **使用说明：https://github.com/XIU2/CloudflareSpeedTest/discussions/71**
+> **作者：**[@XIU2](https://github.com/xiu2)  
+> **使用说明/问题反馈：https://github.com/XIU2/CloudflareSpeedTest/discussions/71**

 <details>
 <summary><code><strong>「 更新日志」</strong></code></summary>
@@ -72,17 +85,42 @@

 ****

-## 📑 cfst_ddns.sh / cfst_ddns.bat
+## 📑 cfst_dnspod.sh

-如果你的域名托管在 Cloudflare，则可以通过 Cloudflare 官方提供的 API 来自动更新域名解析记录！
+如果你的域名托管在 **dnspod**，则可以通过 dnspod 官方提供的 API 来自动更新域名解析记录！  
+脚本会运行 CloudflareST 测速获得最快 IP，并通过 Cloudflare API 来更新域名解析记录为这个最快 IP。

-> **使用说明：https://github.com/XIU2/CloudflareSpeedTest/issues/40**
+> **作者：**[@imashen](https://github.com/imashen)  
+> **使用说明/问题反馈：https://github.com/XIU2/CloudflareSpeedTest/pull/533**

 <details>
 <summary><code><strong>「 更新日志」</strong></code></summary>

 ****

+#### 2024年08月06日，版本 v1.0.0
+ - **1. 发布** 第一个版本  
+
+</details>
+
+****
+
+## 📑 cfst_ddns.sh / cfst_ddns.bat
+
+如果你的域名托管在 **Cloudflare**，则可以通过 Cloudflare 官方提供的 API 来自动更新域名解析记录！  
+脚本会运行 CloudflareST 测速获得最快 IP，并通过 Cloudflare API 来更新域名解析记录为这个最快 IP。
+
+> **作者：**[@XIU2](https://github.com/xiu2)  
+> **使用说明/问题反馈：https://github.com/XIU2/CloudflareSpeedTest/discussions/481**
+
+<details>
+<summary><code><strong>「 更新日志」</strong></code></summary>
+
+****
+
+#### 2024年10月06日，版本 v1.0.5
+ - **1. 新增** 支持 API 令牌方式（相比 API 密钥这种全局权限的，API 令牌可以自由控制权限）   
+
 #### 2021年12月17日，版本 v1.0.4
 - **1. 新增** 找不到满足条件的 IP 就一直循环测速功能（默认注释）  
 - **2. 优化** 代码  
@@ -103,7 +141,29 @@

 ****

+## 📑 cfst_dnsmasq.sh
+
+脚本会运行 CloudflareST 测速后获取最快 IP 并替换 dnsmasq 配置文件中的旧 Cloudflare CDN IP。  
+
+> **作者：**[@Sving1024](https://github.com/Sving1024)  
+> **使用说明/问题反馈：https://github.com/XIU2/CloudflareSpeedTest/discussions/566**
+
+<details>
+<summary><code><strong>「 更新日志」</strong></code></summary>
+
+****
+
+#### 2025年01月22日，版本 v1.0.1
+ - **1. 修复** IPv6 的问题  
+
+#### 2024年12月28日，版本 v1.0.0
+ - **1. 发布** 第一个版本  
+
+</details>
+
+****
+
 ## 功能建议/问题反馈

-如果你遇到什么问题，可以先去 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues) 里看看是否有别人问过了（记得去看下  [**Closed**](https://github.com/XIU2/CloudflareSpeedTest/issues?q=is%3Aissue+is%3Aclosed) 的）。  
-如果没找到类似问题，请新开个 [**Issues**](https://github.com/XIU2/CloudflareSpeedTest/issues/new) 来告诉我！
+如果这些脚本使用过程中你遇到了什么问题，可以先去脚本对应的 **`使用说明`** 帖子里看看是否有别人问过了。  
+如果没找到类似问题，那么就在脚本对应的 **`使用说明`** 帖子里直接评论问作者吧。
--- a/script/cfst_ddns.bat
+++ b/script/cfst_ddns.bat
@@ -1,6 +1,6 @@
 :: --------------------------------------------------------------
 ::	项目: CloudflareSpeedTest 自动更新域名解析记录
-::	版本: 1.0.4
+::	版本: 1.0.5
 ::	作者: XIU2
 ::	项目: https://github.com/XIU2/CloudflareSpeedTest
 :: --------------------------------------------------------------
@@ -26,11 +26,18 @@ for /f "tokens=1 delims=," %%i in (result_ddns.txt) do (
            echo CloudflareST 测速结果 IP 数量为 0，跳过下面步骤...
            goto :END
        )
+::      API 密钥方式（全局权限）
        curl -X PUT "https://api.cloudflare.com/client/v4/zones/域名ID/dns_records/域名解析记录ID" ^
                -H "X-Auth-Email: 账号邮箱" ^
-                -H "X-Auth-Key: 前面获取的 API 令牌" ^
+                -H "X-Auth-Key: 前面获取的 API 密钥" ^
                -H "Content-Type: application/json" ^
                --data "{\"type\":\"A\",\"name\":\"完整域名\",\"content\":\"%%i\",\"ttl\":1,\"proxied\":true}"
+::        API 令牌方式（自定义权限），如果要使用这种方式，可以把上面的删除或注释，然后把下面的行首 "::" 注释符删除即可。
+::        curl -X PUT "https://api.cloudflare.com/client/v4/zones/域名ID/dns_records/域名解析记录ID" ^
+::                -H "Authorization: Bearer 前面获取的 API 令牌" ^
+::                -H "Content-Type: application/json" ^
+::                --data "{\"type\":\"A\",\"name\":\"完整域名\",\"content\":\"%%i\",\"ttl\":1,\"proxied\":true}"
+
        goto :END
    )
 )
--- a/script/cfst_ddns.sh
+++ b/script/cfst_ddns.sh
@@ -3,7 +3,7 @@ PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:~/bin
 export PATH
 # --------------------------------------------------------------
 #	项目: CloudflareSpeedTest 自动更新域名解析记录
-#	版本: 1.0.4
+#	版本: 1.0.5
 #	作者: XIU2
 #	项目: https://github.com/XIU2/CloudflareSpeedTest
 # --------------------------------------------------------------
@@ -17,10 +17,10 @@ _READ() {
 	[[ -z "${ZONE_ID}" ]] && echo -e "[错误] 缺少配置项 [ZONE_ID] !" && exit 1
 	DNS_RECORDS_ID=$(echo "${CONFIG}"|grep 'DNS_RECORDS_ID='|awk -F '=' '{print $NF}')
 	[[ -z "${DNS_RECORDS_ID}" ]] && echo -e "[错误] 缺少配置项 [DNS_RECORDS_ID] !" && exit 1
-	EMAIL=$(echo "${CONFIG}"|grep 'EMAIL='|awk -F '=' '{print $NF}')
-	[[ -z "${EMAIL}" ]] && echo -e "[错误] 缺少配置项 [EMAIL] !" && exit 1
 	KEY=$(echo "${CONFIG}"|grep 'KEY='|awk -F '=' '{print $NF}')
 	[[ -z "${KEY}" ]] && echo -e "[错误] 缺少配置项 [KEY] !" && exit 1
+	EMAIL=$(echo "${CONFIG}"|grep 'EMAIL='|awk -F '=' '{print $NF}')
+	[[ -z "${EMAIL}" ]] && echo -e "[信息] 缺少配置项 [EMAIL]，由 [API 密钥] 方式转为 [API 令牌] 方式!"
 	TYPE=$(echo "${CONFIG}"|grep 'TYPE='|awk -F '=' '{print $NF}')
 	[[ -z "${TYPE}" ]] && echo -e "[错误] 缺少配置项 [TYPE] !" && exit 1
 	NAME=$(echo "${CONFIG}"|grep 'NAME='|awk -F '=' '{print $NF}')
@@ -43,11 +43,21 @@ _UPDATE() {
 		echo "CloudflareST 测速结果 IP 数量为 0，跳过下面步骤..."
 		exit 0
 	fi
-	curl -X PUT "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}/dns_records/${DNS_RECORDS_ID}" \
-		-H "X-Auth-Email: ${EMAIL}" \
-		-H "X-Auth-Key: ${KEY}" \
-		-H "Content-Type: application/json" \
-		--data "{\"type\":\"${TYPE}\",\"name\":\"${NAME}\",\"content\":\"${CONTENT}\",\"ttl\":${TTL},\"proxied\":${PROXIED}}"
+	# 如果 EMAIL 变量是空的，那么就代表要使用 API 令牌方式
+	if [[ -n "${EMAIL}" ]]; then
+		# API 密钥方式（全局权限）
+		curl -X PUT "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}/dns_records/${DNS_RECORDS_ID}" \
+			-H "X-Auth-Email: ${EMAIL}" \
+			-H "X-Auth-Key: ${KEY}" \
+			-H "Content-Type: application/json" \
+			--data "{\"type\":\"${TYPE}\",\"name\":\"${NAME}\",\"content\":\"${CONTENT}\",\"ttl\":${TTL},\"proxied\":${PROXIED}}"
+	else
+		# API 令牌方式（自定义权限）
+		curl -X PUT "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}/dns_records/${DNS_RECORDS_ID}" \
+			-H "Authorization: Bearer ${KEY}" \
+			-H "Content-Type: application/json" \
+			--data "{\"type\":\"${TYPE}\",\"name\":\"${NAME}\",\"content\":\"${CONTENT}\",\"ttl\":${TTL},\"proxied\":${PROXIED}}"
+	fi
 }

 _READ
--- a/script/cfst_dnsmasq.sh
+++ b/script/cfst_dnsmasq.sh
@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:~/bin
+export PATH
+# --------------------------------------------------------------
+#	项目: CloudflareSpeedTest 自动更新 dnsmasq 配置文件
+#	版本: 1.0.1
+#	作者: XIU2,Sving1024
+#	项目: https://github.com/XIU2/CloudflareSpeedTest
+# --------------------------------------------------------------
+
+_UPDATE() {
+	echo -e "开始测速..."
+	BESTIP=""
+	BESTIP_IPV6="::"
+	# 这里可以自己添加、修改 CloudflareST 的运行参数
+	./CloudflareST -o "result_hosts.txt"
+	# 需要测速 IPv6 请取消注释
+	#./CloudflareST -o "result_hosts_ipv6.txt" -f ipv6.txt
+
+	# 如果需要 "找不到满足条件的 IP 就一直循环测速下去"，那么可以将下面的两个 exit 0 改为 _UPDATE 即可
+	[[ ! -e "result_hosts.txt" ]] && echo "CloudflareST 测速结果 IP 数量为 0，跳过下面步骤..." && exit 0
+
+	# 下面这行代码是 "找不到满足条件的 IP 就一直循环测速下去" 才需要的代码
+	# 考虑到当指定了下载速度下限，但一个满足全部条件的 IP 都没找到时，CloudflareST 就会输出所有 IP 结果
+	# 因此当你指定 -sl 参数时，需要移除下面这段代码开头的 # 井号注释符，来做文件行数判断（比如下载测速数量：10 个，那么下面的值就设在为 11）
+	#[[ $(cat result_hosts.txt|wc -l) > 11 ]] && echo "CloudflareST 测速结果没有找到一个完全满足条件的 IP，重新测速..." && _UPDATE
+
+	BESTIP=$(sed -n "2,1p" result_hosts.txt | awk -F, '{print $1}')
+	# 需要测速 IPv6 请取消注释
+	#BESTIP_IPV6=$(sed -n "2,1p" result_hosts_ipv6.txt | awk -F, '{print $1}')
+
+	if [[ -z "${BESTIP}" ]]; then
+		echo "CloudflareST 测速结果 IP 数量为 0，跳过下面步骤..."
+		exit 0
+	fi
+	echo ${BESTIP} > nowip_hosts.txt
+	echo -e "最优 IPv4 IP 为 ${BESTIP}\n"
+	# 需要测速 IPv6 请取消注释
+	#echo -e "最优 IPv6 IP 为 ${BESTIP_IPV6}\n"
+
+    [[ -f cloudflare.conf ]] && rm cloudflare.conf
+
+    cat site.conf | while read domain
+    do
+        if [[ ${domain:0:1} != "#" && ${domain} != "" ]]; then 
+			echo "address=/${domain}/${BESTIP}" >> "cloudflare.conf"
+			echo "address=/${domain}/${BESTIP_IPV6}" >> "cloudflare.conf"
+		fi
+    done
+
+    [[ -f /etc/dnsmasq.d/cloudflare.conf ]] && rm /etc/dnsmasq.d/cloudflare.conf
+    cp cloudflare.conf /etc/dnsmasq.d/cloudflare.conf
+    systemctl restart dnsmasq.service
+}
+
+_UPDATE
--- a/script/cfst_dnspod.sh
+++ b/script/cfst_dnspod.sh
@@ -0,0 +1,106 @@
+#!/bin/bash
+
+# --------------------------------------------------------------
+#	项目: CloudflareSpeedTest 自动更新Dnspod优选解析
+#	版本: 1.0.0
+#	作者: imashen
+# --------------------------------------------------------------
+
+# 清理历史残留
+rm -f result4.csv result6.csv
+# DNSPod API 凭据
+dnspod_token="${API_TOKEN}"
+dnspod_domain="${DOMAIN}"
+dnspod_record="${SUB_DOMAIN}"
+
+# DNSPod API URL
+dnspod_api_url="https://dnsapi.cn"
+
+# 获取记录 ID
+get_record_id() {
+    local record_type=$1
+    local response
+    response=$(curl -s -X POST -d "login_token=$dnspod_token&format=json&domain=$dnspod_domain&record_type=$record_type" "$dnspod_api_url/Record.List")
+    local record_id
+    record_id=$(echo "$response" | jq -r --arg type "$record_type" '.records[] | select(.type == $type) | .id')
+    echo "$record_id"
+}
+
+# 创建 DNS 记录
+create_dns_record() {
+    local record_type=$1
+    local ip_address=$2
+    local response
+    response=$(curl -s -X POST -d "login_token=$dnspod_token&format=json&domain=$dnspod_domain&sub_domain=$dnspod_record&record_type=$record_type&record_line=默认&value=$ip_address" "$dnspod_api_url/Record.Create")
+    local record_id
+    record_id=$(echo "$response" | jq -r '.record.id')
+    echo "$record_id"
+}
+
+# 更新 DNS 记录
+update_dns_record() {
+    local record_id=$1
+    local record_type=$2
+    local ip_address=$3
+    curl -s -X POST -d "login_token=$dnspod_token&format=json&domain=$dnspod_domain&record_id=$record_id&sub_domain=$dnspod_record&record_type=$record_type&record_line=默认&value=$ip_address" "$dnspod_api_url/Record.Modify"
+}
+
+# 运行 CloudflareST v4
+./CloudflareST -f ip.txt -n 500 -o result4.csv
+
+# 读取 CSV 文件并提取优选 IPv4 地址
+preferred_ipv4=$(awk -F, 'NR==2 {print $1}' result4.csv)
+
+# 检查是否获取到了 IPv4 地址
+if [ -z "$preferred_ipv4" ]; then
+  echo "Failed to get the preferred IPv4 address."
+else
+  echo "BETTER IPv4: $preferred_ipv4"
+
+  # 获取 IPv4 记录 ID
+  ipv4_record_id=$(get_record_id "A")
+
+  if [ -n "$ipv4_record_id" ]; then
+    # 更新 IPv4 记录
+    update_dns_record "$ipv4_record_id" "A" "$preferred_ipv4"
+    echo "Updated DNSPod record with IPv4: $preferred_ipv4"
+  else
+    # 创建 IPv4 记录
+    new_ipv4_record_id=$(create_dns_record "A" "$preferred_ipv4")
+    if [ -n "$new_ipv4_record_id" ]; then
+      echo "Created DNSPod record with IPv4: $preferred_ipv4"
+    else
+      echo "Failed to create DNSPod record with IPv4."
+    fi
+  fi
+fi
+
+# 运行 CloudflareST v6
+./CloudflareST -f ipv6.txt -n 500 -o result6.csv
+
+# 读取 CSV 文件并提取优选 IPv6 地址
+preferred_ipv6=$(awk -F, 'NR==2 {print $1}' result6.csv)
+
+# 检查是否获取到了 IPv6 地址
+if [ -z "$preferred_ipv6" ]; then
+  echo "Failed to get the preferred IPv6 address."
+else
+  echo "BETTER IPv6: $preferred_ipv6"
+
+  # 获取 IPv6 记录 ID
+  ipv6_record_id=$(get_record_id "AAAA")
+
+  if [ -n "$ipv6_record_id" ]; then
+    # 更新 IPv6 记录
+    update_dns_record "$ipv6_record_id" "AAAA" "$preferred_ipv6"
+    echo "Updated DNSPod record with IPv6: $preferred_ipv6"
+  else
+    # 创建 IPv6 记录
+    new_ipv6_record_id=$(create_dns_record "AAAA" "$preferred_ipv6")
+    if [ -n "$new_ipv6_record_id" ]; then
+      echo "Created DNSPod record with IPv6: $preferred_ipv6"
+    else
+      echo "Failed to create DNSPod record with IPv6."
+    fi
+  fi
+fi
--- a/task/download.go
+++ b/task/download.go
@@ -54,7 +54,7 @@ func TestDownloadSpeed(ipSet utils.PingDelaySet) (speedSet utils.DownloadSpeedSe
 		return utils.DownloadSpeedSet(ipSet)
 	}
 	if len(ipSet) <= 0 { // IP数组长度(IP数量) 大于 0 时才会继续下载测速
-		fmt.Println("\n[信息] 延迟测速结果 IP 数量为 0，跳过下载测速。")
+		fmt.Println("\n\033[33m[信息] 延迟测速结果 IP 数量为 0，跳过下载测速。\033[0m")
 		return
 	}
 	testNum := TestCount
@@ -65,7 +65,7 @@ func TestDownloadSpeed(ipSet utils.PingDelaySet) (speedSet utils.DownloadSpeedSe
 		TestCount = testNum
 	}

-	fmt.Printf("开始下载测速（下限：%.2f MB/s, 数量：%d, 队列：%d）\n", MinSpeed, TestCount, testNum)
+	fmt.Printf("\033[34m开始下载测速（下限：%.2f MB/s, 数量：%d, 队列：%d）\033[0m\n", MinSpeed, TestCount, testNum)
 	// 控制 下载测速进度条 与 延迟测速进度条 长度一致（强迫症）
 	bar_a := len(strconv.Itoa(len(ipSet)))
 	bar_b := "     "
@@ -74,8 +74,11 @@ func TestDownloadSpeed(ipSet utils.PingDelaySet) (speedSet utils.DownloadSpeedSe
 	}
 	bar := utils.NewBar(TestCount, bar_b, "")
 	for i := 0; i < testNum; i++ {
-		speed := downloadHandler(ipSet[i].IP)
+		speed, colo := downloadHandler(ipSet[i].IP)
 		ipSet[i].DownloadSpeed = speed
+		if ipSet[i].Colo == "" { // 只有当 Colo 是空的时候，才写入，否则代表之前是 httping 测速并获取过了
+			ipSet[i].Colo = colo
+		}
 		// 在每个 IP 下载测速后，以 [下载速度下限] 条件过滤结果
 		if speed >= MinSpeed*1024*1024 {
 			bar.Grow(1, "")
@@ -86,7 +89,8 @@ func TestDownloadSpeed(ipSet utils.PingDelaySet) (speedSet utils.DownloadSpeedSe
 		}
 	}
 	bar.Done()
-	if len(speedSet) == 0 { // 没有符合速度限制的数据，返回所有测试数据
+	if utils.Debug && len(speedSet) == 0 { // 调试模式下，没有满足速度限制的数据，返回所有测速数据供用户查看当前的测速结果，以便适当调低预期测速条件
+		fmt.Println("\033[33m[调试] 没有满足 下载速度下限 条件的 IP，忽略条件返回所有测速数据（方便下次测速时调整条件）。\033[0m")
 		speedSet = utils.DownloadSpeedSet(ipSet)
 	}
 	// 按速度排序
@@ -107,12 +111,15 @@ func getDialContext(ip *net.IPAddr) func(ctx context.Context, network, address s
 }

 // return download Speed
-func downloadHandler(ip *net.IPAddr) float64 {
+func downloadHandler(ip *net.IPAddr) (float64, string) {
 	client := &http.Client{
 		Transport: &http.Transport{DialContext: getDialContext(ip)},
 		Timeout:   Timeout,
 		CheckRedirect: func(req *http.Request, via []*http.Request) error {
 			if len(via) > 10 { // 限制最多重定向 10 次
+				if utils.Debug { // 调试模式下，输出更多信息
+					fmt.Printf("\033[31m[调试] IP: %s, 下载测速地址重定向次数过多，终止测速，URL: %s\033[0m\n", ip.String(), req.URL.String())
+				}
 				return http.ErrUseLastResponse
 			}
 			if req.Header.Get("Referer") == defaultURL { // 当使用默认下载测速地址时，重定向不携带 Referer
@@ -123,19 +130,31 @@ func downloadHandler(ip *net.IPAddr) float64 {
 	}
 	req, err := http.NewRequest("GET", URL, nil)
 	if err != nil {
-		return 0.0
+		if utils.Debug { // 调试模式下，输出更多信息
+			fmt.Printf("\033[31m[调试] IP: %s, 下载测速请求创建失败，错误信息: %v, URL: %s\033[0m\n", ip.String(), err, URL)
+		}
+		return 0.0, ""
 	}

 	req.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.80 Safari/537.36")

 	response, err := client.Do(req)
 	if err != nil {
-		return 0.0
+		if utils.Debug { // 调试模式下，输出更多信息
+			fmt.Printf("\033[31m[调试] IP: %s, 下载测速失败，错误信息: %v, URL: , 最终URL: %s%s\033[0m\n", ip.String(), err, URL, response.Request.URL.String())
+		}
+		return 0.0, ""
 	}
 	defer response.Body.Close()
 	if response.StatusCode != 200 {
-		return 0.0
+		if utils.Debug { // 调试模式下，输出更多信息
+			fmt.Printf("\033[31m[调试] IP: %s, 下载测速终止，HTTP 状态码: %d, URL: %s, 最终URL: %s\033[0m\n", ip.String(), response.StatusCode, URL, response.Request.URL.String())
+		}
+		return 0.0, ""
 	}
+	// 通过头部 Server 值判断是 Cloudflare 还是 AWS CloudFront 并设置 cfRay 为各自的机场地区码完整内容
+	colo := getHeaderColo(response.Header)
+
 	timeStart := time.Now()           // 开始时间（当前）
 	timeEnd := timeStart.Add(Timeout) // 加上下载测速时间得到的结束时间

@@ -179,5 +198,5 @@ func downloadHandler(ip *net.IPAddr) float64 {
 		}
 		contentRead += int64(bufferRead)
 	}
-	return e.Value() / (Timeout.Seconds() / 120)
+	return e.Value() / (Timeout.Seconds() / 120), colo
 }
--- a/task/httping.go
+++ b/task/httping.go
@@ -18,11 +18,11 @@ var (
 	HttpingStatusCode int
 	HttpingCFColo     string
 	HttpingCFColomap  *sync.Map
-	OutRegexp         = regexp.MustCompile(`[A-Z]{3}`)
+	ColoRegexp        = regexp.MustCompile(`[A-Z]{3}`)
 )

 // pingReceived pingTotalTime
-func (p *Ping) httping(ip *net.IPAddr) (int, time.Duration) {
+func (p *Ping) httping(ip *net.IPAddr) (int, time.Duration, string) {
 	hc := http.Client{
 		Timeout: time.Second * 2,
 		Transport: &http.Transport{
@@ -35,84 +35,79 @@ func (p *Ping) httping(ip *net.IPAddr) (int, time.Duration) {
 	}

 	// 先访问一次获得 HTTP 状态码 及 Cloudflare Colo
+	var colo string
 	{
-		requ, err := http.NewRequest(http.MethodHead, URL, nil)
+		request, err := http.NewRequest(http.MethodHead, URL, nil)
 		if err != nil {
-			return 0, 0
+			return 0, 0, ""
 		}
-		requ.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.80 Safari/537.36")
-		resp, err := hc.Do(requ)
+		request.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.80 Safari/537.36")
+		response, err := hc.Do(request)
 		if err != nil {
-			return 0, 0
+			return 0, 0, ""
 		}
-		defer resp.Body.Close()
+		defer response.Body.Close()

-		//fmt.Println("IP:", ip, "StatusCode:", resp.StatusCode, resp.Request.URL)
+		//fmt.Println("IP:", ip, "StatusCode:", response.StatusCode, response.Request.URL)
 		// 如果未指定的 HTTP 状态码，或指定的状态码不合规，则默认只认为 200、301、302 才算 HTTPing 通过
 		if HttpingStatusCode == 0 || HttpingStatusCode < 100 && HttpingStatusCode > 599 {
-			if resp.StatusCode != 200 && resp.StatusCode != 301 && resp.StatusCode != 302 {
-				return 0, 0
+			if response.StatusCode != 200 && response.StatusCode != 301 && response.StatusCode != 302 {
+				return 0, 0, ""
 			}
 		} else {
-			if resp.StatusCode != HttpingStatusCode {
-				return 0, 0
+			if response.StatusCode != HttpingStatusCode {
+				return 0, 0, ""
 			}
 		}

-		io.Copy(io.Discard, resp.Body)
+		io.Copy(io.Discard, response.Body)

-		// 只有指定了地区才匹配机场三字码
+		// 通过头部 Server 值判断是 Cloudflare 还是 AWS CloudFront 并设置 cfRay 为各自的机场地区码完整内容
+		colo = getHeaderColo(response.Header)
+
+		// 只有指定了地区才匹配机场地区码
 		if HttpingCFColo != "" {
-			// 通过头部 Server 值判断是 Cloudflare 还是 AWS CloudFront 并设置 cfRay 为各自的机场三字码完整内容
-			cfRay := func() string {
-				if resp.Header.Get("Server") == "cloudflare" {
-					return resp.Header.Get("CF-RAY") // 示例 cf-ray: 7bd32409eda7b020-SJC
-				}
-				return resp.Header.Get("x-amz-cf-pop") // 示例 X-Amz-Cf-Pop: SIN52-P1
-			}()
-			colo := p.getColo(cfRay)
-			if colo == "" { // 没有匹配到三字码或不符合指定地区则直接结束该 IP 测试
-				return 0, 0
+			// 判断是否匹配指定的地区码
+			colo = p.filterColo(colo)
+			if colo == "" { // 没有匹配到地区码或不符合指定地区则直接结束该 IP 测试
+				return 0, 0, ""
 			}
 		}
-
 	}

 	// 循环测速计算延迟
 	success := 0
 	var delay time.Duration
 	for i := 0; i < PingTimes; i++ {
-		requ, err := http.NewRequest(http.MethodHead, URL, nil)
+		request, err := http.NewRequest(http.MethodHead, URL, nil)
 		if err != nil {
 			log.Fatal("意外的错误，情报告：", err)
-			return 0, 0
+			return 0, 0, ""
 		}
-		requ.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.80 Safari/537.36")
+		request.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.80 Safari/537.36")
 		if i == PingTimes-1 {
-			requ.Header.Set("Connection", "close")
+			request.Header.Set("Connection", "close")
 		}
 		startTime := time.Now()
-		resp, err := hc.Do(requ)
+		response, err := hc.Do(request)
 		if err != nil {
 			continue
 		}
 		success++
-		io.Copy(io.Discard, resp.Body)
-		_ = resp.Body.Close()
+		io.Copy(io.Discard, response.Body)
+		_ = response.Body.Close()
 		duration := time.Since(startTime)
 		delay += duration
-
 	}

-	return success, delay
-
+	return success, delay, colo
 }

 func MapColoMap() *sync.Map {
 	if HttpingCFColo == "" {
 		return nil
 	}
-	// 将参数指定的地区三字码转为大写并格式化
+	// 将 -cfcolo 参数指定的地区地区码转为大写并格式化
 	colos := strings.Split(strings.ToUpper(HttpingCFColo), ",")
 	colomap := &sync.Map{}
 	for _, colo := range colos {
@@ -121,21 +116,36 @@ func MapColoMap() *sync.Map {
 	return colomap
 }

-func (p *Ping) getColo(b string) string {
-	if b == "" {
+// 从响应头中获取 地区码 值
+func getHeaderColo(header http.Header) (colo string) {
+	// 如果是 Cloudflare 的服务器，则获取 CF-RAY 头部
+	if header.Get("Server") == "cloudflare" {
+		colo = header.Get("CF-RAY") // 示例 cf-ray: 7bd32409eda7b020-SJC
+	} else { // 如果是 AWS CloudFront 的服务器，则获取 X-Amz-Cf-Pop 头部
+		colo = header.Get("x-amz-cf-pop") // 示例 X-Amz-Cf-Pop: SIN52-P1
+	}
+
+	// 如果没有获取到头部信息，说明不是 Cloudflare 和 AWS CloudFront，则直接返回空字符串
+	if colo == "" {
 		return ""
 	}
-	// 正则匹配并返回 机场三字码
-	out := OutRegexp.FindString(b)
+	// 正则匹配并返回 机场地区码
+	return ColoRegexp.FindString(colo)
+}

+// 处理地区码
+func (p *Ping) filterColo(colo string) string {
+	if colo == "" {
+		return ""
+	}
+	// 如果没有指定 -cfcolo 参数，则直接返回
 	if HttpingCFColomap == nil {
-		return out
+		return colo
 	}
-	// 匹配 机场三字码 是否为指定的地区
-	_, ok := HttpingCFColomap.Load(out)
+	// 匹配 机场地区码 是否为指定的地区
+	_, ok := HttpingCFColomap.Load(colo)
 	if ok {
-		return out
+		return colo
 	}
-
 	return ""
 }
--- a/task/tcping.go
+++ b/task/tcping.go
@@ -64,9 +64,9 @@ func (p *Ping) Run() utils.PingDelaySet {
 		return p.csv
 	}
 	if Httping {
-		fmt.Printf("开始延迟测速（模式：HTTP, 端口：%d, 范围：%v ~ %v ms, 丢包：%.2f)\n", TCPPort, utils.InputMinDelay.Milliseconds(), utils.InputMaxDelay.Milliseconds(), utils.InputMaxLossRate)
+		fmt.Printf("\033[34m开始延迟测速（模式：HTTP, 端口：%d, 范围：%v ~ %v ms, 丢包：%.2f)\033[0m\n", TCPPort, utils.InputMinDelay.Milliseconds(), utils.InputMaxDelay.Milliseconds(), utils.InputMaxLossRate)
 	} else {
-		fmt.Printf("开始延迟测速（模式：TCP, 端口：%d, 范围：%v ~ %v ms, 丢包：%.2f)\n", TCPPort, utils.InputMinDelay.Milliseconds(), utils.InputMaxDelay.Milliseconds(), utils.InputMaxLossRate)
+		fmt.Printf("\033[34m开始延迟测速（模式：TCP, 端口：%d, 范围：%v ~ %v ms, 丢包：%.2f)\033[0m\n", TCPPort, utils.InputMinDelay.Milliseconds(), utils.InputMaxDelay.Milliseconds(), utils.InputMaxLossRate)
 	}
 	for _, ip := range p.ips {
 		p.wg.Add(1)
@@ -104,11 +104,12 @@ func (p *Ping) tcping(ip *net.IPAddr) (bool, time.Duration) {
 }

 // pingReceived pingTotalTime
-func (p *Ping) checkConnection(ip *net.IPAddr) (recv int, totalDelay time.Duration) {
+func (p *Ping) checkConnection(ip *net.IPAddr) (recv int, totalDelay time.Duration, colo string) {
 	if Httping {
-		recv, totalDelay = p.httping(ip)
+		recv, totalDelay, colo = p.httping(ip)
 		return
 	}
+	colo = "" // TCPing 不获取 colo
 	for i := 0; i < PingTimes; i++ {
 		if ok, delay := p.tcping(ip); ok {
 			recv++
@@ -128,7 +129,7 @@ func (p *Ping) appendIPData(data *utils.PingData) {

 // handle tcping
 func (p *Ping) tcpingHandler(ip *net.IPAddr) {
-	recv, totalDlay := p.checkConnection(ip)
+	recv, totalDlay, colo := p.checkConnection(ip)
 	nowAble := len(p.csv)
 	if recv != 0 {
 		nowAble++
@@ -142,6 +143,7 @@ func (p *Ping) tcpingHandler(ip *net.IPAddr) {
 		Sended:   PingTimes,
 		Received: recv,
 		Delay:    totalDlay / time.Duration(recv),
+		Colo:     colo,
 	}
 	p.appendIPData(data)
 }
--- a/utils/csv.go
+++ b/utils/csv.go
@@ -23,6 +23,7 @@ var (
 	InputMaxLossRate = maxLossRate
 	Output           = defaultOutput
 	PrintNum         = 10
+	Debug            = false // 是否开启调试模式
 )

 // 是否打印测试结果
@@ -40,6 +41,7 @@ type PingData struct {
 	Sended   int
 	Received int
 	Delay    time.Duration
+	Colo     string
 }

 type CloudflareIPData struct {
@@ -58,13 +60,19 @@ func (cf *CloudflareIPData) getLossRate() float32 {
 }

 func (cf *CloudflareIPData) toString() []string {
-	result := make([]string, 6)
+	result := make([]string, 7)
 	result[0] = cf.IP.String()
 	result[1] = strconv.Itoa(cf.Sended)
 	result[2] = strconv.Itoa(cf.Received)
 	result[3] = strconv.FormatFloat(float64(cf.getLossRate()), 'f', 2, 32)
 	result[4] = strconv.FormatFloat(cf.Delay.Seconds()*1000, 'f', 2, 32)
 	result[5] = strconv.FormatFloat(cf.DownloadSpeed/1024/1024, 'f', 2, 32)
+	// 如果 Colo 为空，则使用 "N/A" 表示
+	if cf.Colo == "" {
+		result[6] = "N/A"
+	} else {
+		result[6] = cf.Colo
+	}
 	return result
 }

@@ -79,7 +87,7 @@ func ExportCsv(data []CloudflareIPData) {
 	}
 	defer fp.Close()
 	w := csv.NewWriter(fp) //创建一个新的写入文件流
-	_ = w.Write([]string{"IP 地址", "已发送", "已接收", "丢包率", "平均延迟", "下载速度 (MB/s)"})
+	_ = w.Write([]string{"IP 地址", "已发送", "已接收", "丢包率", "平均延迟", "下载速度(MB/s)", "地区码"})
 	_ = w.WriteAll(convertToString(data))
 	w.Flush()
 }
@@ -168,18 +176,18 @@ func (s DownloadSpeedSet) Print() {
 	if len(dateString) < PrintNum {  // 如果IP数组长度(IP数量) 小于  打印次数，则次数改为IP数量
 		PrintNum = len(dateString)
 	}
-	headFormat := "%-16s%-5s%-5s%-5s%-6s%-11s\n"
-	dataFormat := "%-18s%-8s%-8s%-8s%-10s%-15s\n"
+	headFormat := "\033[34m%-16s%-5s%-5s%-5s%-6s%-12s%-5s\033[0m\n"
+	dataFormat := "%-18s%-8s%-8s%-8s%-10s%-16s%-8s\n"
 	for i := 0; i < PrintNum; i++ { // 如果要输出的 IP 中包含 IPv6，那么就需要调整一下间隔
 		if len(dateString[i][0]) > 15 {
-			headFormat = "%-40s%-5s%-5s%-5s%-6s%-11s\n"
-			dataFormat = "%-42s%-8s%-8s%-8s%-10s%-15s\n"
+			headFormat = "\033[34m%-40s%-5s%-5s%-5s%-6s%-12s%-5s\033[0m\n"
+			dataFormat = "%-42s%-8s%-8s%-8s%-10s%-16s%-8s\n"
 			break
 		}
 	}
-	fmt.Printf(headFormat, "IP 地址", "已发送", "已接收", "丢包率", "平均延迟", "下载速度 (MB/s)")
+	fmt.Printf(headFormat, "IP 地址", "已发送", "已接收", "丢包率", "平均延迟", "下载速度(MB/s)", "地区码")
 	for i := 0; i < PrintNum; i++ {
-		fmt.Printf(dataFormat, dateString[i][0], dateString[i][1], dateString[i][2], dateString[i][3], dateString[i][4], dateString[i][5])
+		fmt.Printf(dataFormat, dateString[i][0], dateString[i][1], dateString[i][2], dateString[i][3], dateString[i][4], dateString[i][5], dateString[i][6])
 	}
 	if !noOutput() {
 		fmt.Printf("\n完整测速结果已写入 %v 文件，可使用记事本/表格软件查看。\n", Output)
Author	SHA1	Message	Date
xiu2	66912dd657	新增支持显示地区码(机场三字码，仅限 Cloudflare、AWS CloudFront，HTTPing 和下载测速(无论是哪个测速模式)过程中都会自动获取); 新增调试模式运行参数(-debug 方便排查下载测速过程中遇到的问题); 新增彩色输出内容; 调整当没找到符合速度条件的 IP 时，默认不再直接忽略条件输出所有 IP 测速结果了，而是只有在调试模式下才会输出;	2025-06-29 00:30:05 +08:00
XIU2	04da9f5659	Merge pull request #538 from ipcjs/patch-1 chore: 添加通过scoop安装的命令	2025-05-11 14:49:04 +08:00
xiu2	013c27c059	README.md	2025-03-25 13:17:30 +08:00
xiu2	c7f8170485	README.md	2025-01-22 23:58:37 +08:00
XIU2	d6818fa60c	Merge pull request #570 from Sving1024/master 修复 cfst_dnsmasq.sh IPv6 的问题	2025-01-22 23:56:45 +08:00
Sving1024	b15fe2c899	fix IPv6	2025-01-22 23:45:04 +08:00
xiu2	551f753323	README.md	2025-01-08 09:14:32 +08:00
xiu2	8acc095cd9	README.md	2025-01-04 16:40:21 +08:00
xiu2	ee31cff5c3	README.md	2024-12-28 20:22:38 +08:00
XIU2	b85ae8edec	Merge pull request #565 from Sving1024/master add scripts to auto update config file for dnsmasq	2024-12-28 20:18:29 +08:00
Sving1024	25fc2921e2	reset version	2024-12-28 19:30:36 +08:00
Sving1024	5e39f2612f	add scripts to auto update config file for dnsmasq	2024-12-28 19:02:31 +08:00
xiu2	dbceab3418	README.md	2024-12-17 09:10:30 +08:00
xiu2	6c9d336d01	README.md	2024-12-17 09:09:40 +08:00
xiu2	a438fc6c93	README.md	2024-12-10 23:06:17 +08:00
xiu2	1d9d742bca	README.md	2024-12-06 21:49:26 +08:00
xiu2	209c7100ff	README.md	2024-12-06 21:44:27 +08:00
ipcjs	c74168a10d	Update README.md	2024-11-15 01:57:34 +08:00
xiu2	66c0923bf7	README.md	2024-10-09 10:10:22 +08:00
xiu2	bbe762c46f	新增支持 API 令牌方式	2024-10-06 14:13:18 +08:00
xiu2	887a55ce77	README.md	2024-09-12 16:32:51 +08:00
ipcjs	570a710446	Update README.md	2024-08-22 19:31:31 +08:00
ipcjs	0033f96e5d	Update README.md	2024-08-22 19:28:12 +08:00
ipcjs	b3036eb1ef	Update README.md	2024-08-22 17:33:00 +08:00
xiu2	84cbd2995c	README.md	2024-08-09 20:49:35 +08:00
xiu2	1995d088ec	README.md	2024-08-06 20:55:22 +08:00
xiu2	13f0c322a8	README.md	2024-08-06 20:54:00 +08:00
Taylor Lottner	a5cf1fdc05	新增 `cfst_dnspod.sh` 脚本用于 dnspod 自动更新域名解析最优 IP (#533 )	2024-08-06 20:13:15 +08:00
xiu2	8a6670b67a	README.md	2024-07-27 23:46:38 +08:00
xiu2	e815a60867	README.md	2024-07-25 22:57:46 +08:00
xiu2	bf832c5a4e	更新 import "io/ioutil" -> "io"	2024-07-22 11:29:36 +08:00
xiu2	f2e87d38d7	README.md	2024-07-09 19:45:58 +08:00
xiu2	63234aeb98	Update issue templates	2024-07-09 19:45:51 +08:00
xiu2	23b4f260e7	Update issue templates	2024-06-20 07:14:31 +08:00
XIU2	dbb5864235	Update README.md	2024-06-17 17:59:44 +08:00
xiu2	d96281af1f	README.md	2024-02-13 22:47:06 +08:00
xiu2	6d12e7bac9	README.md	2024-02-12 13:00:38 +08:00
xiu2	9d9d71fa04	README.md	2024-02-12 12:03:00 +08:00
xiu2	176271d5bb	README.md	2024-01-20 10:26:48 +08:00
xiu2	216d0f5f6b	README.md	2023-12-15 21:35:45 +08:00
xiu2	7534e34ae2	README.md	2023-12-15 21:33:21 +08:00
xiu2	b3010e21fd	README.md	2023-11-30 16:30:05 +08:00
xiu2	aa52d607bc	README.md	2023-11-30 16:24:13 +08:00
xiu2	ca5564c56e	README.md	2023-11-26 12:35:30 +08:00