A minimalist, cloud-native container image designed for scalable network routing and secure WebSocket transport on edge platforms and container clusters.
Architecture • Configuration • Deployment • Disclaimer • Maintainer
- Minimal Attack Surface: Built on top of stripped container layers with zero unnecessary packages or running daemons.
- Dynamic Runtime Provisioning: Generates routing configurations on container startup dynamically from environment variables (
$PORT,$UUID), eliminating hardcoded credentials in images. - WebSocket Transport Layer: Uses standards-compliant WebSocket (
/vmess) tunneling to seamlessly pass through reverse proxies, cloud load balancers, and CDN firewalls. - Multi-Cloud Ready: Deployable on Heroku Container Stack, Docker Swarm, Kubernetes, Railway, Fly.io, or standard Linux VPS environments.
| Variable | Requirement | Default | Description |
|---|---|---|---|
PORT |
Required (Auto-injected by cloud) | 8080 |
The listening port allocated by the host or container orchestrator. |
UUID |
Required | — | Unique Client UUID used for cryptographic handshake verification. |
# Build the image
docker build -t cloud-proxy .
# Run container with custom UUID and port mapping
docker run -d \
-e PORT=8080 \
-e UUID="your-generated-uuid-v4-here" \
-p 8080:8080 \
--name proxy-service \
cloud-proxy# Login to Heroku Container Registry
heroku container:login
# Create app and push container
heroku create your-app-name
heroku config:set UUID="$(uuidgen)"
heroku container:push web -a your-app-name
heroku container:release web -a your-app-nameImportant
This software is intended strictly for private network routing, educational research into modern transport protocols, and authorized network engineering experiments. Ensure compliance with all local telecommunications regulations and terms of service of your cloud infrastructure provider.
Created by 0xOpCode.