🚀 Antigravity IP Scanner

Advanced Cloudflare IP Optimization & Censorship Bypass Tool

---

🇮🇷 فارسی (Persian) — کلیک کنید

اسکنر آی‌پی آنتی‌گرویتی

ابزار حرفه‌ای برای کشف و بهینه‌سازی آی‌پی‌های کلادفلر و دور زدن سانسور اینترنت.

✨ ویژگی‌ها

• 📡 تست پینگ، جیتر و سرعت دانلود/آپلود واقعی
• 🧩 آنالیز فرگمنت DPI و SNI فرانتینگ
• 📡 اسکنر نقاط WARP (وایرگارد/UDP)
• 🌍 نقشه حرارتی جهانی با آمار لحظه‌ای
• 🔒 تأیید TLS سخت (ضد حمله وسط)
• 🏆 سیستم آی‌پی طلایی هوشمند
• 🌐 پشتیبانی چندزبانه (انگلیسی، فارسی، روسی)

🚀 شروع سریع

git clone https://github.com/tayden1990/CF-IP-Scanner.git
cd CF-IP-Scanner
pip install -r backend/requirements.txt
python run_app.py

📱 ارتباط

• 🤖 ربات تلگرام: @antigravity_ip_bot
• 💬 گروه تلگرام: @ANTIGRAVITY_IP
• 👨‍💻 توسعه‌دهنده: @tayden2023

🇷🇺 Русский (Russian) — Нажмите

Antigravity IP Сканер

Профессиональный инструмент для поиска и оптимизации IP-адресов Cloudflare и обхода интернет-цензуры.

✨ Возможности

• 📡 Тестирование пинга, джиттера и реальной скорости загрузки/выгрузки
• 🧩 Анализатор DPI-фрагментации и SNI-фронтинг
• 📡 Сканер точек WARP (Wireguard/UDP)
• 🌍 Глобальная тепловая карта со статистикой в реальном времени
• 🔒 Строгая проверка TLS (защита от MITM)
• 🏆 Умная система золотых IP
• 🌐 Мультиязычная поддержка (EN, FA, RU)

🚀 Быстрый старт

git clone https://github.com/tayden1990/CF-IP-Scanner.git
cd CF-IP-Scanner
pip install -r backend/requirements.txt
python run_app.py

📱 Связь

• 🤖 Telegram бот: @antigravity_ip_bot
• 💬 Telegram группа: @ANTIGRAVITY_IP
• 👨‍💻 Разработчик: @tayden2023

---

📸 Screenshots

🔍 Scanner — Main Interface

The main scanner with VLESS configuration, IP source selection, and one-click auto scan

---

🌍 Global Analytics — World Heatmap

Real-time global network health map with country-level statistics

---

🧩 Advanced Bypasses — DPI & SNI

Multi-vector DPI bypassing with fragment analysis and SNI fronting

---

📡 WARP Endpoints — Wireguard Scanner

Hunt for Cloudflare WARP UDP/TCP endpoints for full-device VPN tunnels

---

ℹ️ About App — Documentation

Built-in guide, FAQ, system requirements, and privacy policy

---

✨ Features

Feature	Description
🔍 IP Scanner	Discover clean Cloudflare Edge IPs with real ping, jitter, download & upload speed tests
⚡ Fastly CDN	Full native support for scanning Fastly Edge networks alongside Cloudflare
🏆 Gold IPs	Smart history + community-verified IPs + auto top-domain discovery
👥 Community Gold	IPs verified by other users in your region — shared intelligence
🧩 DPI Fragment Analyzer	Test every length/interval permutation to bypass Deep Packet Inspection
🛡️ DNSTT & Split-Stream	Dedicated beta scanner for SlowDNS encapsulation and TLS split packets
🌐 SNI Fronting	Scan hundreds of SNIs against a working IP to find unblocked routes
📡 WARP Scanner	Find functional WARP UDP endpoints for Wireguard-based VPN tunnels
🗺️ Global Heatmap	Interactive world map with country-level scan analytics
🔒 TLS Verification	Anti-MITM certificate validation for Cloudflare connections
⚡ TCP Pre-Filter	Blazing-fast 1000ms dead-IP drop before heavy Xray scanning begins
💾 Persistent Queue	Pure SQLite async queue ensures scans survive app restarts
🔄 Smart Retry	Auto-relaxes thresholds if strict settings find nothing
📊 Real-time Analytics	Live charts for datacenter latency, port success, and network protocols
🌐 Multi-Language	Full UI in English 🇬🇧, فارسی 🇮🇷, and Русский 🇷🇺
📱 Deep Links	One-click export to V2RayNG, Hidify, V2Box, Clash Meta, Sing-box
🌐 DNS Override	Route DNS queries through encrypted DoH/DoT servers to bypass ISP poisoning
🍎 macOS Support	Native DMG installer for macOS alongside Windows EXE

---

🚀 Quick Start

Supported Platforms

Platform	Status	Install
🪟 Windows 10/11	✅ Full Support	Download .exe from Releases
🍎 macOS	✅ Full Support	Download .dmg from Releases
🐧 Linux	✅ Manual Setup	See LINUX_INSTALL.md
📱 Termux (Android)	⚠️ Experimental	Termux Guide

Prerequisites

• Python 3.10+
• Node.js 18+ (for development)
• Internet connection

Installation

