v2ray-configs is a free, auto-updated repository of thousands of V2Ray configuration files covering VMess, VLess, Trojan, TUIC, Shadowsocks, and ShadowsocksR, made for users who need working proxy configs to bypass censorship and perform bulk connection operations.

What it is

v2ray-configs is an automated Python-based repository that aggregates thousands of free V2Ray configuration files and refreshes them every five minutes through a GitHub Actions workflow. It lives in the Infrastructure & Operations / Networking & Connectivity category and serves the broader V2Ray/Xray client ecosystem, including clients such as v2rayNG, Hiddify Next, Nekoray, v2rayN, Fair VPN, and Streisand. The collection is distributed through subscription links and supports multiple export formats: Base64, Normal, and Split by Protocol.

The concrete problem it solves is the constant decay of free proxy configurations. Individual configs become unreachable or blocked, especially in environments subject to the Great Firewall (topics gfw and gfw-china), so manually finding, testing, and replacing them is slow and unreliable. By providing thousands of configs and updating them every five minutes, v2ray-configs replaces the manual hunt for individual working configs with a continuously refreshed bulk source. It also supports bulk connection and bulk operation workflows, which lets users rotate through many endpoints rather than depending on a single one.

Key capabilities

• Auto-updates every five minutes via the main.yml GitHub Actions workflow.
• Ships thousands of configs in Base64, Normal, and Split by Protocol formats.
• Supports VMess, VLess, Trojan, TUIC, Shadowsocks (SS), and ShadowsocksR (SSR) protocols.
• Includes Reality, V2Ray WebSocket TLS, and VLess gRPC transport configurations through repository topics.
• Requires no registration and is 100% free.
• Works with v2rayNG on Android; Fair VPN and Streisand on iOS; Hiddify Next, Nekoray, and v2rayN on Windows and Linux.
• Provides subscription links for easy import into compatible clients.

Who uses it and how

• Users in censored regions, particularly China, who need a rotating pool of working proxy configs for daily browsing; the gfw and gfw-china topics identify this audience.
• Android users who import the subscription links into v2rayNG, the README's recommended client.
• iOS users who load configs into Fair VPN or Streisand.
• Windows and Linux users who use Hiddify Next (recommended), Nekoray, or v2rayN.
• Operators performing bulk connection or bulk operation tasks, such as mass testing or automated failover across thousands of endpoints.

Getting started

Obtain the configs from the subscription links in the README's "Get Configs" section and import them into a compatible client; the collection itself has no package, Docker image, or compose file. The README also promotes a separate Windows tool, MEMENTO, available as MEMENTO.exe from its own Releases page.

How it compares

No comparable config-collection tools are named in the provided facts, so v2ray-configs stands alone in this registry. The clients listed in the README — v2rayNG, Hiddify Next, Nekoray, v2rayN, Fair VPN, and Streisand — consume these configs rather than replace the collection.

When to use it — and when not to

Use it when the goal is a free, high-frequency bulk source of proxy configs for testing or circumvention with an existing V2Ray/Xray client. Do not choose it when you need guaranteed uptime, audited privacy, dedicated bandwidth, or enterprise compliance, because the configs are free and unvetted. The licence is also ambiguous: repository metadata lists GPL-3.0 while the README badge claims MIT, and the README devotes significant space to the separate MEMENTO project, leaving the collection's own documentation sparse.