ct

command module
v1.4.16 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 30, 2026 License: MIT Imports: 29 Imported by: 0

README

CT - Check Test

Version: 1.4.16

Go Version Platform

CT is a fast, flexible, multi-purpose network testing suite written in Go. It brings together DNS benchmarking, proxy checking, MTProto testing, Xray/V2Ray config validation, public source scraping, and Cloudflare IP scanning in one powerful tool.

CT Banner

Table of Contents

Overview

CT is built for users who need a single command-line tool to test network quality, validate proxy and Xray configs, manage scraping sources, scan Cloudflare IPs, and keep everything updated without leaving the terminal.

It is designed to be:

  • fast for large lists,
  • practical for daily use,
  • easy to extend,
  • and comfortable in both scripted and interactive workflows.

Why CT

  • All-in-One — DNS, proxy, MTProto, Xray, scraper, Cloudflare scanner, and update workflow in one binary.
  • Interactive — A cleaner terminal UI with arrow-key navigation and number support.
  • Smart Defaults — Prompts appear only when needed.
  • Cross-Platform — Windows, Linux, and macOS support.
  • Concurrent — Multi-threaded checks for speed.
  • System-Aware — Can apply best DNS or proxy settings directly.
  • Source-Managed — Scraper sources can be added, removed, reloaded, and displayed from within the app.
  • Cloudflare Ready — Advanced IP scanner with real-time results and multiple output formats.

What’s New in 1.4.15

This major release introduces the Cloudflare IP Scanner module — a powerful tool for discovering and testing Cloudflare IPs.

1) Cloudflare IP Scanner (New Module)

A complete Cloudflare IP scanning solution has been added to CT. This module allows you to:

  • Scan Cloudflare IP ranges — default fast ranges or full comprehensive ranges.
  • Real-time monitoring — Live table showing top 20 valid IPs with progress.
  • Multi-port scanning — Scan multiple ports simultaneously.
  • Concurrent scanning — Configurable worker count for speed.
  • Automatic validation — Detects Cloudflare IPs via headers, TLS certificates, and server responses.
  • HTTP/2 and HTTP/3 detection — Identifies supported protocols.
  • Latency measurement — Measures TCP connect latency with color-coded feedback.
  • Live IP saving — Valid IPs are saved in real-time to valid_ips_*.txt.
  • Multiple output formats — JSON (full details), CSV (spreadsheet), TXT (IP:Port only).
  • Custom range support — Scan specific CIDR ranges or use IP files.
  • GeoIP support — Optional GeoIP database integration for location data.
  • Speed test — Optional download speed measurement.
  • Color-coded table — Beautiful terminal output with progress, ETA, and sorted results.

2) Interactive UI improvements

The interactive menu is now more polished and easier to use. It supports:

  • arrow-key navigation,
  • highlighted selections,
  • number-based selection,
  • a branded startup banner,
  • automatic cursor hide/show during menu use,
  • new Cloudflare Scanner option.

3) Smarter prompts

Several prompts are now conditional instead of always showing up. For example:

  • DNS only asks for domains when HTTP testing is enabled.
  • Proxy prompts can now stay out of the way unless they are actually needed.
  • Xray-related prompts are more focused and reduce unnecessary input.
  • Cloudflare scanner prompts are streamlined and intuitive.

4) Scraper menu system

The scraper module now includes a built-in management menu for source handling:

  • add a source,
  • remove a source,
  • reload configuration,
  • show current configuration,
  • run scraping directly.

5) Run scraper directly

ct scrape run now executes scraping immediately instead of opening the management menu first.

6) Update checker

A new Check Update option was added to the main menu. It checks the version stored online and compares it with the local version.

7) Better default handling

The program now behaves more consistently when users skip optional inputs:

  • DNS defaults are applied automatically.
  • Proxy and Xray optional fields only appear when needed.
  • Empty values now fall back to safe defaults.
  • Cloudflare scanner uses intelligent defaults.

Features

DNS Benchmark

  • Multi-domain testing.
  • UDP and TCP support.
  • DNS-over-TLS and DNS-over-HTTPS support.
  • HTTP verification for extra confidence.
  • Speed-based and score-based sorting.
  • System DNS apply support.
  • Useful for comparing public resolvers quickly.

Proxy Checker

  • HTTP, HTTPS, SOCKS4, and SOCKS5 support.
  • Auto-detection or manual type selection.
  • Concurrent testing for large proxy lists.
  • Optional proxy download and scraping flows.
  • Best proxy application support.
  • Designed for speed, accuracy, and flexible workflows.

