gitwtfhub

wtf is free-nodes?

zhuhaiuk/free-nodes — explained in plain English

Analysis updated 2026-05-18

75HTMLAudience · generalComplexity · 1/5Setup · easy

TL;DR

A free, hourly-updated list of proxy server subscription links for clients like Clash, V2Ray, and Shadowrocket, intended for temporary testing rather than reliable everyday use.

Mindmap

mindmap
  root((free-nodes))
    What it does
      Publishes proxy nodes
      Updates hourly
      Two subscription formats
    Tech stack
      GitHub Actions
      GitHub Pages
    Use cases
      Test a proxy client
      Verify subscription format
      Temporary backup connection
    Audience
      Proxy client beginners
    Setup
      Copy subscription link
      No install needed

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

Why would anyone build with this?

REASON 1

Test whether a proxy client app like Clash or V2Ray is configured correctly.

REASON 2

Get a temporary backup connection when a primary proxy service is unavailable.

REASON 3

Learn how subscription links work before committing to a paid proxy service.

REASON 4

Verify that a Clash or Base64 subscription format imports correctly into a client.

What's in the stack?

GitHub ActionsGitHub Pages

How it stacks up

zhuhaiuk/free-nodeslaoshan-song/awesome-llm-interviewpeterpanswift/fox-ai-roundtable
Stars757575
LanguageHTMLHTMLHTML
Setup difficultyeasyeasymoderate
Complexity1/51/52/5
Audiencegeneralresearcherdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

No install needed beyond a compatible proxy client, nodes are shared and free, so stability and availability are not guaranteed.

Wtf does this do

This repository is a free, publicly shared list of proxy server addresses, distributed as subscription links that update automatically every hour. It is aimed at people using proxy client apps like Clash, Mihomo, V2Ray, Trojan, Shadowsocks, and Shadowrocket, tools that let a device route its internet traffic through a chosen server, often to test connectivity or reach services outside their normal network. There are two fixed subscription links kept current by an automated script: a plain Base64 encoded list compatible with V2Ray style clients, and a YAML formatted file for Clash and Mihomo style clients. At the time of writing the README, the list holds around 50 free proxy nodes spread across countries including the United States, Germany, Hong Kong, the Netherlands, and South Korea, using protocols such as HTTP, VLESS, SOCKS5, Trojan, Shadowsocks, and Hysteria2. Each node is labeled with a country code plus the project's domain name so users can tell regions apart at a glance. The README is upfront that these free nodes are not meant for serious or long term use. It explains that shared free nodes tend to get crowded, may slow down or stop working without warning, and offer no guarantee of stability, speed, or continued availability. It suggests they suit temporary testing, learning how a proxy client works, or checking whether a subscription format is set up correctly, and recommends a paid proxy service instead for anyone who needs consistent, reliable access. The project also publishes a companion GitHub Pages site with setup tutorials for different clients and operating systems, a Telegram channel for updates, and a separate repository of step-by-step client tutorials. The README's own disclaimer states that everything here is meant for learning, research, and connectivity testing, that users must follow their local laws and the terms of any service they connect to, and that the nodes should not be used for logging into important accounts, sending sensitive information, or anything illegal.

Yoink these prompts

Prompt 1
Explain how to add this repo's Base64 subscription link to a V2Ray client.
Prompt 2
Explain the difference between the Base64 subscription and the Clash YAML subscription in this repo.
Prompt 3
Help me understand why a free proxy node might stop working and what to try next.
Prompt 4
Explain what this project's disclaimer means about not using free nodes for sensitive information.

Frequently asked questions

wtf is free-nodes?

A free, hourly-updated list of proxy server subscription links for clients like Clash, V2Ray, and Shadowrocket, intended for temporary testing rather than reliable everyday use.

What language is free-nodes written in?

Mainly HTML. The stack also includes GitHub Actions, GitHub Pages.

How hard is free-nodes to set up?

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

Who is free-nodes for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.