cmliu/workervless2sub — explained in plain English
Analysis updated 2026-06-26
Generate a subscription URL that auto-filters your proxy list to the fastest responding nodes only
Deploy a self-hosted subscription endpoint on Cloudflare Workers so your Clash config always loads live servers
Switch between VMess, VLESS, and Trojan protocols from a single subscription URL without reconfiguring your proxy client
| cmliu/workervless2sub | lindell/jsbarcode | countly/countly-server | |
|---|---|---|---|
| Stars | 5,864 | 5,859 | 5,858 |
| Language | JavaScript | JavaScript | JavaScript |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 3/5 | 2/5 | 3/5 |
| Audience | general | developer | pm founder |
Figures from each repo's GitHub metadata at analysis time.
Requires a Cloudflare account, deploy by pasting the Worker script or connecting a GitHub fork to Cloudflare Pages.
WorkerVless2sub is a subscription generator for proxy network clients, written in JavaScript and designed to run on Cloudflare Workers or Cloudflare Pages. Its purpose is to automatically test a list of server addresses and produce a filtered subscription file containing only the fastest-responding nodes. The tool supports three proxy protocols: VMess, VLESS, and Trojan. These protocols are commonly used with proxy client applications like Clash and Singbox, which accept subscription URLs as a way to load server configurations rather than requiring manual entry of each server. The core feature is address optimization: you supply a list of server addresses (or a URL pointing to a remote text file of addresses), along with connection details like a UUID or password. WorkerVless2sub tests each address against a configurable minimum speed threshold and generates a subscription containing only the addresses that pass. The address list can come from static configuration, a remote API endpoint, or a CSV file produced by a speed-testing tool. Deployment involves creating a Cloudflare Worker and pasting the project's JavaScript file into it, or connecting a GitHub fork to Cloudflare Pages for automatic rebuilds. Either way, you end up with a URL that proxy client apps poll to get an updated server list. Configuration is done through environment variables set in the Cloudflare dashboard, controlling which protocols to use, what UUID or password to include, which address lists to pull from, and optional Telegram notifications. The README and all documentation are written in Chinese.
A Cloudflare Workers script that speed-tests a list of proxy server addresses and outputs a filtered subscription URL containing only the fastest nodes, for use with proxy clients like Clash or Singbox.
Mainly JavaScript. The stack also includes JavaScript, Cloudflare Workers, Cloudflare Pages.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.