# XTLS/RealiTLScanner

A TLS server scanner for Reality

Repository: https://github.com/XTLS/RealiTLScanner
Canonical: https://ross.abutalabs.com/products/realitlscanner
Language: Go
License: MPL-2.0
License Family: copyleft
Last push: 2026-05-30T01:36:49+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 84, release rhythm 86, longevity 91
- inputs: {"age_days": 1277, "days_push": 96, "days_rel": 96, "gap_med": 4, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4286, forks 306 (observed 2026-08-28T04:08:41.268146+00:00)

## What it is
A Go-based TLS server scanner built for the XTLS Reality protocol ecosystem. It scans IP ranges, CIDRs, domains, or target lists to find TLS servers (with certificate domains, issuers, ALPN, and optional GeoIP data) suitable as Reality proxy targets.

## Use cases
- find suitable TLS handshake targets for XTLS Reality
- scan an IP range for TLS 1.3 servers
- discover certificate domains behind an IP address
- crawl a URL for domains and scan their TLS servers
- export TLS scan results to CSV
- check which servers support TLS 1.3 and h2 ALPN

## When to choose
- you are setting up XTLS Reality and need to find suitable dest/SNI targets
- you need a fast, multithreaded TLS scanner with CSV output and GeoIP support
- you want a self-contained Go binary or Docker image with no runtime dependencies

## When to avoid
- you need a general-purpose vulnerability scanner rather than TLS target discovery
- you cannot run scans locally - cloud VPS scanning may get the server flagged
- you need a GUI or managed service rather than a command-line tool

## Facets
- artifact type: cli-tool
- maturity: active
- function: security, networking, cli
- domain: security, networking, censorship-circumvention
- platform: windows, cli, go
- tags: tls-scanner, reality-protocol, xray, proxy, certificate-scanning, geoip, command-line, linux, macos, docker

## Member repositories
- XTLS/RealiTLScanner (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:41.268146+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:21:56.542968+00:00, confidence not recorded.
  - readme: https://github.com/XTLS/RealiTLScanner (fetched 2026-08-28T04:08:41.268146+00:00, sha a729656fa55e)
- Data as of 2026-08-30T08:39:29.467469+00:00.