How xtls/realitlscanner works
RealiTLScanner is a command-line TLS scanner. Its workflow selects one target source (address, file, or URL), turns targets into hosts, scans them concurrently, enriches successful TLS results with optional GeoIP, and writes CSV output. The sampled source shows the main orchestration and core scan path; URL crawling is implemented inline in main.go, so it is represented as a distinct responsibility at that path.
Main entry points: main.go CLI Orchestrator · scanner.go TLS Scanner · geo.go GeoIP Lookup · utils.go Address Iterator
Components 17
Target Inputs
- Address Input
- Target File
- URL Page
- URL Crawler
main.go - Target Parser
utils.go - Address Iterator
utils.go
Scan Runtime
- CLI Orchestrator
main.go - DNS Lookup
utils.go - Scan Workers
main.go - TLS Scanner
scanner.go - GeoIP Lookup
geo.go
Results
- Result Channel
utils.go - Output Writer
utils.go - CSV Output
- MaxMind Database
Other components
- Operator
- TLS Targets
Connections 19
- Operator → CLI Orchestrator: configures
README.md - Address Input → CLI Orchestrator: selects
main.go - Target File → CLI Orchestrator: selects
main.go - URL Page → URL Crawler: fetches
main.go - CLI Orchestrator → URL Crawler: runs
main.go - CLI Orchestrator → Address Iterator: enumerates
main.go - CLI Orchestrator → Target Parser: parses
main.go - URL Crawler → Target Parser: passes domains
main.go - Address Iterator → DNS Lookup: resolves
utils.go - Scan Workers → TLS Scanner: dispatches hosts
main.go - CLI Orchestrator → Scan Workers: starts workers
main.go - TLS Scanner → DNS Lookup: resolves domains
scanner.go - TLS Scanner → TLS Targets: dials and handshakes
scanner.go - TLS Scanner → GeoIP Lookup: looks up country
scanner.go - CLI Orchestrator → GeoIP Lookup: initializes
main.go - MaxMind Database → GeoIP Lookup: provides country data
geo.go - CLI Orchestrator → Output Writer: creates
main.go - TLS Scanner → Result Channel: sends CSV rows
scanner.go - Output Writer → CSV Output: writes rows