MTProto Checker

  • Telegram MTProto proxy validation.
  • Multiple input formats.
  • Latency checks.
  • Real-time valid proxy saving.
  • Public source download support.
  • Useful for checking Telegram proxy lists quickly.

Xray Config Checker

  • VLESS, VMESS, Trojan, and Shadowsocks support.
  • Transport support for WebSocket, gRPC, XHTTP, and HTTPUpgrade.
  • TLS and Reality handling.
  • Optional HTTP test URL.
  • Deduplication and GeoIP location detection.
  • Automatic alive-config export.

Cloudflare IP Scanner (New)

  • Fast default ranges: 104.16.0.0/13, 104.24.0.0/14, 172.64.0.0/13
  • Full comprehensive ranges: 22+ Cloudflare CIDR ranges including IPv6.
  • Real-time results: Live table updates as IPs are found.
  • Port scanning: Configurable port lists (default: 443, 80, 2053, 2083, 2087, 2096, 8443).
  • Automatic validation: Detects Cloudflare via headers, TLS, and server responses.
  • Protocol detection: HTTP/2, HTTP/3 support identification.
  • Latency measurement: Real-time latency tracking with color coding.
  • Concurrent workers: Configurable thread count for speed.
  • IP limits: Configurable maximum IPs per range.
  • Multiple outputs: JSON (full), CSV (spreadsheet), TXT (IP:Port).
  • Live saving: Valid IPs saved in real-time to valid_ips_YYYYMMDD_HHMMSS.txt.
  • Custom ranges: Scan specific CIDR ranges or IP files.
  • Color-coded output: Visual feedback with progress, ETA, and sorted results.

Scraper Utility

  • Add/remove sources.
  • Reload internal source config.
  • Show current config.
  • Run scraping directly.
  • Supports source-driven workflows.

Update System

  • Checks online version file.
  • Compares local and remote versions.
  • Supports Go-based install update.
  • Windows release binary fallback.
  • Git clone and build fallback when needed.

Modules

DNS Benchmark

The DNS module measures resolver responsiveness and capability. It can run simple DNS tests or extended HTTP-based validation depending on the selected mode.

Proxy Checker

The proxy module checks whether proxies are alive, what type they are, and how they perform under concurrency.

MTProto Checker

This module validates MTProto proxies and can auto-download from public sources for quick testing.

Xray Checker

This module tests Xray/V2Ray configs by starting the core and validating real connectivity.

Cloudflare Scanner (New)

This module scans Cloudflare IP ranges, validates live IPs, and provides real-time results. It supports multiple ports, concurrent workers, and various output formats. Perfect for finding working Cloudflare IPs for your projects.

Scraper

This module manages source lists and supports scraping workflow directly from inside CT.

Update Checker

This module keeps CT up to date by checking the remote version and running the best available update path.

Interactive Mode

Interactive mode is the easiest way to use CT if you do not want to remember flags.

Main menu

  • DNS Benchmark
  • Proxy Checker
  • MTProto Checker
  • Xray Checker
  • Scraper
  • Cloudflare Scanner (New)
  • Check Update
  • Exit

Interactive behavior

  • The screen is cleared at startup.
  • The banner is rendered at the top.
  • The cursor is hidden while navigating menus.
  • The menu can be used with arrow keys.
  • Number input can also be supported for quick selection.
  • Prompts only appear when relevant.

Installation

Using Go Install

go install github.com/batmanpriv/ct@v1.4.16

Build from Source

git clone https://github.com/batmanpriv/ct.git
cd ct
go build -o ct .

Windows Release

If you are on Windows and prefer a binary, download the release file from GitHub Releases.

Quick Start

DNS Benchmark

ct dns resolvers.txt

DNS with HTTP testing

ct dns resolvers.txt -mode 1 -domains "cloudflare.com,google.com,github.com"

Proxy Checking

ct proxy proxies.txt

MTProto Testing

ct mtproto mtproto.txt

Xray Testing

ct xray configs.txt

Cloudflare Scanner (New)

# Quick scan with default settings
ct cf scan

# Scan with 200 workers and custom ports
ct cf scan -workers 200 -ports 443,8443,2096

# Scan from file and sort by latency
ct cf scan -source custom:ips.txt -sort latency

# Full scan with all ranges
ct cf scan -source cloudflare_all

# Save results as CSV
ct cf scan -format csv -output scan.csv

# With speed test and geoip
ct cf scan -geoip GeoLite2-City.mmdb -speed

Scraper

ct scrape run

Update Check

ct check-update

