How tud8951/cf-workers-tgproxy works
CF-Workers-TGProxy is a single-file Cloudflare Worker that serves Telegram’s web-proxy page and converts client WebSocket lanes into connections to Telegram Web K’s KWS endpoints. The main workflow is page/bootstrap → session token and lease → per-stream lane → transport obfuscation re-signing → KWS relay, with aggregation on the data path. The README documents the major capabilities; the excerpt confirms token signing, in-memory leases, AES-CTR handling, KWS dialing and lane setup. Details of the omitted router and relay internals are therefore attributed to README documentation.
Main entry points: telegram_webproxy.js Lane session
Components 14
Page and ingress
- Worker entry
telegram_webproxy.js - Proxy page
telegram_webproxy.js - Android bridge
telegram_webproxy.js
Auth and session
- Session API
telegram_webproxy.js - Token signing
telegram_webproxy.js - Lease state
telegram_webproxy.js
Lane relay
- Lane WebSocket
telegram_webproxy.js - Lane session
telegram_webproxy.js - Obfuscation transform
telegram_webproxy.js - KWS dialer
telegram_webproxy.js - Frame aggregation
telegram_webproxy.js - WebSocket relay I/O
telegram_webproxy.js
Other components
- Telegram clients
- Telegram Web K
Connections 16
- Telegram clients → Proxy page: loads page
README.md - Worker entry → Proxy page: serves
README.md - Proxy page → Android bridge: bridges messages
README.md - Proxy page → Session API: requests session
README.md - Session API → Token signing: verifies and signs
telegram_webproxy.js - Session API → Lease state: creates lease
README.md - Proxy page → Lane WebSocket: opens lane
README.md - Lane WebSocket → Token signing: verifies token
telegram_webproxy.js - Lane WebSocket → Lease state: checks lease
README.md - Lane WebSocket → Lane session: attaches session
telegram_webproxy.js - Lane session → Obfuscation transform: resigns transport
README.md - Lane session → KWS dialer: dials upstream
README.md - KWS dialer → Telegram Web K: connects WebSocket
telegram_webproxy.js - Lane session → Frame aggregation: bundles frames
README.md - Lane session → WebSocket relay I/O: relays bytes
README.md - WebSocket relay I/O → Telegram Web K: forwards traffic
README.md