whatisgithub

What is v2rayfree?

free-nodes/v2rayfree — explained in plain English

Analysis updated 2026-06-24

12,413Audience · generalComplexity · 1/5Setup · easy

In one sentence

A daily-updated list of free proxy server connection strings using V2Ray, Shadowsocks, and Trojan protocols, primarily for users in China who want to access websites blocked by the national firewall.

Mindmap

mindmap
  root((v2rayfree))
    What it does
      Free proxy nodes
      Daily updates
      Subscription URL
    Protocols
      V2Ray
      Shadowsocks
      Trojan
    Client Apps
      v2rayN Windows
      Clash Meta Android
      Shadowrocket iOS
      FLClash macOS
    Audience
      Chinese users
      Privacy seekers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Paste the subscription URL into v2rayN on Windows to get an auto-updating list of free proxy servers

USE CASE 2

Import node strings into Clash Meta on Android to route traffic around network restrictions

USE CASE 3

Copy individual nodes into Shadowrocket on iOS for immediate proxy access without any setup

How does it compare?

free-nodes/v2rayfreeidootop/mi-gptreactioncommerce/reaction
Stars12,41312,41212,408
LanguageTypeScriptJavaScript
Setup difficultyeasymoderatehard
Complexity1/53/54/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

No code to install, copy a subscription URL into a compatible client app, free nodes go offline frequently so daily refresh is needed.

So what is it?

This repository is a publicly shared collection of free proxy server connection strings, updated daily. The connections use protocols called V2Ray, Shadowsocks (SS), and Trojan, which are tools originally developed to route internet traffic in ways that can bypass network restrictions. The README is written in Chinese and is oriented toward users in China who want to access websites blocked by the national firewall. The repository does not contain any application code. It is essentially a plain-text list of connection strings that you copy into a compatible client app on your device. The README lists several client applications: v2rayN for Windows, Clash Meta for Android, Shadowrocket for iOS, and FLClash for macOS. Once you have a client installed, you paste the subscription URL or the individual node strings into it, and the client handles connecting through those proxy servers. A subscription URL is included, which points to a raw GitHub file that the client can poll to automatically get the latest list of nodes. The individual node strings in the README itself represent a snapshot from the date the README was last updated. Because free public nodes tend to go offline quickly, the list is refreshed daily. The repository also promotes two paid VPN services as faster alternatives to the free nodes, listing their pricing, bandwidth, and features. These appear to be affiliate promotions rather than part of the core content. This is a resource-sharing repository rather than a software project. It requires no installation on its own. The intended audience is anyone who needs a client-side proxy setup and wants a regularly updated list of free server options without running their own infrastructure.

Copy-paste prompts

Prompt 1
How do I import a V2Ray subscription URL into the v2rayN client on Windows and verify it is connecting?
Prompt 2
What is the difference between V2Ray, Shadowsocks, and Trojan proxy protocols and which should I choose for speed vs reliability?
Prompt 3
How do I set up Clash Meta on Android using a subscription URL from a GitHub-hosted proxy node list?
Prompt 4
How often do free public proxy nodes go offline and what is the best way to keep my client list automatically refreshed?

Frequently asked questions

What is v2rayfree?

A daily-updated list of free proxy server connection strings using V2Ray, Shadowsocks, and Trojan protocols, primarily for users in China who want to access websites blocked by the national firewall.

How hard is v2rayfree to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is v2rayfree for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.