Command Reference

DNS

ct dns [file]
ct dns apply-best
ct dns status

Proxy

ct proxy [file]
ct proxy download
ct proxy scrape
ct proxy apply-best
ct proxy set status

MTProto

ct mtproto [file]
ct mtproto download

Xray

ct xray [file]
ct xray download
ct xray add-source <url>

Scraper

ct scrape
ct scrape run
ct scrape add-source
ct scrape remove-source
ct scrape reload
ct scrape show-config

Cloudflare Scanner (New)

ct cf scan [flags]

Flags:

  • -source — IP sources: cloudflare, cloudflare_all, bgp, ipv6, or custom:file.txt
  • -workers — Number of workers (default: 100)
  • -ports — Ports to scan (comma-separated)
  • -domain — Test domain for validation
  • -output — Output file path
  • -format — Output format: json, csv, txt
  • -geoip — GeoIP database path
  • -speed — Enable speed test
  • -timeout — HTTP/TLS timeout in seconds
  • -port-timeout — Port scan timeout in seconds
  • -max — Max results to show
  • -sort — Sort by: score, latency
  • -quiet — Disable real-time output
  • -noprogress — Disable progress
  • -nocolor — Disable colors

Update

ct check-update

Cloudflare Scanner (New)

The Cloudflare scanner is a powerful tool for discovering working Cloudflare IPs. It scans ranges, validates live IPs, and provides real-time feedback.

Features

  • Fast scanning: Multi-threaded with configurable workers.
  • Real-time results: Live table updates as IPs are found.
  • Automatic validation: Detects Cloudflare via:
    • HTTP headers (CF-Ray, CF-Cache-Status)
    • TLS certificates (issuer, SAN)
    • Server responses
  • Protocol detection: HTTP/2 and HTTP/3 support.
  • Latency measurement: TCP connect latency with color coding.
  • Live saving: IPs saved to valid_ips_*.txt in real-time.
  • Multiple outputs:
    • JSON: Full details (40+ fields)
    • CSV: Spreadsheet format
    • TXT: Simple IP:Port list
  • Custom ranges: Scan specific CIDR ranges.
  • IP files: Scan IPs from a text file.
  • Cloudflare detection: Identifies Cloudflare IPs with high accuracy.
  • Color-coded: Beautiful terminal output with progress and ETA.

Default Ranges

Fast scan (default):

  • 104.16.0.0/13
  • 104.24.0.0/14
  • 172.64.0.0/13

Comprehensive scan (cloudflare_all):

  • All 22+ Cloudflare IPv4 and IPv6 ranges.

Example Output

╔════════════════════════════════════════════════════════════════════════════╗
║                     Cloudflare Scanner - Top 20 Valid IPs                  ║
╠════════════════════════════════════════════════════════════════════════════╣
║ Progress:   44.4%  Alive:     1  Dead:    39  H3:    1  ETA:       39s     ║
╠════════════════════════════════════════════════════════════════════════════╣
║ #1  104.16.0.23     :2087  Score: 75  Lat: 177.24ms  CF:✓ H2:✓ H3:✓        ║
╚════════════════════════════════════════════════════════════════════════════╝

Scoring System

  • 10 pts: IP is alive
  • 25 pts: Cloudflare confirmed
  • 10 pts: HTTP/2 supported
  • 15 pts: HTTP/3 supported
  • Up to 20 pts: Low latency (<30ms)
  • Up to 10 pts: No packet loss
  • Up to 10 pts: High speed

Total score: 0-100

Color Legend

  • Latency: Green (<150ms), Yellow (150-300ms), Red (>300ms)
  • Score: Green (≥70), Yellow (40-69), Red (<40)
  • CF/H2/H3: Green (✓ supported), Red (✗ not supported)

Input Formats

DNS Server List

1.1.1.1
8.8.8.8
9.9.9.9
[2001:4860:4860::8888]:53

Proxy List

http://user:pass@host:port
https://host:port
socks5://host:port
socks4://host:port
host:port

MTProto List

https://t.me/proxy?server=example.com&port=443&secret=...
tg://proxy?server=example.com&port=443&secret=...
server=example.com port=443 secret=...
example.com 443 secret

Xray Config List

vless://...
vmess://...
trojan://...
ss://...

Cloudflare IP File

# IPs or CIDR ranges, one per line
104.16.0.1
104.16.0.0/13
172.64.0.0/13

Output Files

DNS

  • Valid resolver lists.
  • Optional JSON results.

Proxy

  • Valid proxies saved by module logic.

MTProto

  • valid_mtproto.txt

