How cbeuw/cloak works
Cloak is a pluggable transport that disguises proxy traffic as web traffic, authenticates clients, and carries proxy streams over multiplexed connections. The main workflow runs from a local proxy client through Cloak’s client to the server, which authenticates and dispatches traffic to an upstream proxy; the server can also serve an admin panel. README capabilities include TLS/WebSocket and CDN transport, multi-user credit and bandwidth controls, and multiplexing. Some runtime paths are unsampled, so those branches are included only where documented, without inferring unshown calls.
Main entry points: dispatcher.go Connection dispatcher · ck-client.go Cloak client · auth.go Client authentication · session.go Multiplex session
Components 18
Client transport
- Cloak client
cmd/ck-client/ck-client.go - Client configuration
internal/client/state.go - Client authentication
internal/client/auth.go - TLS camouflage
internal/client/TLS.go - Session connector
internal/client/connector.go
Wire protocol
- Multiplex session
internal/multiplex/session.go - Frame obfuscation
internal/multiplex/obfs.go
Server runtime
- Server listener
cmd/ck-server/ck-server.go - Connection dispatcher
internal/server/dispatcher.go - Server authentication
internal/server/auth.go - Upstream proxy bridge
internal/server/dispatcher.go - Admin panel
internal/server/userpanel.go
User management
- User manager
internal/server/usermanager/localmanager.go - Manager API
internal/server/usermanager/api_router.go
Shared primitives
- Crypto helpers
internal/common/crypto.go - Curve25519 keys
internal/ecdh/curve25519.go
Other components
- Proxy client
- Upstream proxy
Connections 20
- Proxy client → Cloak client: opens local connection
- Cloak client → Client configuration: loads configuration
- Cloak client → Session connector: creates sessions
cmd/ck-client/ck-client.go - Client configuration → Client authentication: provides auth settings
- Client authentication → Curve25519 keys: derives shared secret
internal/client/auth.go - Client authentication → Crypto helpers: encrypts credentials
internal/client/auth.go - Session connector → Multiplex session: uses multiplexing
internal/client/connector.go - TLS camouflage → Crypto helpers: uses record helpers
internal/client/TLS.go - Cloak client → TLS camouflage: starts camouflage transport
- Server listener → Connection dispatcher: serves connections
cmd/ck-server/ck-server.go - Connection dispatcher → Server authentication: authenticates first packet
- Connection dispatcher → Multiplex session: creates session
internal/server/dispatcher.go - Multiplex session → Frame obfuscation: obfuscates frames
internal/multiplex/session.go - Connection dispatcher → User manager: checks user access
internal/server/dispatcher.go - Connection dispatcher → Upstream proxy bridge: bridges proxy streams
internal/server/dispatcher.go - Upstream proxy bridge → Upstream proxy: forwards traffic
- Connection dispatcher → Admin panel: serves admin requests
internal/server/dispatcher.go - Admin panel → Manager API: uses manager API
- Manager API → User manager: manages user records
- User manager → Upstream proxy: applies usage limits