# Clone the repository
git clone https://github.com/tayden1990/CF-IP-Scanner.git
cd CF-IP-Scanner

# Install Python dependencies
pip install -r backend/requirements.txt

# Run the application
python run_app.py

The app will open at http://localhost:5173 with the backend API on port 8000.

Development Mode

# Frontend (Terminal 1)
cd frontend
npm install
npm run dev

# Backend (Terminal 2)
cd backend
python main.py

Build Desktop App

# Build Electron executable
npm run build
npm run dist

---

🏗️ Architecture

CF-IP-Scanner/
├── backend/                 # Python FastAPI backend
│   ├── main.py             # API server & routes
│   ├── scanner.py          # Core IP scanning engine
│   ├── advanced_scanner.py # DPI fragment & SNI scanner
│   ├── warp_scanner.py     # WARP endpoint scanner
│   ├── db.py               # MySQL/MariaDB connection
│   ├── analytics.py        # Global analytics aggregation
│   └── xray_core/          # Bundled Xray-core binary
├── frontend/                # React + Vite frontend
│   ├── src/
│   │   ├── App.jsx         # Main application
│   │   ├── components/     # UI components
│   │   │   ├── ConfigInput.jsx
│   │   │   ├── ResultsTable.jsx
│   │   │   ├── AnalyticsDashboard.jsx
│   │   │   ├── WorldHeatmap.jsx
│   │   │   ├── AdvancedScanners.jsx
│   │   │   ├── WarpScanner.jsx
│   │   │   ├── HealthWidget.jsx
│   │   │   ├── AboutBox.jsx
│   │   │   └── LanguageSwitcher.jsx
│   │   └── i18n/           # Internationalization
│   │       ├── LanguageContext.jsx
│   │       ├── en.json     # English
│   │       ├── fa.json     # فارسی (Persian)
│   │       └── ru.json     # Русский (Russian)
│   └── public/
│       └── logo.png
├── docs/
│   └── screenshots/        # App screenshots
├── main.js                  # Electron main process
├── run_app.py              # One-click launcher
├── LICENSE                  # GNU AGPLv3 License
├── CITATION.cff            # Citation metadata
└── README.md               # This file

---

🌐 Internationalization (i18n)

Antigravity supports 3 languages with automatic font switching:

Language	Code	Font	Direction
🇬🇧 English	en	Inter	LTR
🇮🇷 فارسی	fa	Vazirmatn	RTL
🇷🇺 Русский	ru	Nunito	LTR

Adding a New Language

1. Duplicate frontend/src/i18n/en.json → xx.json
2. Translate all ~250 keys
3. Import in LanguageContext.jsx:

   import xx from './xx.json';
   const locales = { en, fa, ru, xx };

4. Add to LANGUAGES array:

   { code: 'xx', name: 'Language', flag: '🏳️' }

---

🔧 Configuration

IP Sources

Source	Description
Official Cloudflare	Random IPs from Cloudflare's published ranges
Smart History	Previously successful IPs for your specific ISP
Gold IPs	Smart History + auto-scraped top domains for your country
Community Gold	Best IPs verified by any user in your geographic region
Auto-Scrape	Clean IPs from community GitHub lists
Custom URL	Your own private IP list

Strictness Profiles

Profile	Max Ping	Max Jitter	Min Download	Min Upload
🛡️ Minimum	1500ms	800ms	0.1 Mbps	0.1 Mbps
⚖️ Average	600ms	300ms	2 Mbps	0.5 Mbps
⚡ Hard	300ms	100ms	10 Mbps	2 Mbps

---

🔒 Privacy & Security

• ✅ VLESS configs are NEVER uploaded — they stay 100% local
• ✅ Scan results (IP, ping, speed) are optionally shared to help the community
• ✅ All tests route through Cloudflare's own infrastructure
• ✅ Your public IP is detected via ip-api.com solely for ISP matching
• ✅ No analytics trackers, no ads, no telemetry — fully open source
• ✅ Optional TLS certificate validation prevents MITM attacks

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

# Fork & clone
git clone https://github.com/YOUR_USERNAME/CF-IP-Scanner.git

# Create a feature branch
git checkout -b feature/amazing-feature

# Make your changes & commit
git commit -m "feat: add amazing feature"

# Push & create a Pull Request
git push origin feature/amazing-feature

---

📜 License

This project is licensed under the GNU AGPLv3 License — see the LICENSE file for details.

---

📖 Citation

If you use this tool in your research, please cite it:

@software{antigravity_ip_scanner,
  author = {Akbari Saeed, Taher},
  title = {Antigravity IP Scanner: Advanced Cloudflare IP Optimization \& Censorship Bypass Tool},
  year = {2024},
  url = {https://github.com/tayden1990/CF-IP-Scanner},
  license = {MIT}
}

---

👨‍💻 Author & Contact

👤 Name	Taher Akbari Saeed
📧 Email	taherakbarisaeed@gmail.com
🐙 GitHub	@tayden1990
✈️ Telegram	@tayden2023
🆔 ORCID	0000-0002-9517-9773

---

🌟 Community

• ⭐ Star this repo — Support open-source internet freedom
• 🤖 Telegram Bot — Get free VPN configs instantly
• 💬 Telegram Group — Join the community, share feedback

---

🕊️ Built for a free and open internet

_{Antigravity IP Scanner v2.5 • © 2024-2026 Taher Akbari Saeed • GNU AGPLv3 License}