scan

Scan candidate IPs for TCP reachability and persist results.

xrat scan [flags]

Flags

Flag	Description
`--ips <ips>`	Comma-separated IPs to scan, e.g. `1.1.1.1,8.8.8.8`
`--file <path>`	Read newline-separated IPs from a file
`--port <port>`	Target TCP port (default: `443`)
`--timeout <ms>`	TCP connect timeout in milliseconds (default: `4000`)
`--history <limit>`	Print the latest N persisted scan results and exit (skips scanning)

Examples

Scan specific IPs:

xrat scan --ips 1.1.1.1,8.8.8.8,9.9.9.9

Scan from a file:

xrat scan --file ./candidate-ips.txt

Scan on a custom port with shorter timeout:

xrat scan --ips 1.1.1.1,8.8.8.8 --port 8443 --timeout 2000

View scan history:

xrat scan --history 20

Behavior

Reads candidate IPs from --ips or --file
Attempts TCP connection to each IP on the specified port
Measures connection latency
Persists results to the cf_scan_results table (upsert)
Prints scan results with latency and success/failure status

Use Cases

Cloudflare IP scanning: Test candidate Cloudflare edge IPs for low latency
CDN endpoint testing: Identify fast CDN nodes in your region
Network reconnaissance: Discover reachable IPs in a range

Output

IP              Port    Latency    Status
1.1.1.1         443     12ms       reachable
8.8.8.8         443     15ms       reachable
9.9.9.9         443     -          timeout

Persistence

Results are persisted to the database and can be retrieved with --history. This allows tracking IP reachability over time and identifying consistently fast endpoints.

test — test stored proxy configs (not raw IPs)

Keyboard shortcuts