How 0xradikal/free-v2ray-configs works
Free V2Ray Configs aggregates public proxy configurations, filters and tests candidates, then publishes subscription formats and health/index metadata; users import those feeds into a client, while a live dashboard presents repository data. The graph preserves the documented verification, conversion, geographic, and dashboard branches. Some implementation details are unsampled, so edges are limited to shown imports/calls or README statements.
Main entry points: aggregate.py Aggregation · pipeline.py Cascade coordinator · App.tsx Dashboard application · countries.py Country feeds
Components 22
Collection and processing
- Aggregation
scripts/aggregate.py - Source catalog
scripts/sources.py - Config engine
scripts/core.py - GeoIP enrichment
scripts/geo.py
Verification cascade
- Cascade coordinator
scripts/pipeline.py - Structural filters
scripts/filters.py - TCP reachability
scripts/reachability.py - Proxy request tests
scripts/realtest.py
Feeds and metadata
- Config converters
scripts/converters.py - Mihomo compatibility
scripts/mihomo_compat.py - Country feeds
scripts/countries.py - Run state
scripts/state.py - Output validation
scripts/validate.py - Published subscriptions
all - Health metadata
health.json - Feed index
index.json
Live dashboard
- Dashboard application
dashboard-src/src/App.tsx - Dashboard sections
dashboard-src/src/sections.tsx - JSON fetch and mirrors
dashboard-src/src/lib/fetchJson.ts
Other components
- Pipeline maintainer
- Public config sources
- V2Ray clients
Connections 26
- Pipeline maintainer → Aggregation: initiates
- Public config sources → Aggregation: provides configs
- Aggregation → Source catalog: uses sources
scripts/aggregate.py - Aggregation → Config engine: parses and deduplicates
scripts/aggregate.py - Config engine → GeoIP enrichment: looks up location
scripts/core.py - Aggregation → GeoIP enrichment: enriches endpoints
scripts/aggregate.py - Cascade coordinator → Structural filters: runs filtering
scripts/pipeline.py - Cascade coordinator → TCP reachability: runs TCP checks
scripts/pipeline.py - Cascade coordinator → Proxy request tests: runs request tests
scripts/pipeline.py - Structural filters → Config converters: parses configs
scripts/filters.py - Cascade coordinator → Config converters: uses conversions
scripts/pipeline.py - Aggregation → Config converters: converts outputs
scripts/aggregate.py - Aggregation → Mihomo compatibility: checks compatibility
scripts/aggregate.py - Aggregation → Run state: uses run state
scripts/aggregate.py - Cascade coordinator → Country feeds: uses country feeds
scripts/pipeline.py - Country feeds → Config engine: uses config engine
scripts/countries.py - Country feeds → GeoIP enrichment: resolves countries
scripts/countries.py - Aggregation → Published subscriptions: writes feed formats
scripts/aggregate.py - Aggregation → Feed index: builds feed index
scripts/aggregate.py - Aggregation → Health metadata: publishes health stats
- Output validation → Published subscriptions: validates outputs
- V2Ray clients → Published subscriptions: imports feeds
README.md - Dashboard application → JSON fetch and mirrors: fetches JSON
dashboard-src/src/App.tsx - Dashboard application → Feed index: reads metadata
README.md - Dashboard application → Health metadata: reads health data
README.md - Dashboard application → Dashboard sections: renders sections
dashboard-src/src/App.tsx