gitwtfhub

wtf is cf-workers-sub?

cmliu/cf-workers-sub — explained in plain English

Analysis updated 2026-06-24

7,386JavaScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A Cloudflare Workers/Pages script that merges multiple proxy node configs and subscription links into one private URL, so Clash, V2Ray, or similar clients always get your latest combined node list from a single import.

Mindmap

mindmap
  root((cf-workers-sub))
    What it does
      Merges proxy nodes
      Single subscription URL
      Format conversion
    Inputs
      VLESS links
      VMess links
      External subscriptions
    Deployment
      Cloudflare Workers
      Cloudflare Pages
      KV storage
    Clients
      Clash
      V2Ray
      Other proxy apps

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

Combine all your VLESS and VMess proxy nodes into one private subscription URL for Clash or V2Ray

REASON 2

Host a self-managed proxy subscription on Cloudflare's free tier with no server cost

REASON 3

Automatically convert merged node configs into whichever format your proxy client expects

REASON 4

Pull nodes from multiple external subscription services and serve them all from a single private URL

What's in the stack?

JavaScriptCloudflare WorkersCloudflare PagesCloudflare KV

How it stacks up

cmliu/cf-workers-subpoloclub/transformer-explainerevomap/evolver
Stars7,3867,3757,407
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity3/51/53/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a free Cloudflare account and creating a KV namespace to store node links.

Wtf does this do

CF-Workers-SUB is a JavaScript tool that runs on Cloudflare's serverless platform (either Workers or Pages). It takes multiple proxy server configurations and subscription links that you provide, and combines them into a single subscription URL that proxy clients like Clash or V2Ray can import. Instead of managing several separate subscription links, you maintain one private URL that always returns your current merged node list. The tool accepts individual proxy node links in formats like VLESS and VMess, as well as links to external subscription lists from other services. All of these are merged and served from a URL that only you know, reducing the risk of your subscription address being discovered or shared without permission. The README notes that when aggregating a very large number of nodes, Clash clients may time out during the conversion step, so users are advised to trim the node count if this happens. A notable feature is automatic format conversion. Different proxy clients expect different subscription formats, and CF-Workers-SUB calls an external conversion service to translate the merged output into whichever format a client requests. This lets a single subscription URL work across multiple different proxy applications. Deployment can be done through Cloudflare Pages by forking the repository and connecting it to the Cloudflare Pages dashboard, or through a Cloudflare Worker by pasting the worker script directly into the Cloudflare editor. Both require a free Cloudflare account. Node links and subscription URLs are stored and managed through a Cloudflare KV namespace, edited via a simple web interface served by the worker itself.

Yoink these prompts

Prompt 1
How do I deploy CF-Workers-SUB on Cloudflare Pages and configure the KV namespace to store my node links?
Prompt 2
Show me how to add a new VLESS node to my CF-Workers-SUB subscription using the built-in web interface
Prompt 3
Why does Clash time out when loading my CF-Workers-SUB subscription, and how do I trim the node count to fix it?
Prompt 4
How do I add multiple external subscription URLs to CF-Workers-SUB so it merges them all into one output?
Prompt 5
What is the difference between deploying CF-Workers-SUB as a Cloudflare Worker versus a Cloudflare Pages project?

Frequently asked questions

wtf is cf-workers-sub?

A Cloudflare Workers/Pages script that merges multiple proxy node configs and subscription links into one private URL, so Clash, V2Ray, or similar clients always get your latest combined node list from a single import.

What language is cf-workers-sub written in?

Mainly JavaScript. The stack also includes JavaScript, Cloudflare Workers, Cloudflare Pages.

How hard is cf-workers-sub to set up?

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

Who is cf-workers-sub for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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