whatisgithub

What is workervless2sub?

cmliu/workervless2sub — explained in plain English

Analysis updated 2026-06-26

5,864JavaScriptAudience · generalComplexity · 3/5Setup · moderate

In one sentence

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.

Mindmap

mindmap
  root((workervless2sub))
    What it does
      Proxy subscription generator
      Speed tests nodes
      Filters slow servers
    Supported Protocols
      VMess
      VLESS
      Trojan
    Deployment
      Cloudflare Workers
      Cloudflare Pages
      GitHub fork auto-rebuild
    Audience
      Proxy client users
      Self-hosters
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

Generate a subscription URL that auto-filters your proxy list to the fastest responding nodes only

USE CASE 2

Deploy a self-hosted subscription endpoint on Cloudflare Workers so your Clash config always loads live servers

USE CASE 3

Switch between VMess, VLESS, and Trojan protocols from a single subscription URL without reconfiguring your proxy client

What is it built with?

JavaScriptCloudflare WorkersCloudflare Pages

How does it compare?

cmliu/workervless2sublindell/jsbarcodecountly/countly-server
Stars5,8645,8595,858
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencegeneraldeveloperpm founder

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 Cloudflare account, deploy by pasting the Worker script or connecting a GitHub fork to Cloudflare Pages.

So what is it?

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.

Copy-paste prompts

Prompt 1
I have a list of VLESS server addresses. How do I deploy WorkerVless2sub on Cloudflare Workers and get a Clash subscription URL?
Prompt 2
Set up WorkerVless2sub on Cloudflare Pages using a GitHub fork so it rebuilds automatically when I update my config
Prompt 3
How do I configure a minimum speed threshold in WorkerVless2sub so only nodes faster than 100 KB/s appear in my subscription?

Frequently asked questions

What is workervless2sub?

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.

What language is workervless2sub written in?

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

How hard is workervless2sub to set up?

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

Who is workervless2sub for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.