# mahdibland/V2RayAggregator

Collect Lots of Shadowsocks, ShadowsocksR, Trojan, Vmess from Public Sources & Filter Best Nodes By Speed

Repository: https://github.com/mahdibland/V2RayAggregator
Canonical: https://ross.abutalabs.com/products/v2rayaggregator
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: airport, clash, gfw, nodes, proxies, scientific-internet-access, shadowsocks, shadowsocksr, ss, ssr, trojan, vmess, best-nodes, china-censorship, clash-config, freeairport, freenodes, v2ray, free-proxies, node
Last push: 2026-08-26T13:36:03+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 1433, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4008, forks 663 (observed 2026-08-28T04:08:32.226123+00:00)

## What it is
A Python-based automation that aggregates free proxy nodes (Shadowsocks, SSR, Trojan, Vmess) from public sources, deduplicates them, and speed-tests them via GitHub Actions to publish the best nodes in multiple formats. It outputs subscription files in YAML, Clash, V2Ray, and Base64 formats for use with proxy clients.

## Use cases
- aggregate free v2ray and shadowsocks nodes from public sources
- get a clash subscription of speed-tested free proxies
- filter free proxy nodes by speed automatically
- collect trojan and vmess nodes without duplicates
- schedule automatic proxy node updates via github actions
- find working free nodes for censorship circumvention

## When to choose
- you want continuously updated, speed-ranked free proxy subscriptions in multiple client formats
- you need automated collection and deduplication of public proxy sources with zero infrastructure beyond GitHub Actions

## When to avoid
- you need reliable, paid proxy service quality or guaranteed availability
- you require nodes tested from your own regional network perspective, since speed tests run from GitHub's US-based runners
- you need a self-hosted proxy server rather than an aggregator of existing nodes

## Facets
- artifact type: service
- maturity: active
- function: web-scraping, etl, scheduling, data-generation, monitoring
- domain: censorship-circumvention, privacy, networking, self-hosted
- platform: python, cloud, cli
- tags: v2ray, clash, shadowsocks, proxy-aggregator, github-actions, free-nodes, speed-test, gfw-circumvention, trojan, vmess, automation

## Member repositories
- mahdibland/V2RayAggregator (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:32.226123+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:24:02.754317+00:00, confidence not recorded.
  - readme: https://github.com/mahdibland/V2RayAggregator (fetched 2026-08-28T04:08:32.226123+00:00, sha 28d5a1c57e53)
- Data as of 2026-08-30T08:39:29.467469+00:00.