How oscar-googol/workervless2sub works
WorkerVless2sub is a Cloudflare Worker that turns user-supplied or configured VMess/VLESS/Trojan node details into optimized subscriptions. Its main workflow accepts either a quick /auto request or a custom /sub request, gathers preferred line candidates, and returns a subscription in the requested format. The README also documents a browser-based one-click generator, Clash/Sing-box conversion, scheduled-style dynamic UUIDs, and Telegram notifications. Runtime logic is concentrated in _worker.js; unsampled implementation details are represented only where the README documents the capability.
Main entry points: _worker.js Worker handler · addressesapi.txt Address lists · addressescsv.csv Speed-test CSV · addressesipv6api.txt IPv6 addresses
Components 18
Request and UI
- Worker handler
_worker.js - Request config
_worker.js - Web generator
_worker.js
Line sources
- Static candidates
_worker.js - Remote address lists
_worker.js - CSV candidates
_worker.js - Proxy IP pool
_worker.js - Address lists
addressesapi.txt - Speed-test CSV
addressescsv.csv - IPv6 addresses
addressesipv6api.txt
Subscription output
- Node builder
_worker.js - Dynamic UUID
_worker.js - Subscription formats
_worker.js
External integrations
- Subconverter service
- IP geolocation
- Telegram bot
Other components
- Subscriber
- Subscription client
Connections 18
- Subscriber → Worker handler: sends request
- Worker handler → Web generator: serves page
- Web generator → Worker handler: submits details
- Worker handler → Request config: parses parameters
- Request config → Static candidates: loads configured lines
- Request config → Remote address lists: selects list URLs
- Remote address lists → Address lists: fetches list
- Remote address lists → IPv6 addresses: fetches list
- Request config → CSV candidates: selects CSV URLs
- CSV candidates → Speed-test CSV: fetches measurements
- Worker handler → Node builder: builds nodes
- Worker handler → Dynamic UUID: derives UUIDs
- Worker handler → Subscription formats: formats subscription
- Subscription formats → Subconverter service: requests conversion
- Worker handler → IP geolocation: looks up IP details
- Worker handler → Telegram bot: sends notification
- Subscription formats → Subscription client: returns subscription
- Worker handler → Proxy IP pool: collects proxy IPs