업데이트로 돌아가기
New releaseSep 9, 2026

tlsx v1.4.0

TLS 기반 데이터 수집에 중점을 둔 빠르고 구성 가능한 TLS 그래버.

공유


기능 • 설치 • 사용법 • tlsx 실행 • Discord 참여

TLS 기반 데이터 수집 및 분석에 초점을 맞춘 빠르고 구성 가능한 TLS 그래버입니다.

기능

image

  • 빠르고 완전히 구성 가능한 TLS 연결
  • 다양한 TLS 연결 모드
  • 다양한 TLS 프로브
  • 구버전 TLS 버전을 위한 자동 TLS 폴백
  • 사전 핸드셰이크 TLS 연결 (조기 종료)
  • 사용자 정의 가능한 Cipher / SNI / TLS 선택
  • JARM/JA3 TLS 지문
  • TLS 잘못된 구성
  • ASN, CIDR, IP, HOST, 및 URL 입력
  • STD IN/OUT 및 TXT/JSON 출력

설치

tlsx를 성공적으로 설치하려면 Go 1.27.3이 필요합니다. 설치하려면 아래 명령을 실행하거나 릴리스 페이지에서 미리 컴파일된 바이너리를 다운로드하세요.

go install github.com/projectdiscovery/tlsx/cmd/tlsx@latest

사용법

tlsx -h

이것은 도구에 대한 도움말을 표시합니다. 지원하는 모든 스위치는 다음과 같습니다.

TLSX is a tls data gathering and analysis toolkit.

Usage:
  tlsx [flags]

Flags:
INPUT:
   -u, -host string[]  target host to scan (-u INPUT1,INPUT2)
   -l, -list string    target list to scan (-l INPUT_FILE)
   -p, -port string[]  target port to connect (default 443)

SCAN-MODE:
   -sm, -scan-mode string     tls connection mode to use (ctls, ztls, openssl, auto) (default "auto")
   -ps, -pre-handshake        enable pre-handshake tls connection (early termination) using ztls
   -sa, -scan-all-ips         scan all ips for a host (default false)
   -iv, -ip-version string[]  ip version to use (4, 6) (default 4)

PROBES:
   -san                     display subject alternative names
   -cn                      display subject common names
   -so                      display subject organization name
   -tv, -tls-version        display used tls version
   -cipher                  display used cipher
   -hash string             display certificate fingerprint hashes (md5,sha1,sha256)
   -jarm                    display jarm fingerprint hash
   -ja3                     display ja3 fingerprint hash (using ztls)
   -wc, -wildcard-cert      display host with wildcard ssl certificate
   -tps, -probe-status      display tls probe status
   -ve, -version-enum       enumerate and display supported tls versions
   -ce, -cipher-enum        enumerate and display supported cipher
   -ct, -cipher-type value  ciphers types to enumerate. possible values: all/secure/insecure/weak (comma-separated) (default all)
   -ch, -client-hello       include client hello in json output (ztls mode only)
   -sh, -server-hello       include server hello in json output (ztls mode only)
   -se, -serial             display certificate serial number

MISCONFIGURATIONS:
   -ex, -expired      display host with host expired certificate
   -ss, -self-signed  display host with self-signed certificate
   -mm, -mismatched   display host with mismatched certificate
   -re, -revoked      display host with revoked certificate
   -un, -untrusted    display host with untrusted certificate

CONFIGURATIONS:
   -config string               path to the tlsx configuration file
   -r, -resolvers string[]      list of resolvers to use
   -cc, -cacert string          client certificate authority file
   -ci, -cipher-input string[]  ciphers to use with tls connection
   -sni string[]                tls sni hostname to use
   -rs, -random-sni             use random sni when empty
   -rps, -rev-ptr-sni           perform reverse PTR to retrieve SNI from IP
   -min-version string          minimum tls version to accept (ssl30,tls10,tls11,tls12,tls13)
   -max-version string          maximum tls version to accept (ssl30,tls10,tls11,tls12,tls13)
   -cert, -certificate          include certificates in json output (PEM format)
   -tc, -tls-chain              include certificates chain in json output
   -vc, -verify-cert            enable verification of server certificate
   -ob, -openssl-binary string  OpenSSL Binary Path
   -hf, -hardfail               strategy to use if encountered errors while checking revocation status
   -proxy string                socks5 proxy to use for tlsx