Xray

  • alive_configs.txt

Cloudflare Scanner

  • valid_ips_YYYYMMDD_HHMMSS.txt — Real-time IP:Port list
  • {user-defined}.json — Full details (40+ fields)
  • {user-defined}.csv — Spreadsheet format
  • {user-defined}.txt — IP:Port list

Scraper

  • Config and scraped output files in output/

Scraper System

The scraper module is one of the most useful additions in this version. It gives you direct control over the source list instead of relying only on static defaults.

What it can do

  • Add a source URL.
  • Remove a source URL.
  • Reload the internal default config.
  • Show current source settings.
  • Run scraping immediately.

Example flow

ct scrape

Inside the menu, you can:

  • add a new source,
  • remove a broken source,
  • reload defaults,
  • inspect the active config,
  • or run the scraper.

Direct run

ct scrape run

This is useful when you want the scraper to execute immediately without opening the source management menu.

Update System

CT now includes a built-in update workflow.

Update process

  1. Read the latest version from the remote version file.
  2. Compare it with the local VERSION.
  3. If the versions differ:
    • try go install github.com/batmanpriv/ct@vX.Y.Z,
    • if Go is unavailable and the platform is Windows, download the release binary,
    • if that fails too, clone the repository and build from source.

Why this matters

This gives users multiple recovery paths:

  • Go users get the easiest update flow.
  • Windows users get a binary fallback.
  • Everyone else gets a source-build fallback.

Performance

CT uses concurrency heavily to keep testing fast.

General notes

  • DNS, proxy, MTProto, Xray, and Cloudflare checks all use worker-based execution.
  • Smart defaults reduce manual overhead.
  • Cached and fallback-based flows reduce repeated work.
  • Interactive prompts avoid asking for unnecessary values.
  • Source operations are designed to be simple and responsive.

Cloudflare Scanner Performance

  • 100 workers: Scans ~1000 IPs per second.
  • Configurable workers: Increase for faster scans.
  • Real-time updates: Results appear instantly.
  • Live saving: No data loss if interrupted.
  • Smart timeout handling: Configurable per-port timeouts.

Troubleshooting

Build issues

If go build fails:

  • Make sure VERSION is declared as a string.
  • Make sure config structs match the fields used in the code.
  • Remove unused variables or wire them into the config properly.
  • Check for duplicate prompts or mismatched prompt logic.

Interactive issues

If the menu feels broken:

  • Make sure the terminal supports ANSI colors.
  • Check that the cursor is restored on exit.
  • Use arrow keys or numeric selection as supported by the UI.

Update issues

If update fails:

  • Confirm Go is installed.
  • Confirm Git is installed.
  • On Windows, ensure release downloads are allowed.
  • If all else fails, use the source clone/build path manually.

Scraper issues

If source actions do not work:

  • Confirm the source URL is valid.
  • Confirm the config reloads successfully.
  • Use show-config to verify what is currently active.

Cloudflare Scanner issues

If scanner fails:

  • Increase timeout values: -timeout 10 -port-timeout 5
  • Reduce workers: -workers 50
  • Check network connectivity.
  • Use custom ranges for targeted scanning.

Project Structure

ct/
├── main.go
├── go.mod
├── go.sum
├── pc/
├── mtp/
├── xp/
├── scraper/
├── cf/              # New Cloudflare scanner module
├── output/

Changelog

1.4.15

  • Added Cloudflare IP Scanner module — Complete IP scanning solution.
  • Added real-time scanning with live table updates.
  • Added automatic Cloudflare validation.
  • Added HTTP/2 and HTTP/3 detection.
  • Added latency measurement with color coding.
  • Added real-time IP saving to valid_ips_*.txt.
  • Added multiple output formats (JSON, CSV, TXT).
  • Added custom range and IP file support.
  • Added optional GeoIP and speed test features.
  • Added interactive menu integration.
  • Added comprehensive command-line flags.
  • Improved color-coded terminal output.
  • Improved progress tracking with ETA.

1.3.12

  • Added improved interactive menu UX.
  • Added numeric support for menu selection.
  • Added conditional prompts in modules.
  • Added scraper source management menu.
  • Added scrape run direct execution.
  • Added built-in update checker.
  • Added multi-path update fallback.
  • Improved defaults and prompt logic.
  • Improved source management workflow.
  • Improved overall usability.

1.3.9

  • Stable CLI improvements.
  • Existing module support and testing workflow.

License

MIT License.

Support

CT — Check Test

Documentation

The Go Gopher

There is no documentation for this package.

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.