# cmliu/workervless2sub

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/cmliu-workervless2sub).**

5,997 stars · 7,488 forks · JavaScript · Apache-2.0

## Links

- GitHub: https://github.com/cmliu/WorkerVless2sub
- Homepage: https://VLESS.fxxk.dedyn.io
- awesome-repositories: https://awesome-repositories.com/repository/cmliu-workervless2sub.md

## Description

WorkerVless2sub is a serverless proxy subscription manager that runs on Cloudflare's edge network, generating optimized VMess, VLESS, and Trojan proxy links. It operates as a subscription generator that combines a default node pool with IP-replacement optimization to produce high-performance proxy configurations.

The project distinguishes itself through its environment-variable-driven configuration system, allowing node parameters like host, UUID, and password to be set without code changes. It provides multiple subscription delivery methods, including a token-based quick endpoint for pre-configured nodes and URL-query-parameter customization for building tailored subscription links. Subscriptions can be exported in Clash or Sing-box format by appending a format suffix to the URL.

The system includes dynamic UUID credential management with configurable validity periods and automatic daily rotation. It maintains a multi-protocol node pool supporting VMess, VLESS, and Trojan protocols, with the ability to replace server addresses with speed-tested IPs for improved connection quality. Configuration is handled entirely through environment variables, defining default node parameters for automated subscription generation.

## Tags

### DevOps & Infrastructure

- [Proxy Subscription Generators](https://awesome-repositories.com/f/devops-infrastructure/serverless-architectures/cloudflare-workers-implementations/proxy-subscription-generators.md) — Generates optimized VMess, VLESS, and Trojan proxy subscriptions using Cloudflare Workers serverless runtime.
- [Environment Variable Configuration](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/environment-management/environment-variable-management/environment-variable-configurations/environment-variable-configuration.md) — Configuring node parameters like host, UUID, and password through environment variables for flexible subscription generation.
- [Cloudflare Workers Implementations](https://awesome-repositories.com/f/devops-infrastructure/serverless-architectures/cloudflare-workers-implementations.md) — Runs subscription generation logic entirely on Cloudflare's edge network using the Workers JavaScript runtime.

### Networking & Communication

- [VMess VLESS Trojan](https://awesome-repositories.com/f/networking-communication/proxy-servers/v2ray-configuration-managers/v2ray-subscription-providers/subscription-generators/vmess-vless-trojan.md) — Generating proxy subscription links for VMess, VLESS, and Trojan nodes with customizable parameters and optimized server addresses.
- [Proxy Subscription Managers](https://awesome-repositories.com/f/networking-communication/cloudflare-worker-proxies/proxy-subscription-managers.md) — Managing proxy node subscriptions and configurations directly through Cloudflare Workers serverless functions.
- [Custom Subscription Builders](https://awesome-repositories.com/f/networking-communication/proxy-servers/v2ray-configuration-managers/v2ray-subscription-lists/subscription-url-parsers/custom-subscription-builders.md) — Construct subscription URLs from user-provided host, UUID, password, path, and transport parameters for VLESS or Trojan nodes. ([source](https://github.com/cmliu/WorkerVless2sub))
- [Pre-Configured Node Pool Subscriptions](https://awesome-repositories.com/f/networking-communication/proxy-servers/clash-configuration-managers/subscription-providers/pre-configured-node-pool-subscriptions.md) — Providing a default subscription endpoint with pre-configured proxy nodes accessible via a token path.

### Business & Productivity Software

- [Custom Parameter Subscriptions](https://awesome-repositories.com/f/business-productivity-software/share-link-generation/proxy-subscription-links/custom-parameter-subscriptions.md) — Building tailored subscription URLs by specifying individual node parameters such as host, UUID, password, path, and transport protocol.

### Content Management & Publishing

- [Proxy Subscription Format Exporters](https://awesome-repositories.com/f/content-management-publishing/content-formats-exporting/export-formats/html-exports/multi-format-exports/proxy-subscription-format-exporters.md) — Exports subscription data in Clash or Sing-box format by appending a format parameter to the subscription URL.

### Data & Databases

- [Clash and Sing-Box Exports](https://awesome-repositories.com/f/data-databases/tabular-data-structures/format-agnostic-converters/proxy-rule-format-converters/multi-format-proxy-converters/clash-and-sing-box-exports.md) — Exporting proxy subscriptions in Clash or Sing-box configuration format for direct use in compatible proxy clients.

### Software Engineering & Architecture

- [Environment Variable-Based Configuration](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/environment-variable-management/environment-variables/environment-variable-based-configuration.md) — Reads node parameters like host, UUID, and password from environment variables to configure the default node pool.
- [Proxy Node Pool Defaults](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/environment-variable-management/environment-variables/environment-variable-based-configuration/proxy-node-pool-defaults.md) — Set default nodes, paths, ports, and other subscription parameters through worker environment variables for automatic subscription generation. ([source](https://cdn.jsdelivr.net/gh/cmliu/workervless2sub@main/README.md))
- [Proxy Node Parameter Configurations](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/environment-variable-management/environment-variables/environment-variable-sets/proxy-node-parameter-configurations.md) — Set default node parameters like host, UUID, password, path, and SNI through environment variables for quick subscription generation. ([source](https://cdn.jsdelivr.net/gh/cmliu/workervless2sub@main/README.md))
- [Quick Subscription Endpoints](https://awesome-repositories.com/f/software-engineering-architecture/client-side-subscription-models/path-based-subscriptions/quick-subscription-endpoints.md) — Serves a default subscription URL using built-in nodes, accessible via a configurable token path like /auto.
- [Proxy Node Defaults](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/third-party-service-connectors/built-in-integration-nodes/proxy-node-defaults.md) — Set default values for host, UUID, password, path, and other parameters to predefine nodes for quick subscription generation. ([source](https://cdn.jsdelivr.net/gh/cmliu/workervless2sub@main/README.md))
- [Proxy Node Pools](https://awesome-repositories.com/f/software-engineering-architecture/node-lifecycle-management/distributed-node-lifecycles/node-pool-optimization/proxy-node-pools.md) — Maintains a default pool of hosts, UUIDs, passwords, and paths for serving pre-configured VMess, VLESS, and Trojan nodes.
- [Proxy Node Defaults](https://awesome-repositories.com/f/software-engineering-architecture/node-runtime-configuration/automated-node-configuration/proxy-node-defaults.md) — Setting default node parameters like host, UUID, password, and path through environment variables for quick subscription generation.

### Testing & Quality Assurance

- [Proxy IP Replacement Optimizers](https://awesome-repositories.com/f/testing-quality-assurance/ip-address-generators/proxy-ip-replacement-optimizers.md) — Replaces server addresses in VMess, VLESS, and Trojan links with speed-tested IPs to generate high-performance subscriptions.
- [Time-Limited UUID Credentials](https://awesome-repositories.com/f/testing-quality-assurance/uuid-generators/time-limited-uuid-credentials.md) — Generate time-limited UUIDs using a secret key, with configurable validity period and daily update time. ([source](https://github.com/cmliu/WorkerVless2sub))

### User Interface & Experience

- [Proxy Node Defaults](https://awesome-repositories.com/f/user-interface-experience/component-configuration-defaults/node-component-defaults/proxy-node-defaults.md) — Set default values for host, UUID, password, path, SNI, transport type, and other fields used in quick subscription generation. ([source](https://github.com/cmliu/WorkerVless2sub))