OPTIMIZATIONS:
   -c, -concurrency int  number of concurrent threads to process (default 300)
   -cec, -cipher-concurrency int  cipher enum concurrency for each target (default 10)
   -timeout int          tls connection timeout in seconds (default 5)
   -retry int            number of retries to perform for failures (default 3)
   -delay string         duration to wait between each connection per thread (eg: 200ms, 1s)

UPDATE:
   -up, -update                 update tlsx to latest version
   -duc, -disable-update-check  disable automatic tlsx update check

OUTPUT:
   -o, -output string  file to write output to
   -j, -json           display output in jsonline format
   -dns                display unique hostname from SSL certificate response
   -ro, -resp-only     display tls response only
   -silent             display silent output
   -nc, -no-color      disable colors in cli output
   -v, -verbose        display verbose output
   -version            display project version

PDCP:
   -pd, -dashboard              upload or view output in the PDCP UI dashboard
   -pdu, -dashboard-upload string  upload tlsx output file (JSONL format) to the PDCP UI dashboard
   -auth string                  PDCP API key for authentication
   -tid, -team-id string         upload asset results to a specified team ID
   -aid, -asset-id string        upload new assets to an existing asset ID
   -aname, -asset-name string    asset group name

DEBUG:
   -health-check, -hc  run diagnostic check up

라이브러리로 tlsx 사용하기

tlsx를 라이브러리로 사용하는 예제는 examples 폴더에 제공되어 있습니다.

tlsx 실행하기

tlsx 입력

tlsx는 TLS 연결을 위해 ip를 필요로 하며, 아래 나열된 여러 형식을 입력으로 받습니다:

AS1449 # ASN input
173.0.84.0/24 # CIDR input
93.184.216.34 # IP input
example.com # DNS input
example.com:443 # DNS input with port
https://example.com:443 # URL input port

입력 호스트는 -host / -u 플래그를 사용하여 제공할 수 있으며, 쉼표로 구분된 입력을 통해 여러 값을 제공할 수 있고, 마찬가지로 파일 입력은 -list / -l 플래그를 사용하여 지원됩니다.

쉼표로 구분된 호스트 입력 예시:

$ tlsx -u 93.184.216.34,example.com,example.com:443,https://example.com:443 -silent

파일 기반 호스트 입력의 예:

$ tlsx -list host_list.txt

포트 입력:

tlsx는 기본적으로 포트 443에 연결하며, -port / -p 플래그를 사용하여 사용자 지정할 수 있습니다. 단일 또는 여러 포트는 쉼표로 구분된 입력 또는 연결할 포트 목록이 포함된 줄바꿈으로 구분된 파일을 사용하여 지정할 수 있습니다.

쉼표로 구분된 포트 입력의 예:

$ tlsx -u hackerone.com -p 443,8443

파일 기반 포트 입력 예시:

$ tlsx -u hackerone.com -p port_list.txt

참고:

입력 호스트에 포트가 포함된 경우, 예를 들어 8.8.8.8:443 또는 hackerone.com:8443과 같이, 호스트와 함께 지정된 포트가 기본 포트나 -port / -p 플래그로 제공된 포트 대신 TLS 연결을 설정하는 데 사용됩니다.

TLS 프로브 (기본 실행)

이것은 주어진 CIDR 범위에 대해 도구를 실행하고 포트 443에서 TLS 연결을 허용하는 호스트를 반환합니다.

카테고리