How pxzya/v2scan works
V2Scan is a desktop scanner for Telegram-sourced proxy and VPN share links. The user selects a public channel or subscription, optionally configures discovery through a SOCKS proxy, and starts a scan; the backend retrieves and extracts links, tests config endpoints, enriches results with country flags, and streams results to the interface for display or export. Saved channels persist locally. The README provides only the product name, so this map relies on the sampled source descriptions and excerpts; some wiring beyond those excerpts is omitted.
Main entry points: api.py Scan API · scraper.py Channel scraper · app.js Scan interface · subscriptions.py Subscription fetcher
Components 16
Desktop interface
- Webview host
main.py - Scan interface
gui/app.js
Scan workflow
- Scan API
api.py - TCP config tester
tester.py
Sources and parsing
- Channel scraper
scraper.py - Subscription fetcher
subscriptions.py - Config parser
parser.py - Telegram proxy parser
proxy_links.py
State and enrichment
- Country lookup
geo.py - Saved channels
channels_store.py
Other components
- User
- Telegram web preview
- Subscription URL
- Discovery proxy
- Config servers
- IP geolocation API
Connections 20
- User → Scan interface: configures and starts
- Webview host → Scan interface: loads
- Scan interface → Scan API: invokes scan and channel actions
- Scan API → Scan interface: dispatches scan events
- Scan API → Saved channels: manages saved channels
- Scan API → Channel scraper: scrapes channel
- Scan API → Subscription fetcher: fetches subscription
- Scan API → Telegram proxy parser: parses discovery proxy
- Scan API → TCP config tester: tests configs
- Scan API → Country lookup: looks up hosts
- Channel scraper → Telegram web preview: fetches public pages
- Channel scraper → Config parser: extracts configs
- Channel scraper → Telegram proxy parser: extracts proxy links
- Subscription fetcher → Subscription URL: fetches content
- Subscription fetcher → Config parser: extracts configs
- Subscription fetcher → Telegram proxy parser: extracts proxy links
- Channel scraper → Discovery proxy: routes discovery requests
- TCP config tester → Config servers: opens TCP connections
- Country lookup → IP geolocation API: submits host lookups
- Scan interface → Scan API: requests valid-config export