explaingit

cmliu/workervless2sub

5,864JavaScript
This is a quick first-pass explanation. The richer sections — use-cases, tech stack, setup, prompts — are still being generated.

TLDR

WorkerVless2sub is a subscription generator for proxy network clients, written in JavaScript and designed to run on Cloudflare Workers or Cloudflare Pages.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

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

In plain English

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.

Open on GitHub → Explain another repo

← cmliu on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.