What is it?

X4G is a high-performance Python gateway designed for managing VLESS proxy tunnels. Think of it as a traffic control center for your proxy infrastructure - it handles the complex routing of network data while giving you fine-grained control over how that data flows. The project supports multiple transport protocols including WebSocket and XHTTP variants, making it adaptable to different network environments and censorship scenarios.

Beyond basic tunneling, X4G provides a comprehensive web dashboard for monitoring connections, tracking bandwidth usage, and managing configurations in real-time. What sets it apart is its optional Telegram bot integration, allowing administrators to manage proxy links, view statistics, and control access without ever opening a web browser. The system stores all configuration data persistently, ensuring settings survive server restarts when properly configured.

Key Features & Use Cases

Developers and system administrators can leverage X4G to build sophisticated proxy solutions for various scenarios:

• Multi-protocol Support: Choose between WebSocket, XHTTP packet-up, or XHTTP stream-up transports based on your network requirements and bypass needs
• HTTP Proxy Integration: Built-in HTTP proxy functionality extends the gateway's utility beyond VLESS to standard web browsing
• Traffic Limiting: Set per-configuration bandwidth caps in Mbps, perfect for sharing resources among multiple users
• Subscription Groups: Bundle multiple configurations into elegant, shareable subscription pages that can be password-protected for controlled distribution
• QR Code Generation: Instantly generate scannable QR codes for any configuration or subscription, streamlining client setup on mobile devices
• Persistent Storage: Configuration data survives container restarts when deployed with proper volume mounting
• Custom TLS Fingerprints: Manually configure uTLS fingerprints and ALPN settings to mimic different browsers and evade detection

Common use cases include managing proxy services for small teams, creating tiered subscription offerings with different bandwidth limits, or building censorship-resistant communication channels for content distribution.

Why is it Trending?

With over 3,400 stars, X4G has gained significant traction in the proxy management space. Several factors contribute to its popularity: the combination of technical sophistication with user-friendly features, the Telegram bot integration that enables mobile-first administration, and the flexibility to run on modern cloud platforms like Railway with minimal setup.

The project stands out because it bridges the gap between enterprise-grade proxy management and accessibility for individual users. While many solutions require deep networking knowledge and manual configuration, X4G provides an intuitive dashboard alongside powerful automation features. The ability to create unlimited custom links with individual traffic and speed limits addresses a common pain point for proxy operators who need to share resources fairly.

Community adoption has been driven by the project's active development and responsive maintainer, with users appreciating the balance between advanced customization options and straightforward deployment processes. The QR code generation and subscription grouping features particularly resonate with users managing multiple client devices.

Who Should Use It?

X4G targets system administrators, DevOps engineers, and technically-minded users who need reliable proxy management with advanced controls. Basic familiarity with proxy protocols (VLESS, WebSocket) and cloud deployment concepts is helpful but not strictly required thanks to the guided setup process.

The tool fits well in containerization environments, particularly Docker and Railway deployments. It's ideal for users who want more control than typical one-click proxy solutions provide, but don't want to build everything from scratch. The Telegram bot integration makes it especially appealing to administrators who prefer mobile management workflows.

While the interface is in Persian, the core functionality is universal, and the project's popularity suggests an active international user base. Documentation appears sufficient for intermediate users, with the GitHub README providing clear deployment instructions.

Getting Started

Deploying X4G is straightforward with these steps:

1. Fork the repository on GitHub to create your own copy
2. Sign up at Railway.app and create a new project using "Deploy from GitHub repo"
3. Select your forked repository and let Railway handle the automatic deployment
4. Enable a public domain in Railway settings to ensure proper environment variable configuration
5. Create a persistent volume mounted at /data to preserve configuration data across restarts
6. Access the dashboard at https://your-app.up.railway.app/dashboard
7. Copy the default VLESS link and import it into your preferred client (v2rayNG, NekoBox, etc.)
8. Navigate to link management to create custom configurations with traffic and speed limits

For the full setup guide, see the official repository.