whatisgithub

What is cf-workers-sub?

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

Analysis updated 2026-06-24

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

In one sentence

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
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

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

JavaScriptCloudflare WorkersCloudflare PagesCloudflare KV

How does it compare?

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 get it running?

Difficulty · moderate Time to first run · 30min

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

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.