Skip to content

Code-Leafy/NetLeafyScanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 

Repository files navigation

NetLeafy Scanner

Advanced IP + SNI discovery engine for high-speed VLESS configurations.

Version Python License Status


Typing animation
NetLeafy Preview


Overview

NetLeafy Scanner is a massively parallel IP/SNI discovery tool designed to identify working Cloudflare edge nodes and clean SNI domains. It uses a 2-stage verification process to validate both TLS handshakes and HTTP response codes, ensuring zero fake-positive results.

Note: Designed to work perfectly alongside the NetLeafy Web Tool. Scan, copy your results, and generate your optimized config instantly.


Core Features

⚡ Parallel Probing Engine

Capable of running up to 150 concurrent threads. Scans thousands of IP/SNI combinations in seconds without compromising accuracy.

📱 Mobile & Termux Optimized

Includes native support for termux-wake-lock and specialized low-RAM performance profiles to prevent crashes on Android devices.

🛡️ 2-Stage Smart Filtering

Drops blocked, reset, or DPI-injected responses automatically. It strictly validates the HTTP code and total connect time to ensure the highest stability.

🔄 Auto-Best Mode

A fully automated sequence: Pings all IPs → Scans working pairs → Performs a 3-probe stability test → Outputs the absolute fastest results.


Getting Started

Prerequisites: Python 3.7+, cURL (pre-installed on most OS).

# Clone the repository
git clone https://github.com/Code-Leafy/NetLeafyScanner.git

# Navigate to the folder
cd NetLeafyScanner

# Launch the scanner
python3 scanner.py
🖥️ OS Specific Instructions

Windows: Install Python from python.org, then run python scanner.py in PowerShell or CMD.

Termux (Android):

pkg update && pkg install python curl git
python scanner.py

Usage

NetLeafy Scanner features a beautiful CLI menu. Choose a performance profile based on your hardware:

  • 1 Low-End Mobile — 15 threads / 6s timeout
  • 3 Desktop — 60 threads / 3s timeout
  • 4 Server/High-End PC — 120 threads / 2s timeout

🚀 Config Optimization: After the scan, take your results to NetLeafy. Select the G2ray server option and paste your config there to complete your setup.


Output

Results are auto-saved with timestamps to your Downloads folder (or current directory):

NetLeafyScanner/
├── last_scan.json           # Cached results for stability checking
└── NetLeafy_auto_best.txt    # Sorted results (IP | SNI | Latency)
📊 Scanner Database Stats
  • IPs in Database: 130+ Verified CDN Nodes
  • SNIs in Database: 70+ Clean Domains
  • Total Combinations: ~9,100 per full scan

Architecture

graph LR
    A[Scanner] -->|Massive Threading| B[cURL Probe]
    B -->|TLS Handshake| C{Valid?}
    C -->|Yes| D[HTTP Code Check]
    D -->|Code 200/OK| E[Stability Test]
    E -->|Fastest| F[Final Result File]
Loading

FAQ & Troubleshooting

Why am I getting "cURL Requirement Failed"? Ensure curl is in your system PATH. On Linux/Termux, run apt install curl. On Windows, recent versions have it built-in.

What is "Shecan Bypass Mode"? It uses specific DNS servers (178.22.122.101) to bypass regional restrictions during the SNI lookup phase.


⚠️ Educational Purpose Only: This project is intended for network research and educational use. Users are responsible for following local regulations.

MIT License · Crafted by Code-Leafy · Telegram Channel


About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages