Proxy Management
VLESS relay and HTTP proxy functionality for seamless traffic routing and management.
// proxy & management service
X4G
A FastAPI-based proxy and management service with Telegram bot integration.
Explore FeaturesFeatures
Everything you need to manage proxies, control bandwidth, and automate monitoring — all from a single service.
Speed Limiting
Configurable bandwidth controls to manage and throttle traffic with precision.
Telegram Bot
Automated management and monitoring via Telegram for real-time control and alerts.
WebSocket Support
Real-time communication capabilities for live data exchange and monitoring.
Persistent Storage
State management with disk-based persistence to retain data across restarts.
CORS Support
Cross-origin resource sharing enabled for flexible API integrations.
Tech Stack
Built with modern, performant tools and libraries.
FastAPI 0.104.1
Python
Uvicorn
HTTPX
HTTP/2
WebSockets
aiofiles
VLESS
HTTP Proxy
Telegram Bot API
Asia/Tehran
Quick Start
Get up and running in seconds.
# Install dependencies pip install -r requirements.txt # Run the application python main.py
Configuration
The service uses environment variables for configuration.
-
DATA_DIR
Directory for persistent storage (default:
/data) - SECRET_KEY Application secret key (auto-generated if not provided)
Architecture
The application consists of several key modules working together.
main.py
relay_vless.py
telegram_bot.py
speed_limit.py
pages.py
xhttp_siz10.py
Core FastAPI application and state management with modular proxy, bot, and limiting components.
Storage
X4G maintains persistent state across restarts using JSON-based storage with file locking to prevent corruption during concurrent operations.