CloudflareSpeedTest

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

CloudflareSpeedTest

★ 28,547 Open GitHub ↗

🌩「自选优选 IP」测试 Cloudflare CDN 延迟和速度，获取最快 IP ！当然也支持其他 CDN / 多个解析 IP 的网站 ~

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# XIU2/CloudflareSpeedTest
[![Go Version](https://img.shields.io/github/go-mod/go-version/XIU2/CloudflareSpeedTest.svg?style=flat-square&label=Go&color=00ADD8&logo=go)](https://github.com/XIU2/CloudflareSpeedTest/)
[![Release Version](https://img.shields.io/github/v/release/XIU2/CloudflareSpeedTest.svg?style=flat-square&label=Release&color=00ADD8&logo=github)](https://github.com/XIU2/CloudflareSpeedTest/releases/latest)
[![GitHub license](https://img.shields.io/github/license/XIU2/CloudflareSpeedTest.svg?style=flat-square&label=License&color=00ADD8&logo=github)](https://github.com/XIU2/CloudflareSpeedTest/)
[![GitHub Star](https://img.shields.io/github/stars/XIU2/CloudflareSpeedTest.svg?style=flat-square&label=Star&color=00ADD8&logo=github)](https://github.com/XIU2/CloudflareSpeedTest/)
[![GitHub Fork](https://img.shields.io/github/forks/XIU2/CloudflareSpeedTest.svg?style=flat-square&label=Fork&color=00ADD8&logo=github)](https://github.com/XIU2/CloudflareSpeedTest/)
해외의 많은 웹사이트가 Cloudflare CDN을 사용하고 있지만, 중국 본토 방문자에게 할당되는 IP는 그리 우호적이지 않습니다(높은 지연 시간, 잦은 패킷 손실, 느린 속도).
Cloudflare가 모든 [IP 대역](https://www.cloudflare.com/zh-cn/ips/)을 공개하긴 했지만, 이 많은 IP 중에서 자신에게 맞는 것을 직접 찾으려면 꽤나 고생스러울 것입니다. 그래서 이 소프트웨어가 만들어졌습니다.
\*\*「수동/최적 IP 선택」으로 Cloudflare CDN의 지연 시간과 속도를 테스트하고, 가장 빠른 IP(IPv4+IPv6)를 획득하세요\*\*! 유용하다면 \*\*`⭐`를 눌러 격려해 주세요~\*\*
> \_내 다른 오픈소스 프로젝트 공유: [\*\*TrackersList.com\*\* - 전 네트워크 인기 BT Tracker 목록! BT 다운로드 속도 향상~](https://github.com/XIU2/TrackersListCollection) ![](https://img.shields.io/github/stars/XIU2/TrackersListCollection.svg?style=flat-square&label=Star&color=4285dd&logo=github)\_
> \_[\*\*UserScript\*\* - 🐵 Github 고속 다운로드, Zhihu 강화, 자동 무한 스크롤, 눈 보호 모드 등 수십 가지 \*\*Tampermonkey 스크립트\*\*~](https://github.com/XIU2/UserScript) ![](https://img.shields.io/github/stars/XIU2/UserScript.svg?style=flat-square&label=Star&color=4285dd&logo=github)\_
> \_[\*\*SNIProxy\*\* - 🧷 직접 사용하는 간단한 SNI Proxy (모든 플랫폼, 모든 시스템 지원, 프론트엔드 프록시, 간단한 설정 등~](https://github.com/XIU2/SNIProxy) ![](https://img.shields.io/github/stars/XIU2/SNIProxy.svg?style=flat-square&label=Star&color=4285dd&logo=github)\_
물론 본 프로젝트는 \*\*`다른 CDN / 여러 개의 DNS 레코드를 가진 웹사이트`\*\*의 지연 시간 측정 또한 지원하지만, 상응하는 다운로드 속도 측정 주소는 직접 찾아야 합니다.
> [!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) / [Lanzou Cloud](https://xiu.lanzoub.com/b0742hkxe))을 다운로드하고 압축을 해제합니다.
2. `cfst.exe` 파일을 더블 클릭하여 실행하고(Windows 시스템), 속도 측정이 완료될 때까지 기다립니다...
`「 Windows 시스템에서의 다른 설치 방법 보기」`
\*\*\*\*
scoop(Windows용 커맨드라인 패키지 매니저)을 사용하는 경우, 다음과 같이 설치할 수 있습니다:
```sh
# 가장 널리 사용되는 중국어 패키지 저장소 추가: dorado
scoop bucket add dorado https://github.com/chawyehsu/dorado
# cloudflare-speedtest 설치
scoop install dorado/cloudflare-speedtest
```

`「 Linux / MAC 시스템에서의 사용 예시 보기 클릭 」`
\*\*\*\*
아래 명령어는 예시일 뿐이며, 버전 번호와 파일명은 [\*\*Releases\*\*](https://github.com/XIU2/CloudflareSpeedTest/releases)를 참고하시기 바랍니다.
> MAC에서 CFST를 설치하고 사용하는 방법은 동일하지만, MAC은 다른 방식으로 다운로드 및 압축 해제할 수 있습니다(즉, 아래의 처음 몇 단계를 건너뛸 수 있습니다). 하지만 실행은 터미널에서 해야 합니다(\*\*실행 권한 부여\*\*를 잊지 마세요).
``` yaml
# If it is the first time use, it is recommended to create a new folder (skip this step for subsequent updates)
mkdir cfst
# Enter the folder (for subsequent updates, just repeat the download and unzip commands below from here)
cd cfst
# Download CFST compressed package (this address always points to the latest version, you can replace the [file name] at the end of the URL according to your needs)
wget -N https://github.com/XIU2/CloudflareSpeedTest/releases/latest/download/cfst\_linux\_amd64.tar.gz
# If you are downloading in a domestic network environment, please use one of the following image accelerations:
# 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
# If the download fails, try deleting the -N parameter (if it is for update, remember to delete the old compressed package rm cfst\_linux\_amd64.tar.gz in advance)
# If you want to download a specific version, you can use this instead, for example: wget -N https://github.com/XIU2/CloudflareSpeedTest/releases/download/v2.3.4/cfst\_linux\_amd64.tar.gz
# Unzip (no need to delete old files, it will overwrite directly, replace the file name according to your needs)
tar -zxf cfst\_linux\_amd64.tar.gz
# Give execution permission
chmod +x cfst
# Run (without parameters)
./cfst
# Run (with parameter example)
./cfst -tl 200 -dn 20
```
> \*\*평균 지연 시간이 매우 낮을 경우\*\* (예: 0.xx), 이는 CFST \*\*속도 측정 시 프록시를 거쳤음\*\*을 의미하므로, 프록시 소프트웨어를 먼저 끄고 속도를 측정해 주세요.
> \*\*라우터\*\*에서 실행하는 경우, 라우터 내의 프록시를 먼저 끄거나(또는 제외 처리) 하시는 것을 권장합니다. 그렇지 않으면 속도 측정 결과가 \*\*부정확하거나 사용할 수 없을\*\* 수 있습니다.
\*\*\*\*
> \_\*\*휴대폰\*\*에서 독립적으로 CFST 속도를 측정하는 간단한 가이드: \*\*[\#Android](https://github.com/XIU2/CloudflareSpeedTest/discussions/61)、[Android APP](https://github.com/Hsia97/CFSTAPP)、[Android APP](https://github.com/xianshenglu/cloudflare-ip-tester-app)、[IOS](https://github.com/XIU2/CloudflareSpeedTest/discussions/321)\*\*\_
> [!NOTE]
> 주의! 본 소프트웨어는 웹사이트 전용이며, \*\*UDP 프로토콜을 사용하는 Cloudflare WARP 최적 IP는 지원하지 않습니다\*\*. 자세한 내용은 다음을 참고하세요: [\#392](https://github.com/XIU2/CloudflareSpeedTest/discussions/392)
### 결과 예시
속도 측정이 완료되면 기본적으로 \*\*가장 빠른 10개의 IP\*\*가 표시됩니다. 예시 (출력 내용 예시일 뿐):
``` bash
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
...
# If the average latency is very low (such as 0.xx), it means that CFST went through a proxy when testing the speed. Please turn off the proxy software before testing the speed.
# If running on a router, please turn off the proxy in the router first (or exclude it), otherwise the speed measurement result may be inaccurate/unusable.
# Because every speed measurement is a random IP in each IP segment, the speed measurement results cannot be the same every time, which is normal!
# Note! I found that the latency of the first speed measurement after booting the computer is significantly higher (manual TCPing is the same), and subsequent speed measurements are normal.
# Therefore, it is recommended that before the first official speed test after booting up, you can test a few IPs casually (no need to wait for the latency test to complete, as long as the progress bar moves, you can close it directly).
# The general steps of the software under default parameters:
# 1. Latency test (default TCPing mode, HTTPing mode requires adding parameters manually)
# 2. Latency sorting (sorting from low to high latency and filtering by conditions, different packet loss rates will be sorted separately, so some IPs with low latency but packet loss may be sorted to the back)
# 3. Download test (start downloading and testing from the IP with the lowest latency, and stop when enough 10 are tested by default)
# 4. Speed sorting (sorting speed from high to low)
# 5. Output results (control whether to output to the command line (-p 0) or to a file (-o "") through parameters)
# Note: The output result file result.csv will have Chinese garbled characters when opened with Microsoft Excel spreadsheet, which is normal. Other spreadsheet software/Notepad will display normally.
```
속도 측정 결과의 첫 번째 줄은 \*\*다운로드 속도가 가장 빠르고 평균 지연 시간이 가장 낮은 최적의 IP\*\*입니다!
전체 결과는 현재 디렉터리의 `result.csv` 파일에 저장되며, \*\*메모장/스프레드시트 소프트웨어\*\*로 열어보면 형식은 다음과 같습니다:
```
IP 地址,已发送,已接收,丢包率,平均延迟,下载速度(MB/s),地区码
104.27.200.69,4,4,0.00,146.23,28.64,LAX
```
> [!NOTE]
> \_\*\*다운로드 속도가 0.00으로 나타나는 경우\*\*, \*\*디버그 모드 `-debug`\*\*를 사용하여 문제를 해결할 수 있습니다. 자세한 내용은 다음을 참고하세요: [\*\*# 다운로드 속도가 모두 0.00인가요?\*\*](https://github.com/XIU2/CloudflareSpeedTest#-%E4%B8%8B%E8%BD%BD%E6%B5%8B%E9%80%9F%E9%83%BD%E6%98%AF-000-)\_
> \_사용자 지정 요구 사항에 따라 전체 결과를 \*\*추가로 필터링 및 처리\*\*하거나, 고급 사용법인 \*\*필터 조건 지정\*\*을 확인해 보세요!\_
\*\*\*\*
## \# 고급 사용법
그대로 실행하면 기본값이 사용되므로, \*\*자신에게 가장 적합한 IP를 더 쉽고 효율적으로 찾고 싶다면\*\* 각 매개변수의 조합을 능숙하게 활용해야 합니다:
```Dart
C:\>cfst -h
CloudflareSpeedTest vX.X.X
测试各个 CDN 或网站所有 IP 的延迟和速度，获取最快 IP (IPv4+IPv6)！
https://github.com/XIU2/CloudflareSpeedTest
参数：
-n 200
延迟测速线程；越多延迟测速越快，性能弱的设备 (如路由器) 请勿太高；(默认 200 最多 1000)
-t 4
延迟测速次数；单个 IP 延迟测速的次数；(默认 4 次)
-dn 10
下载测速数量；延迟测速并排序后，从最低延迟起下载测速的数量；(默认 10 个)
-dt 10
下载测速时间；单个 IP 下载测速最长时间，不能太短

；(기본값 10초)
-tp 443
포트 지정; 지연 시간 측정/다운로드 속도 측정 시 사용할 포트; (기본값 443 포트)
-url https://cf.xiu2.xyz/url
주소 지정; 지연 시간 측정(HTTPing)/다운로드 속도 측정 시 사용할 주소, 기본 주소는 가용성을 보장하지 않으며 직접 구축하는 것을 권장합니다.
다운로드 속도 측정 시, 소프트웨어는 HTTP 응답 헤더에서 해당 IP의 현재 지역 코드를 가져와(Cloudflare, AWS CloudFront, Fastly, Gcore, CDN77, Bunny 등의 CDN 지원) 표시합니다.
-httping
측정 모드 전환; 지연 시간 측정 모드를 HTTP 프로토콜로 변경하며, 사용되는 테스트 주소는 [-url] 파라미터입니다. (기본값 TCPing)
HTTP 측정 모드 사용 시, 소프트웨어는 HTTP 응답 헤더에서 해당 IP의 현재 지역 코드를 가져와(Cloudflare, AWS CloudFront, Fastly, Gcore, CDN77, Bunny 등의 CDN 지원) 표시합니다.
주의: 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
지정 지역 매칭; IATA 공항 지역 코드 또는 국가/도시 코드, 쉼표(,)로 구분, 대소문자 무관, HTTPing 모드에서만 사용 가능; (기본값 모든 지역)
Cloudflare, AWS CloudFront, Fastly, Gcore, CDN77, Bunny 등의 CDN 지원
이 중 Cloudflare, AWS CloudFront, Fastly는 IATA 3자리 공항 지역 코드를 사용합니다(예: HKG, LAX).
이 중 CDN77, Bunny는 2자리 국가/지역 코드를 사용합니다(예: US, CN).
이 중 Gcore는 2자리 도시 코드를 사용합니다(예: FR, AM).
따라서 -cfcolo로 지역 코드를 지정할 때는 CDN 종류에 따라 알맞은 유형의 지역 코드를 지정해야 합니다.
-tl 200
평균 지연 시간 상한; 지정한 평균 지연 시간보다 낮은 IP만 출력하며, 각 상하한 조건은 조합하여 사용할 수 있습니다. (기본값 9999 ms)
-tll 40
평균 지연 시간 하한; 지정한 평균 지연 시간보다 높은 IP만 출력합니다. (기본값 0 ms)
-tlr 0.2
패킷 손실률 상한; 지정한 패킷 손실률 이하인 IP만 출력, 범위 0.00~1.00, 0은 패킷 손실이 조금이라도 있는 IP를 모두 필터링합니다. (기본값 1.00)
-sl 5
다운로드 속도 하한; 지정한 다운로드 속도보다 빠른 IP만 출력하며, 지정한 수량([-dn])을 채워야 속도 측정이 중단됩니다. (기본값 0.00 MB/s)
-p 10
결과 표시 수량; 속도 측정 후 지정된 수량의 결과를 바로 표시하며, 0으로 설정하면 결과를 표시하지 않고 바로 종료합니다. (기본값 10개)
-f ip.txt
IP 대역 데이터 파일; 경로에 공백이 있는 경우 따옴표로 감싸세요. 다른 CDN IP 대역 지원; (기본값 ip.txt)
-ip 1.1.1.1,2.2.2.2/24,2606:4700::/32
IP 대역 직접 지정; 파라미터를 통해 속도를 측정할 IP 대역 데이터를 직접 지정하며 쉼표로 구분합니다. (기본값 없음)
-o result.csv
결과 파일 쓰기; 경로에 공백이 있는 경우 따옴표로 감싸세요. 값이 비어 있으면 파일을 쓰지 않습니다([-o ""]). (기본값 result.csv)
주의: 일부 환경에서 -o ""를 사용할 때 이 빈 파라미터가 무시되어 오류가 발생할 수 있으며, 공백을 하나 추가하여 -o " "로 해결할 수 있습니다.
-dd
다운로드 속도 측정 비활성화; 비활성화 시 측정 결과가 지연 시간 순으로 정렬됩니다(기본값은 다운로드 속도순 정렬). (기본값 활성화)
-allip
모든 IP 속도 측정; IP 대역 내의 모든 IP(IPv4만 지원)를 대상으로 속도를 측정합니다. (기본값 각 /24 대역에서 무작위로 1개 IP 측정)
-debug
디버그 출력 모드; 예기치 않은 상황에서 원인 파악을 위한 로그를 더 많이 출력합니다. (기본값 꺼짐)
현재 이 기능은 HTTPing 지연 시간 측정 과정 및 다운로드 속도 측정 과정에만 적용되며, 과정 중 다양한 원인으로 현재 IP 속도 측정이 중단될 경우 오류 원인이 출력됩니다.
예: HTTPing 지연 시간 측정 중 HTTP 상태 코드가 일치하지 않거나, 측정 주소에 문제가 있거나, 시간 초과 등의 원인으로 속도 측정이 중단된 경우
예: 다운로드 속도 측정 중 다운로드 주소에 문제(차단됨, 403 상태 코드, 시간 초과) 등의 원인으로 속도 측정이 중단된 경우(0.00으로 표시됨)
-v
프로그램 버전 출력 + 버전 업데이트 확인
-h
도움말 설명 출력
```
### 인터페이스 설명
측도 과정 중의 **출력 내용(사용 가능, 대기열 등의 숫자, 다운로드 속도 측정 중 "중단"? 다운로드 속도 측정 "멈춤" 현상 등)**에 대해 오해하시는 일이 없도록 특별히 설명해 드립니다.
`「 클릭하여 내용 펼치기 」`
\*\*\*\*
> 해당 예시는 자주 사용되는 파라미터를 모두 포함한 것으로, 다음과 같습니다: `-tll 40 -tl 150 -sl 1 -dn 5`, 최종 출력 결과는 다음과 같습니다:
```python
# XIU2/CloudflareSpeedTest vX.X.X
지연 시간 측정 시작 (모드: TCP, 포트: 443, 범위: 40 ~ 150 ms, 패킷 손실: 1.00)
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 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 파일에 기록되었습니다. 메모장이나 스프레드시트 프로그램으로 확인할 수 있습니다.
Enter 키 또는 Ctrl+C를 눌러 종료하세요.
```
\*\*\*\*
> CFST를 처음 접하는 분들은 **지연 시간 측정이 가능한 IP가 분명 30개인데, 왜 마지막에는 3개만 남았을까?** 하고 의아해하실 수 있습니다.
> 그리고 다운로드 속도 측정에서의 대기열은 또 무슨 의미일까요? 설마 다운로드 속도 측정하는 데도 줄을 서야 하나요?
CFST는 먼저 지연 시간을 측정하며, 이 과정에서 진행 바 우측에 실시간으로 사용 가능한 IP 개수(`사용 가능: 30`)가 표시됩니다. 단, 여기서 사용 가능한 개수는 **시간 초과 없이 테스트를 통과한 IP 개수**를 의미하며, 지연 시간 상하한이나 패킷 손실 조건과는 무관합니다. 지연 시간 측정이 완료된 후, **지연 시간 상하한 및 패킷 손실** 조건을 추가로 지정했기 때문에 조건에 따라 필터링되어 `10`개만 남게 됩니다(즉, 다운로드 속도 측정을 대기 중인 `대기열: 10`).
즉, 위 예시에서 `321`개의 IP 지연 시간 측정이 완료된 후, 시간 초과 없이 테스트를 통과한 IP는 `30`개이며, 그후 지연 시간 상하한 범위(`40 ~ 150 ms`) 및 패킷 손실 상한 조건에 따라 필터링되어 조건을 만족하는 IP는 `10`개만 남게 됩니다. 만약 `-dd`로 다운로드 속도 측정을 비활성화했다면 이 `10`개의 IP가 바로 출력되었을 것입니다. 물론 해당 예시에서는 비활성화하지 않았으므로, 소프트웨어가 이어서 이 `10`개의 IP를 대상으로 다운로드 속도 측정을 진행하게 됩니다(`대기열: 10`).
> 다운로드 속도 측정은 단일 스레드로 IP를 하나씩 순서대로 줄을 서서 측정하기 때문에, 다운로드 속도 측정을 대기하는 IP 개수를 `대기열`이라고 부릅니다.
\*\*\*\*
> 눈치채셨을 수도 있지만, **다운로드 속도 조건을 만족하는 IP를 5개 찾도록 지정했는데 어째서 3개만 찾고 "중단"된 걸까요?**
다운로드 속도 측정 진행 바의 `3 / 5`에서 앞의 숫자는 다운로드 속도 하한 조건을 만족하는 IP(`3`개, 즉 다운로드 속도가 `1 MB/s` 초과)를 찾은 개수를 의미하고, 뒤의 `5`는 다운로드 속도 하한 조건을 만족하는 IP를 `5`개 찾도록 요구한 값(`-dn 5`)입니다.
> 참고로, 만약 지정한 `-dn` 값이 다운로드 속도 측정 대기열보다 크다면(예: 지연 시간 측정 후 남은 IP가 `4`개뿐인 경우), 다운로드 속도 측정 진행 바 뒤의 숫자는 `-dn`으로 지정한 `5`개가 아니라 대기열과 같은 `4`개가 됩니다.
소프트웨어가 이 `10`개의 IP에 대한 속도 측정을 마쳤을 때 다운로드 속도가 `1 MB/s`보다 빠른 IP는 `3`개밖에 찾지 못했고, 나머지 `7`개의 IP는 모두 "낙제점"이었던 것입니다.
따라서 이는 `“측정할 때마다 5개가 채 안 되는데 중단된다”`는 의미가 아니라, 모든 IP의 다운로드 속도 측정이 끝났음에도 조건을 만족하는 IP가 `3`개밖에 없었다는 뜻입니다.
\*\*\*\*
또 다른 상황으로는, 사용 가능한 IP가 매우 많고(수백~수천 개) 다운로드 속도 조건까지 설정한 경우 **다운로드 속도 측정 진행 바가 왜 자꾸 `X / 5`에서 멈춰 있는 거지?**라는 상황을 겪을 수 있습니다.
이는 실제로 멈춘 것이 아니라, 조건을 만족하는 IP를 찾을 때마다 진행 바가 +1씩 올라가기 때문에 계속 찾지 못하면 CFST가 계속해서 다운로드 속도 측정을 시도하므로 진행 바가 멈춘 것처럼 보이는 것입니다. 이는 또한 설정하신 다운로드 속도 조건이 실제 환경에 비해 너무 높게 잡혀 있으므로 기대를 조금 낮춰야 한다는 신호이기도 합니다.
\*\*\*\*
이처럼 전체 IP를 다 측정했는데도 조건을 만족하는 IP가 거의 없는 상황을 겪고 싶지 않다면, **다운로드 속도 상한 파라미터 `-sl`을 낮추거나** 제거해야 합니다.
`-sl` 파라미터가 지정되어 있는 한 `-dn` 수량(기본값 10개)을 채울 때까지 또는 모든 IP 측정이 끝날 때까지 계속해서 속도를 측정하기 때문입니다. `-sl`을 제거하고 `-dn 20` 파라미터를 추가하면 지연 시간이 가장 빠른 상위 20개 IP만 속도를 측정하고 측정이 끝나면 바로 멈추므로 시간을 절약할 수 있습니다.
\*\*\*\*
또한, 대기열의 모든 IP 속도 측정이 끝났으나 다운로드 속도 조건을 만족하는 IP가 단 하나도 없으면

IP도 없는 경우 다운로드 속도 측정 하한 조건을 낮추어야 할 수도 있습니다. 하지만 현재 대략적인 속도 측정 범위가 어느 정도인지 알고 싶다면 `-debug` 파라미터를 추가하여 디버그 모드를 켜면 됩니다. 이렇게 하면 이런 상황을 마주했을 때 \*\*조건을 무시하고 모든 속도 측정 결과를 반환\*\>하므로, 이 IP들의 다운로드 속도가 어느 정도인지 직접 확인하고 감을 잡을 수 있습니다. 그런 다음 \*\*`-sl`을 적절히 낮추어서 다시 시도\*\*해 보세요.
> 주의: 만약 다운로드 속도 측정 하한 `-sl` 조건을 \*\*지정하지 않았다면\*\* 어떤 상황에서든 CFST는 \*\*모든 속도 측정 결과를 출력\*\*합니다.
마찬가지로 지연 시간 측정 측면에서도 `사용 가능: 30`, `큐: 10`이라는 두 가지 수치를 통해 설정한 지연 시간 조건이 자신에게 너무 가혹한지 여부를 명확히 파악할 수 있습니다. 사용 가능한 IP는 산더미 같은데 조건 필터링 후 2~3개만 남는다면, 두말할 것도 없이 \*\*예상되는 지연 시간/패킷 손실 조건을 낮추어야\*\* 한다는 것을 알 수 있습니다.
이 두 가지 메커니즘은 하나는 \*\*지연 시간 및 패킷 손실 조건\*\*이 적절한지 알려주고, 다른 하나는 \*\*다운로드 속도 조건\*\*이 적절한지 알려줍니다.
\*\*\*\*
### 사용 예시
Windows에서 파라미터를 지정하려면 CMD에서 실행하거나, 바로 가기 속성의 대상에 파라미터를 추가해야 합니다.
> [!TIP]
> - 각 파라미터에는 \*\*기본값\*\*이 있으며, 기본값을 사용할 때는 파라미터를 생략할 수 있고(\*\*필요에 따라 선택\*\*), 파라미터는 \*\*순서에 상관없습니다\*\*.
> - Windows \*\*PowerShell\*\*의 경우 아래 명령어의 `cfst`를 `.\cfst`로만 바꾸면 됩니다.
> - Linux / macOS 시스템의 경우 아래 명령어의 `cfst`를 `./cfst`로만 바꾸면 됩니다.
\*\*\*\*
#### \# CMD에서 파라미터와 함께 실행
명령줄 프로그램에 익숙하지 않은 분들은 파라미터를 어떻게 넣고 실행해야 할지 모를 수 있으므로 간단히 설명하겠습니다.
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
많은 사람들이 CMD를 열고 바로 \*\*절대 경로\*\*로 CFST를 실행하면 오류가 발생합니다. 이는 기본 `-f ip.txt` 파라미터가 상대 경로이기 때문에 절대 경로인 ip.txt를 지정해야 하기 때문입니다. 하지만 이는 너무 번거로우므로 CFST 프로그램 디렉터리로 이동하여 \*\*상대 경로\*\* 방식으로 실행하는 것을 권장합니다.
\*\*방법 1\*\*：
1. CFST 프로그램이 있는 디렉터리로 이동
2. 빈 곳에서 `Shift + 마우스 우클릭`을 눌러 컨텍스트 메뉴 표시
3. \*\*\[여기서 명령 창 열기\]\*\*를 선택하여 CMD 창 열기 (이때 기본적으로 현재 디렉터리에 위치하게 됨)
4. 파라미터가 포함된 명령어 입력 (예: `cfst -tl 200 -dn 20`) 후 실행
\*\*방법 2\*\*：
1. CFST 프로그램이 있는 디렉터리로 이동
2. 폴더 주소창을 전체 선택(또는 비우기)한 후 `cmd`를 입력하고 엔터를 치면 CMD 창이 열림 (이때 기본적으로 현재 디렉터리에 위치하게 됨)
4. 파라미터가 포함된 명령어 입력 (예: `cfst -tl 200 -dn 20`) 후 실행
> 물론 아무 CMD 창이나 열고 `cd /d "D:\Program Files\cfst"`와 같이 입력하여 프로그램 디렉터리로 이동해도 됩니다.
> \*\*팁\*\*：\*\*PowerShell\*\*을 사용하는 경우 명령어 안의 `cfst`를 `.\cfst`로 바꾸기만 하면 됩니다.
> \*\*주의\*\*：\*\*PowerShell\*\* 환경에서 `-o ""`를 사용하면 빈 파라미터가 무시되어 오류가 발생하므로, 공백을 포함한 `-o " "`를 사용하여 해결할 수 있습니다.
\*\*\*\*
#### \# Windows 바로 가기로 파라미터와 함께 실행
실행 파라미터를 자주 수정하지 않는 분(예: 평소에 그냥 더블클릭해서 실행하는 분)이라면 바로 가기를 사용하는 것이 더 편리합니다.
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
`cfst.exe` 파일을 우클릭하고 - \*\*\[바로 가기 만들기\]\*\*를 선택한 다음, 해당 바로 가기를 우클릭하여 - \*\*\[속성\]\*\*에 들어가 \*\*대상\*\*을 다음과 같이 수정합니다.
``` 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 파일을 찾지 못합니다.
```
\*\*\*\*
#### \# IPv4/IPv6
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
``` bash
# 내장된 IPv4 데이터 파일을 지정하여 해당 IPv4 주소를 측정할 수 있습니다(-f의 기본값이 ip.txt이므로 이 파라미터는 생략 가능).
cfst -f ip.txt
# 내장된 IPv6 데이터 파일을 지정하여 해당 IPv6 주소를 측정할 수 있습니다.
# 또한 v2.1.0 버전 이후부터는 IPv4+IPv6 혼합 속도 측정을 지원하며 -ipv6 파라미터가 제거되었으므로, 하나의 파일 안에 IPv4와 IPv6 주소가 동시에 포함될 수 있습니다.
cfst -f ipv6.txt
# 파라미터를 통해 측정할 IP를 직접 지정할 수도 있습니다.
cfst -ip 1.1.1.1,2606:4700::/32
```
> IPv6를 측정할 때 매번 측정 수량이 다를 수 있습니다. 그 이유는 다음 링크를 참고하세요: [#120](https://github.com/XIU2/CloudflareSpeedTest/issues/120)
> IPv6는 그 수가 너무 많고(억 단위), 대다수 IP 대역이 아예 활성화되어 있지 않기 때문에 사용 가능한 IPv6 대역 중 일부만 스캔하여 `ipv6.txt` 파일에 작성해 두었습니다. 관심이 있으신 분들은 직접 스캔하여 추가하거나 삭제할 수 있으며, ASN 데이터 소스는 [bgp.he.net](https://bgp.he.net/AS13335#\_prefixes6)에서 가져왔습니다.
\*\*\*\*
#### \# HTTPing
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
현재 지연 시간 측정 모드는 \*\*TCP 프로토콜, HTTP 프로토콜\*\* 두 가지가 있습니다.
TCP 프로토콜은 소요 시간이 더 짧고 리소스를 적게 소모하며, 타임아웃은 1초이고 기본 모드입니다.
HTTP 프로토콜은 특정 도메인이 특정 IP를 가리킬 때 접근 가능한지 빠르게 테스트하는 데 적합하며, 타임아웃은 2초입니다.
동일한 IP에 대해 각 프로토콜로 핑을 테스트했을 때 얻는 지연 시간은 일반적으로 \*\*ICMP < TCP < HTTP\*\* 순이며, 오른쪽으로 갈수록 패킷 손실 등 네트워크 변동에 더 민감합니다.
> 주의: HTTPing도 본질적으로는 일종의 \*\*네트워크 스캔\*\* 행위이므로, 서버에서 실행하는 경우 \*\*동시성(`-n`)\*\*을 낮추어야 합니다. 그렇지 않으면 일부 엄격한 호스팅 업체로부터 서비스가 일시 중지될 수 있습니다. HTTPing의 초기 속도 측정 시 사용 가능한 IP 수는 정상인데 이후 점점 줄어들거나 아예 0이 되었다가, 일정 시간이 지난 후 다시 복구되는 현상을 겪는다면, 통신사나 Cloudflare CDN이 네트워크 스캔을 수행하는 것으로 간주하여 \*\*임시 제한 메커니즘이 발동\*\*되었기 때문일 수 있습니다. 따라서 잠시 후에 다시 복구되는 것이며, 이러한 현상이 발생하는 것을 줄이기 위해 \*\*동시성(`-n`)\*\*을 낮추는 것을 권장합니다.
> 또한 본 소프트웨어의 HTTPing은 \*\*응답 헤더(response headers)\*\*만 가져올 뿐 본문 내용은 가져오지 않습니다(즉, URL 파일 크기는 HTTPing 테스트에 영향을 주지 않지만, 다운로드 속도 측정까지 하려면 여전히 큰 파일이 필요합니다). curl -i 기능과 유사합니다.
> 또한 HTTPing 진행 중에 소프트웨어는 HTTP 응답 헤더에서 해당 IP의 현재 지역 코드(Cloudflare, AWS CloudFront, Fastly, Gcore, CDN77, Bunny 등의 CDN 지원)를 가져와 표시합니다. TCPing 중에는 이렇게 할 수 없지만, 다운로드 속도 측정 시에는 어차피 다운로드 속도 측정 역시 HTTP 링크이므로 이와 같이 지역 코드를 가져옵니다.
``` 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
# 다른 웹사이트나 CDN을 HTTPing 테스트하려면 해당 웹사이트 또는 해당 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
```
\*\*\*\*
#### \# 지정 지역 매칭
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
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, AWS CloudFront, Fastly, Gcore, CDN77, Bunny\*\* 등의 CDN을 지원합니다.
> 단, 모든 CDN이 Anycast 기술을 지원하는 것은 아니며, 많은 CDN이 웹사이트에서 사용할 수 있는 IP 범위를 제한합니다.
> 그중 \*\*Cloudflare, AWS CloudFront, Fastly\*\*는 모두 \*\*`IATA 3글자 공항 지역 코드`\*\*를 사용합니다. 예: HKG, LAX
> 반면 \*\*CDN77, Bunny\*\*는 \*\*`2글자 국가/지역 코드`\*\*를 사용합니다. 예: US, CN
> \*\*Gcore\*\*는 \*\*`2글자 도시 코드`\*\*를 사용합니다. 예: FR, AM
> 따라서 사용자들이 `-cfcolo`로 지역 코드를 지정할 때는 CDN에 따라 서로 다른 유형의 지역 코드를 지정해야 합니다.
> \*\*주의\*\*：만약 AWS CloudFront CDN 지역을 필터링하려는 경우, `-url` 파라미터를 통해 AWS CloudFront CDN을 사용하는 다운로드 속도 측정 주소를 지정해야 합니다(소프트웨어의 기본 다운로드 속도 측정 주소가 Cloudflare CDN용이기 때문입니다). 또한 때로는 HTTPing 모드로 일부 AWS CloudFront 주소를 측정할 때 403 오류가 반환될 수 있는데, 이 경우 `-httping-code 403`을 추가해야 지역 코드를 올바르게 가져올 수 있습니다.
``` bash
# 지정된 지역 이름 뒤에 지연 시간 측정 후 얻은 결과는 모두 지정된 지역의 IP가 됩니다(-dd를 지정하지 않은 경우 다운로드 속도 측정이 계속 진행됩니다).
# 지연 시간 측정 후 결과가 0인 경우, 지정된 지역의 IP를 전혀 찾지 못했음(시간 초과되지 않고 사용 가능한 IP 없음)을 의미합니다.
# 노드 지역 이름은 현지 IATA 공항 지역 코드 또는 국가/도시 코드이며, 여러 개를 지정할 때는 쉼표로 구분하고 v2.2.3 버전부터 소문자를 지원합니다.
cfst -httping -cfcolo HKG,KHH,NRT,LAX,SEA,SJC,FRA,MAD
# 주의: 이 파라미터는 HTTPing 지연 시간 측정 모드에서만 사용할 수 있습니다(소프트웨어가 HTTP 링크의 응답 헤더를 통해 해당 IP의 실제 지역 코드를 얻기 때문입니다).
# 또한, HTTPing 과정에서 소프트웨어는 HTTP 응답 헤더에서 해당 IP의 현재 지역 코드(Cloudflare, AWS CloudFront, Fastly, Gcore, CDN77, Bunny 등의 CDN 지원)를 가져와 표시하지만, TCPing 과정에서는 이렇게 할 수 없습니다(하지만 다운로드 속도 측정 시에는 다운로드 속도 측정 역시 HTTP 링크이므로 지역 코드를 가져오기 위해 이 작업을 수행합니다).
```
> \*\*`IATA 3글자 공항 지역 코드`\*\* 참고: https://www.cloudflarestatus.com/
> \*\*`2글자 국가 코드`\*\* 참고: [https://zh.wikipedia.org/wiki/ISO\_3166-1二位字母代码#正式分配代码](https://zh.wikipedia.org/wiki/ISO\_3166-1%E4%BA%8C%E4%BD%8D%E5%AD%97%E6%AF%8D%E4%BB%A3%E7%A0%81#%E6%AD%A3%E5%BC%8F%E5%88%86%E9%85%8D%E4%BB%A3%E7%A0%81)
\*\*\*\*
#### \# 파일 상대/절대 경로
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
``` 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
```
\*\*\*\*
#### \# 다른 포트 속도 측정
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
``` bash
# 기본 443이 아닌 다른 포트의 속도를 측정하려면 -tp 파라미터를 통해 지정해야 합니다(이 파라미터는 지연 시간 측정/다운로드 속도 측정 시 사용하는 포트에 영향을 줍니다).
# 80번 포트 지연 시간 측정 + 다운로드 속도 측정을 하려면(-dd로 다운로드 속도 측정을 비활성화한 경우는 불필요), http:// 프로토콜의 다운로드 속도 측정 주소도 함께 지정해야 합니다(그리고 해당 주소는 HTTPS로 강제 리디렉션되지 않아야 합니다. 그렇게 되면 443 포트가 되기 때문입니다).
cfst -tp 80 -url http://speed.cloudflare.com/\_\_down?bytes=99999999
# 80 및 443이 아닌 다른 포트인 경우, 사용하는 다운로드 속도 측정 주소가 해당 비표준 포트를 통한 접속을 지원하는지 확인해야 합니다.
```
\*\*\*\*
#### \# 사용자 정의 속도 측정 주소
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
``` bash
# 이 파라미터는 다운로드 속도 측정 및 HTTP 프로토콜의 지연 시간 측정에 적용되며, 후자의 경우 해당 주소는 임의의 웹페이지 URL일 수 있습니다(특정 파일 주소에 국한되지 않음).
# 주소 요구사항: 직접 다운로드 가능, 파일 크기 200MB 초과, Cloudflare CDN 사용
cfst -url https://cf.xiu2.xyz/url
# 주의: 속도 측정 주소가 HTTP 프로토콜인 경우(해당 주소는 HTTPS로 강제 리디렉션될 수 없음), -tp 80을 추가하는 것을 잊지 마세요(이 파라미터는 지연 시간 측정/다운로드 속도 측정 시 사용하는 포트에 영향을 줍니다). 80 및 443 포트가 아닌 경우 다운로드 속도 측정 주소가 해당 포트를 통한 접속을 지원하는지 확인해야 합니다.
cfst -tp 80 -url http://speed.cloudflare.com/\_\_down?bytes=99999999
```
\*\*\*\*
#### \# 사용자 정의 속도 측정 조건 (지연 시간/패킷 손실률/다운로드 속도의 목표 범위 지정)
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
> 주의: 지연 시간 측정 진행률 바 오른쪽의 \*\*사용 가능한 수량\*\*은 지연 시간 측정 과정에서 \*\*시간 초과되지 않은 IP의 수량\*\*만을 의미하며, 지연 시간 상하한 조건과는 관련이 없습니다.
- \*\*[평균 지연 시간 상한]\*\* 조건만 지정
``` bash
# 평균 지연 시간 상한: 200 ms, 다운로드 속도 하한: 0 MB/s
# 즉, 평균 지연 시간이 200 ms 미만인 IP를 찾은 다음, 지연 시간이 낮은 순서부터 10번 다운로드 진행

속도 측정
cfst -tl 200
```
> \*\*지연时间(지연 시간) 조건을 만족하는 IP를 찾지 못한 경우\*\*, 아무런 내용도 출력되지 않습니다.
\*\*\*\*
- \*\*[평균 지연 시간 상한]\*\* 조건을 지정하고, \*\*지연 시간 측정만 수행하며 다운로드 속도 측정은 생략\*\*합니다.
``` bash
# 평균 지연 시간 상한: 200 ms, 다운로드 속도 하한: 0 MB/s, 수량: 알 수 없음 개
# 즉, 200ms 미만의 IP만 출력하고 다운로드 속도 측정은 하지 않습니다 (다운로드 속도 측정을 하지 않으므로 -dn 파라미터는 무효화됩니다).
cfst -tl 200 -dd
```
\*\*\*\*
- \*\*[평균 지연 시간 하한] + [평균 지연 시간 상한]\*\* 조건을 동시에 지정합니다.
``` bash
# 평균 지연 시간 하한: 60 ms, 평균 지연 시간 상한: 200 ms, 다운로드 속도 하한: 0 MB/s
# 즉, 평균 지연 시간이 60 ms 초과 200 ms 미만인 IP(즉, 60~200ms 사이)를 찾은 다음, 지연 시간이 낮은 순서부터 높은 순서로 10회의 다운로드 속도 측정을 수행합니다.
cfst -tll 60 -tl 200
```
> 지연 시간은 무조건 낮을수록 좋은 것이 아니냐며 의아해하시는 분들이 많을 것입니다. 왜 저지연 IP를 제외하는 것일까요?
> - 한편으로는, 일부 사용자에게 특정 지연 시간 구간을 지정해야 하는 개인화된 요구가 실제로 존재하기 때문입니다.
> - 다른 한편으로는, \*\*지연 시간과 패킷 손실률이 가장 낮은 IP가 반드시 더 빠른 속도를 보장하지는 않기 때문\*\*입니다(물론 일반적으로 지연 시간이 낮고 패킷 손실이 없는 것이 더 좋습니다. 이는 \*\*"물리적 거리 가까움 + 중간 라우팅 단계 적음 + 네트워크 안정적"\*\*을 의미하므로, 이러한 네트워크 품질에서 고속을 경험할 확률이 더 높기 때문입니다). 하지만 네트워크 품질이 좋다고 해서 무조건 속도가 빠른 것은 아닙니다. 전송 속도는 제어될 수 있기 때문입니다(예: QOS). 따라서 지연 시간이 더 길지만 오히려 속도가 더 빠른 경우도 발생할 수 있습니다(단, 이는 지연 시간 차이에 국한되며, 패킷 손실이 개입될 경우 패킷 손실이 전송 속도에 미치는 영향이 \*\*매우 극단적\*\*이므로 이로 인해 이러한 현상이 발생할 수도 있습니다).
> - 예를 들어, 중국 국내의 차이나모바일(China Mobile) 사용자가 기본 파라미터로 속도를 측정하면 기본적으로 수십 ms 대의 홍콩 노드 IP들만 일관되게 나오는 경우가 많습니다. 하지만 지연 시간이 매우 낮고 패킷 손실도 없는데 속도가 터무니없이 느리거나 속도가 들쭉날쭉하여 사람을 지치게 만드는 경우가 쉽게 발생합니다. 이럴 때 다른 지역으로 변경하면 지연 시간은 더 길어질지라도 오히려 속도가 더 빠를 수 있으며, 이때 `-tll`을 사용하여 이러한 홍콩 IP들을 필터링할 수 있습니다(이 외에는 httping 모드 하의 colo 파라미터로만 필터링이 가능합니다).
\*\*\*\*
- \*\*[패킷 손실률 상한]\*\* 조건만 지정합니다.
``` bash
# 패킷 손실률 상한: 0.25
# 즉, 패킷 손실률이 0.25 이하인 IP를 찾습니다. 범위는 0.00~1.00이며, -tlr 0을 지정하면 패킷 손실이 조금이라도 있는 IP는 모두 필터링합니다.
cfst -tlr 0.25
```
\*\*\*\*
- \*\*[다운로드 속도 하한]\*\* 조건만 지정합니다.
``` bash
# 평균 지연 시간 상한: 9999 ms, 다운로드 속도 하한: 5 MB/s, 수량: 10개 (선택 사항)
# 즉, 평균 지연 시간이 9999 ms 미만이고 다운로드 속도가 5 MB/s를 초과하는 IP 10개를 찾을 때까지 속도 측정을 멈추지 않습니다.
cfst -sl 5 -dn 10
```
> \*\*속도 조건을 만족하는 IP를 찾지 못한 경우\*\* 아무런 내용도 출력되지 않습니다. 예상하는 다운로드 속도 측정 하한 조건을 낮춰야 할 수도 있지만, 현재 대략적인 속도 측정 범위가 어느 정도인지 파악해야 한다면 `-debug` 파라미터를 추가하여 디버그 모드를 활성화할 수 있습니다. 이렇게 하면 이와 같은 상황이 발생했을 때 \*\*조건을 무시하고 모든 속도 측정 결과를 반환\*\*하므로, 해당 IP들의 다운로드 속도가 어느 정도인지 확인할 수 있어 감을 잡을 수 있습니다. 그 후 \*\`-sl\` 값을 적절히 낮추어서 다시 시도\*\*해 보면 됩니다.
> 주의할 점은, 만약 다운로드 속도 하한 `-sl` 조건을 \*\*지정하지 않았다면\*\* 어떤 상황에서든 CFST는 \*\*모든 속도 측정 결과를 출력\*\*합니다.
> 평균 지연 시간 상한을 지정하지 않은 상태에서 조건을 만족하는 IP 수량이 \*\*계속 부족\*\*하면, \*\*속도 측정이 계속 진행\*\*됩니다.
> \*\*[다운로드 속도 하한] + [평균 지연 시간 상한]\*\*을 \*\* 동시에 지정\*\*하는 것을 권장합니다. 이렇게 하면 지정한 지연 시간 상한에 도달할 때까지 수량을 채우지 못할 경우 속도 측정이 종료됩니다.
\*\*\*\*
- \*\*[평균 지연 시간 상한] + [다운로드 속도 하한]\*\* 조건을 동시에 지정합니다.
``` bash
# 평균 지연 시간 상한과 다운로드 속도 하한 모두 소수를 지원합니다 (예: -sl 0.5).
# 평균 지연 시간 상한: 200 ms, 다운로드 속도 하한: 5.6 MB/s, 수량: 10개 (선택 사항)
# 즉, 평균 지연 시간이 200 ms 미만이고 다운로드 속도가 5.6 MB/s를 초과하는 IP 10개를 찾을 때까지 속도 측정을 멈추지 않습니다.
cfst -tl 200 -sl 5.6 -dn 10
```
> \*\*지연 시간 조건을 만족하는 IP를 찾지 못한 경우\*\* 아무런 내용도 출력되지 않습니다.
> \*\*속도 조건을 만족하는 IP를 찾지 못한 경우\*\* 아무런 내용도 출력되지 않지만, `-debug` 파라미터를 추가하여 디버그 모드를 활성화하면 조건을 무시하고 모든 IP 속도 측정 결과가 출력됩니다 (다음 속도 측정 시 조건을 조정하는 데 도움이 됩니다).
> 따라서 조건을 지정하지 않은 상태로 속도 측정을 한 번 먼저 수행하여 평균 지연 시간과 다운로드 속도가 대략 어느 범위에 있는지 확인한 후, 지정하는 조건이 \*\*너무 낮거나/높지 않도록\*\* 하는 것을 권장합니다!
> Cloudflare가 공개한 IP 대역은 \*\*소스 원본 IP(Origin IP) + 애니캐스트 IP(Anycast IP)\*\*로 구성되어 있으며, \*\*소스 원본 IP\*\*는 사용할 수 없기 때문에 다운로드 속도 측정값이 0.00으로 나타납니다.
> 실행 시 `-sl 0.01`(다운로드 속도 하한)을 추가하여 \*\*소스 원본 IP\*\* (다운로드 속도 측정값이 0.01MB/s 미만인 결과)를 필터링할 수 있습니다.
\*\*\*\*
여러분들이 혼동하지 않도록 다양한 조건 조합에 따른 예상 출력 결과를 정리해 두었습니다.
\*\*지연/속도 조건을 전혀 지정하지 않은 경우 (즉, 모두 기본값인 경우):\*\*
- 상황과 관계없이 무조건 \*\*모든 속도 측정 결과\*\*를 직접 출력합니다.
\*\*\*\*
\*\*지연 시간 조건을 하나라도 지정한 경우 (`-tl`, `-tll`, 그리고 디버그 모드 `-debug`의 활성화 여부와 상관없이 모두 동일함):\*\*
- 조건을 만족하는 IP를 최소 1개 이상 찾은 경우, \*\*해당 조건을 만족하는 IP들만\*\* 출력합니다 (다운로드 속도 측정이 비활성화되지 않았다면 다운로드 속도 측정이 계속 진행됩니다).
- 조건을 만족하는 IP를 단 하나도 찾지 못한 경우, \*\*공백(비어 있음)\*\*을 출력합니다 (다운로드 속도 측정이 비활성화되지 않았더라도 수량이 0이므로 다운로드 속도 측정은 건너뛰게 됩니다).
\*\*\*\*
\*\*다운로드 속도 조건을 하나라도 지정한 경우 (`-sl`):\*\*
그리고 \*\*디버그 모드가 꺼져 있을\*\* 때 (즉, `-debug` 파라미터를 추가하지 않은 경우. 이 경우 지연 시간 측정 로직과 완전히 일치합니다):
- 조건을 만족하는 IP를 최소 1개 이상 찾은 경우, \*\*해당 조건을 만족하는 IP들만\*\* 출력합니다.
- 조건을 만족하는 IP를 단 하나도 찾지 못한 경우, \*\*공백(비어 있음)\*\*을 출력합니다.
그리고 \*\*디버그 모드가 켜져 있을\*\* 때 (즉, `-debug` 파라미터를 추가한 경우. 지연 시간 측정에는 아래 두 번째 항목의 로직이 적용되지 않으므로 여전히 공백이 출력됩니다):
- 조건을 만족하는 IP를 최소 1개 이상 찾은 경우, \*\*해당 조건을 만족하는 IP들만\*\* 출력합니다.
- 조건을 만족하는 IP를 단 하나도 찾지 못한 경우, 곧바로 \*\*모든 속도 측정 결과\*\*를 출력합니다.
\*\*\*\*
#### \# 하나 또는 여러 개의 IP에 대해 개별 속도 측정
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
\*\*방법 1\*\*：
파라미터를 통해 속도 측정할 IP 대역 데이터를 직접 지정합니다.
``` bash
# 먼저 CFST가 위치한 디렉터리로 진입한 후 실행:
# Windows 시스템 (CMD에서 실행)
cfst -ip 1.1.1.1,2.2.2.2/24,2606:4700::/32
# Linux 시스템
./cfst -ip 1.1.1.1,2.2.2.2/24,2606:4700::/32
```
\*\*\*\*
\*\*방법 2\*\*：
또는 이러한 IP들을 다음과 같은 형식으로 임의의 텍스트 파일에 작성합니다 (예: `1.txt`):
```
1.1.1.1
1.1.1.200
1.0.0.1/24
2606:4700::/32
```
> 단일 IP인 경우 `/32` 서브넷 마스크를 생략할 수 있습니다 (즉, `1.1.1.1`은 `1.1.1.1/32`와 동일합니다).
> 서브넷 마스크 `/24`는 해당 IP의 마지막 자리를 의미하며, 즉 `1.0.0.1~1.0.0.255`를 뜻합니다.
그런 다음 CFST를 실행할 때 시작 파라미터 `-f 1.txt`를 추가하여 IP 대역 데이터 파일을 지정합니다.
``` 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 파라미터를 추가하세요.
```
\*\*\*\*
#### \# 다운로드 속도 측정값이 전부 0.00인가요?
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
\*\*\#\# 원리 간단 설명:\*\*
먼저 이해해야 할 점은 CFST의 다운로드 속도 측정 과정은 기본적으로 `IP 다운로드 속도 측정 주소 도메인`을 hosts 파일에 기록한 뒤 브라우저가 해당 다운로드 속도 측정 주소에 접속하는 것과 본질적으로 같으며, 단지 이를 소프트웨어가 자동화한 것뿐이라는 점입니다 (예: `curl -I --resolve 다운로드 속도 측정 주소 도메인:443:IP https://다운로드 속도 측정 주소`).
따라서 다운로드 속도 측정 결과가 전부 0.00 MB/s라면, 이는 \*\*다운로드 속도 측정 과정에서 문제나 오류가 발생\*\*하여 속도 측정이 즉시 중단되었음(최종적으로 0.00으로 표시됨)을 의미하며, 원인은 다음 몇 가지 가능성뿐입니다.
1. \*\*다운로드 속도 측정 주소에 문제가 있는 경우\*\*
2. \*\*속도 측정 대상 IP 주소에 문제가 있는 경우\*\*
3. \*\*사용자의 네트워크에 문제가 있는 경우\*\*
\*\*\*\*
\*\*\#\# 디버그 모드 문제 해결:\*\*
다음으로, \*\*반드시\*\* 기존에 사용하던 CFST 실행 명령어 뒤에 \*\`-debug\` 파라미터를 추가하여 디버그 모드를 활성화\*\*한 후 속도 측정을 다시 실행해 보세요. 이렇게 하면 다운로드 속도 측정 과정에서 발생하는 모든 오류의 구체적인 원인이 표시되므로 문제 해결에 도움이 됩니다.
일반적인 다운로드 속도 측정 실패 오류 원인은 다음과 같습니다 (Go 언어의 네이티브

(오류 메시지이므로 대부분 영어로 표시됩니다):
1. `... read: connection reset by peer ... `
\*\*연결이 재설정되었습니다\*\*. 다운로드 속도 측정 주소가 차단되었거나, 속도 측정 IP가 타겟팅되어 HTTPS 차단(방화벽 또는 통신사(예: 차이나모바일 또는 일부 지역의 화이트리스트)에 의한 차단일 수 있음)을 당했을 수 있습니다. 물론 속도 측정 IP 서버가 단순히 귀하의 잘못된 링크 요청을 리셋했을 수도 있습니다.
2. `... HTTP 상태 코드: 403 ...`
이처럼 \*\*HTTP 상태 코드\*\*가 직접 표시되는 경우는 비교적 판단하기 쉽습니다. 예를 들어 403은 다운로드 속도 측정 주소의 접근이 금지되었음을 의미하고, 404는 다운로드 속도 측정 주소의 경로에 해당하는 파일을 찾을 수 없음을 의미합니다(기타 구체적인 내용은 HTTP 상태 코드의 의미를 검색해 보세요).
3. `... context deadline exceeded (Client.Timeout exceeded while awaiting headers) ...`
이 경우는 일반적으로 \*\*요청 시간 초과(Timeout)\*\*로 인해 발생합니다. IP나 네트워크 문제일 수도 있고, `-dt` 다운로드 속도 측정 시간이 너무 짧게 설정되었기 때문일 수도 있습니다(물론 기본값인 10초가 짧은 것은 아닙니다).
4. `... tls: handshake failure ...` 또는 `... tls: failed to verify certificate ...`
이러한 \*\*TLS 핸드셰이크 실패/SSL 인증서 오류\*\*는 다운로드 속도 측정 주소와 속도 측정 IP 서버가 일치하지 않음을 의미합니다. 즉, 다운로드 속도 측정 주소와 속도 측정 IP 중 한쪽에 오류가 있는 것입니다(예: 다운로드 속도 측정 주소는 Fastly CDN에 호스팅되어 있는데 속도 측정 IP는 Cloudflare CDN이거나, 그 반대의 경우입니다. 요약하자면, 다운로드 속도 측정 주소에 액세스할 때 해당 속도 측정 IP 서버가 이 사이트의 도메인을 인식하지 못하고 거부하는 것입니다).
5. `... tls: failed to verify certificate: x509: certificate is valid for XXX.XX, not YYY.YY ...`
이 경우는 \*\*SSL 인증서에 다운로드 속도 측정 주소의 도메인이 포함되어 있지 않은 경우\*\*입니다. 다운로드 속도 측정 주소의 인증서 설정에 문제가 있거나, 해당 속도 측정 서버 IP에 다운로드 속도 측정 주소 도메인에 해당하는 SSL 인증서가 존재하지 않는 것입니다. 즉, 이 서버 IP는 해당 다운로드 속도 측정 주소 도메인에 사용할 수 없음을 의미합니다(예: 구글의 서버 IP로 바이두의 도메인 다운로드 속도를 측정하려 할 때 이와 같은 현상이 발생하거나, 위 4번과 같은 원인입니다).
6. `... tls: failed to verify certificate: x509: certificate has expired or is not yet valid: current time ...`
이 경우는 \*\*SSL 인증서가 만료되었거나 아직 유효 기간이 되지 않은 경우\*\*입니다. 이 원인 외에도 위 4번, 5번과 원인이 같을 수 있습니다(이 4, 5, 6번 세 가지 오류는 동일한 서버 IP에서 동시에 발생할 수 있습니다).
7. `... tls: failed to verify certificate: x509: certificate signed by unknown authority.`
이것은 \*\*시스템 인증서 설정에 문제\*\*가 있어 TLS 핸드셰이크 시 인증서를 검증할 수 없음을 나타냅니다. 현재 Termux 내에서만 확인되었습니다(해결 방법 참고: https://github.com/XIU2/CloudflareSpeedTest/discussions/61 게시글 하단).
> 만약 다른 오류 원인과 마주쳤고 번역해도 이해가 가지 않는다면, Issues나 Discussions에 문의해 주세요. 저도 여기에 내용을 업데이트하겠습니다.
> 단, Issues나 Discussions에 문의할 때는 반드시 \*\*디버그 모드에서의 CFST 출력 전체 내용(또는 전체 스크린샷)\*\*을 함께 첨부해 주세요.
위의 오류 원인에 따라 문제를 하나씩 확인해 본 후에도 해결할 수 없다면, 다음 단계의 추가 문제 해결을 시도해 볼 수 있습니다.
\*\*\*\*
\*\*1. 다운로드 속도 측정 주소에 문제가 있는 경우\*\*：
먼저 [#490](https://github.com/XIU2/CloudflareSpeedTest/discussions/490)으로 가서 다른 몇 가지 다운로드 속도 측정 주소를 모두 시도해 보세요.
그중 다운로드 속도 측정이 정상적으로 완료되는 주소가 있다면, 그것은 이전에 사용하던 다운로드 속도 측정 주소에 문제가 있었음을 의미합니다(주의: 현재 기본 다운로드 속도 측정 주소는 로드 밸런싱 폴링이 포함된 리다이렉트 링크 하나뿐이며, 위 게시글에서 모두가 공유하는 공익 목적의 다운로드 속도 측정 주소로 자동 리다이렉트됩니다. 이러한 주소들은 \*\*지역에 따라 가용성이 다를 수 있으므로\*\* 예전에는 안 되다가 지금은 정상적으로 작동하는 현상이 발생할 수 있습니다. \*\*안정성을 원하신다면 자체 구축을 권장\*\*하며, 위 게시글에 몇 가지 자체 구축 방법이 작성되어 있습니다).
많은 주소를 시도해 보았음에도 모두 0.00이 나온다면, 다른 가능성을 고려해야 합니다.
\*\*\*\*
\*\*2. 속도 측정 IP 주소에 문제가 있는 경우\*\*：
속도 측정에 사용하는 IP 주소는 일부 TCP 테스트는 통과하더라도, 다양한 원인으로 인해 실제 HTTP 연결을 수립하지 못할 수 있습니다(예: 원본 복원 IP(Origin-pull IP), 기업 사용자 전용 IP 등). 따라서 다른 IP들도 여러 개 시도해 보고 작동하는지 확인해 보세요.
\*\*\*\*
\*\*3. 사용 중인 네트워크에 문제가 있는 경우\*\*：
이 경우는 조금 번거롭습니다. 현재 컴퓨터 + 유선 랜을 사용하여 CFST로 속도를 측정하고 있다면, 휴대폰의 WIFI를 끄고 모바일 데이터를 켠 다음, 데이터 케이블로 컴퓨터와 연결하고 USB 테더링을 설정한 후(휴대폰 시스템마다 조금씩 다르므로 직접 검색해 보세요), 컴퓨터의 랜선을 뽑아보세요. 이렇게 하면 이제 컴퓨터는 휴대폰의 모바일 데이터 네트워크를 사용하게 됩니다(휴대폰 데이터와 유선 랜의 통신사가 다를 경우 원인 파악에 더 유리합니다). 그 후 CFST 속도 측정을 다시 실행하여 결과가 바뀌는지 확인해 보세요(교차 검증을 위해 위의 문제 해결 방법들을 동시에 시도해 볼 수도 있습니다).
속도 측정 결과가 정상으로 돌아온다면 이는 명백히 유선 랜 네트워크의 문제입니다. 만약 여전히 0.00이라면 번거로워집니다...
\*\*\*\*
\*\*\*\*
#### \# Cloudflare CDN을 사용하는 모든 웹사이트를 단번에 가속하기 (더 이상 Hosts에 도메인을 하나씩 추가할 필요 없음)
전에 말했듯이, 이 소프트웨어 프로젝트를 개발한 목적은 \*\*Hosts를 수정하는 방식으로 Cloudflare CDN을 사용하는 웹사이트의 접속을 가속화\*\*하기 위함입니다.
하지만 [\*\*#8\*\*](https://github.com/XIU2/CloudflareSpeedTest/issues/8)에서 언급한 것처럼, Hosts에 도메인을 하나씩 추가하는 것은 너무 \*\*번거롭기\*\* 때문에, \*\*단번에 해결할 수 있는\*\* 방법을 찾아냈습니다! 이 [\*\*아직도 Hosts에 하나씩 추가하고 계시나요? Cloudflare CDN을 사용하는 모든 웹사이트를 로컬에서 완벽하게 가속하는 방법이 나왔습니다!\*\*](https://github.com/XIU2/CloudflareSpeedTest/discussions/71) 및 [로컬 DNS 서비스에 의존하여 도메인 이름 해석 IP를 자체 선택 IP로 수정하는 방법](https://github.com/XIU2/CloudflareSpeedTest/discussions/317) 튜토리얼을 참고해 주세요.
\*\*\*\*
#### \# Hosts 자동 업데이트
가장 빠른 Cloudflare CDN IP를 획득한 후, Hosts 파일의 IP를 교체해야 하는 사용자가 많다는 점을 고려했습니다.
[\*\*Issues\*\*](https://github.com/XIU2/CloudflareSpeedTest/discussions/312)를 참고하여 \*\*Windows/Linux Hosts 자동 업데이트 스크립트\*\*를 받아보세요!
\*\*\*\*
## 문제 피드백
문제가 발생했다면 먼저 [\*\*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)를 생성하여 알려주세요!
> [!NOTE]
> \*\*주의\*\*!\_CFST 자체의 `문제 피드백, 기능 제안`과 관련 없는 내용은 프로젝트 내부 포럼에서 토론해 주세요(상단의 `💬 Discussions`\_
\*\*\*\*
## 도움이 되었다면 "후원"해 주세요~🎉✨
![위챗 후원](https://github.com/XIU2/XIU2/blob/master/img/zs-01.png)![알리페이 후원](https://github.com/XIU2/XIU2/blob/master/img/zs-02.png)
\*\*\*\*
## 파생 프로젝트
- \_[https://github.com/Hsia97/CFSTAPP](https://github.com/Hsia97/CFSTAPP)\_
\_\*\*CFST 안드로이드 버전 APP [#638](https://github.com/XIU2/CloudflareSpeedTest/discussions/638)\*\*\_
- \_https://github.com/xianshenglu/cloudflare-ip-tester-app\_
\_\*\*CFST 안드로이드 버전 APP [#202](https://github.com/XIU2/CloudflareSpeedTest/discussions/320)\*\*\_
- \_http

s://github.com/kimmax603/luci-app-cloudflarespeedtest\_
\_\*\*CFST OpenWrt 라우터 플러그인 버전 [#651](https://github.com/XIU2/CloudflareSpeedTest/issues/651)\*\*\_
- \_https://github.com/immortalwrt-collections/openwrt-cdnspeedtest\_
\_\*\*CFST OpenWrt 네이티브 컴파일 버전 [#64](https://github.com/XIU2/CloudflareSpeedTest/discussions/64)\*\*\_
- \_https://github.com/GuangYu-yu/CloudflareST-Rust\_
\_\*\*CFST Rust 버전\*\*\_
- \_https://github.com/masgzy/CloudflareST\_
\_\*\*CFST의 포크 파생 버전 (여전히 Go)\*\*\_
- \_https://github.com/hoseinnikkhah/CloudflareSpeedTest-English\_
\_\*\*English language version of CFST (Text language differences only) [#64](https://github.com/XIU2/CloudflareSpeedTest/issues/68)\*\*\_
> \_여기에는 본 프로젝트에서 홍보된 일부 CFST 관련 파생 프로젝트만 수집되어 있으며, 누락된 부분이 있다면 알려주세요~\_
\*\*\*\*
## 프로젝트 감사
- \_https://github.com/Spedoske/CloudflareScanner\_
> \_해당 프로젝트가 업데이트되지 않은 지 오래되었고, 저에게는 많은 기능 요구 사항이 생겨서 급하게 Go 언어를 조금 공부한 후 바로 시작했습니다(초보)...\_
> \_본 소프트웨어는 해당 프로젝트를 기반으로 하지만, \*\*완전히 리팩토링되었고 대량의 기능 추가 및 버그가 수정되었습니다\*\*.\_
\*\*\*\*
## 수동 컴파일
`「 클릭하여 펼치기 내용 보기 」`
\*\*\*\*
편의를 위해 저는 컴파일할 때 버전 번호를 코드의 version 변수에 작성하므로, 수동으로 컴파일할 때는 아래와 같이 `go build` 명령어 뒤에 `-ldflags` 파라미터를 추가하여 버전 번호를 지정해야 합니다.
```bash
go build -ldflags "-s -w -X main.version=v1.0.0"
# 이 명령어를 CloudflareSpeedTest 디렉터리에서 명령행(예: CMD, Bat 스크립트)을 통해 실행하면, 현재 장치와 동일한 시스템, 비트 수, 아키텍처 환경에서 실행할 수 있는 바이너리 프로그램(Go가 시스템 비트 수와 아키텍처를 자동으로 감지함)이 컴파일되며 버전 번호는 v1.0.0이 됩니다.
```
Windows 64비트 시스템에서 \*\*다른 시스템, 아키텍처, 비트 수\*\*로 컴파일하려면 \*\*GOOS\*\*와 \*\*GOARCH\*\* 변수를 지정해야 합니다.
예를 들어 Windows 시스템에서 \*\*Linux 시스템 amd 아키텍처 64비트\*\*용 바이너리 프로그램을 컴파일하는 경우:
```bat
SET GOOS=linux
SET GOARCH=amd64
go build -ldflags "-s -w -X main.version=v1.0.0"
```
예를 들어 Linux 시스템에서 \*\*Windows 시스템 amd 아키텍처 32비트\*\*용 바이너리 프로그램을 컴파일하는 경우:
```bash
GOOS=windows
GOARCH=386
go build -ldflags "-s -w -X main.version=v1.0.0"
```
> `go tool dist list`를 실행하여 현재 Go 버전이 컴파일을 지원하는 조합을 확인할 수 있습니다.
\*\*\*\*
물론 일괄 컴파일의 편의를 위해 버전 번호 전용 변수를 따로 지정하고, 이후 컴파일 시 해당 버전 번호 변수를 직접 호출하면 됩니다.
또한 일괄 컴파일 시에는 서로 다른 폴더에 나누어 담거나 파일명을 다르게 해야 하므로 `-o` 파라미터를 지정해야 합니다.
```bat
:: Windows 시스템의 경우:
SET version=v1.0.0
SET GOOS=linux
SET GOARCH=amd64
go build -o Releases\cfst\_linux\_amd64\cfst -ldflags "-s -w -X main.version=%version%"
```
```bash
# Linux 시스템의 경우:
version=v1.0.0
GOOS=windows
GOARCH=386
go build -o Releases/cfst\_windows\_386/cfst.exe -ldflags "-s -w -X main.version=${version}"
```
\*\*\*\*
## License
The GPL-3.0 License.

CloudflareSpeedTest

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README