x4gKing/X4GPublic

What is X4G?

A fast modern gateway for VLESS tunneling over WebSocket and XHTTP with comprehensive management features.

What does X4G do?

X4G operates as a high-performance gateway specifically designed for VLESS tunneling utilizing WebSocket and XHTTP protocols. It includes a built-in HTTP proxy and provides a detailed web dashboard for monitoring live connections and hourly traffic charts. The system allows administrators to create custom subscription links with strict controls over traffic limits, bandwidth throttling, and concurrent IP usage. It also features an optional Telegram bot for managing configurations without needing to access the web panel directly. Furthermore, X4G ensures configuration persistence by saving state to disk, surviving service restarts.

Who is X4G for?

Network administrators and advanced users looking to deploy and manage a secure, multi-user VLESS proxy server. It requires familiarity with proxy protocols, tunneling, and basic server administration.

How do I get started with X4G?

Fork the repository on GitHub and deploy it to a platform like Railway.

How popular is X4G on GitHub?

x4gKing/X4G has 8,552 stars and 15,233 forks on GitHub, and gained 1,196 stars in the last 7 days.

• Breakout launch

  8,552 stars in 93 days

• Rising fast

  +1,196 stars this week

• Repeat trending

  4 trending appearances

X4G operates as a high-performance gateway specifically designed for VLESS tunneling utilizing WebSocket and XHTTP protocols. It includes a built-in HTTP proxy and provides a detailed web dashboard for monitoring live connections and hourly traffic charts. The system allows administrators to create custom subscription links with strict controls over traffic limits, bandwidth throttling, and concurrent IP usage. It also features an optional Telegram bot for managing configurations without needing to access the web panel directly. Furthermore, X4G ensures configuration persistence by saving state to disk, surviving service restarts.

Network administrators and advanced users looking to deploy and manage a secure, multi-user VLESS proxy server. It requires familiarity with proxy protocols, tunneling, and basic server administration.

• Multi-protocol tunneling: Supports VLESS over WebSocket, XHTTP packet-up, and XHTTP stream-up protocols.
• Granular traffic controls: Enables strict bandwidth throttling and traffic volume limits per individual configuration.
• Comprehensive dashboard: Provides live connection monitoring, hourly traffic graphs, and detailed activity logs.
• Telegram bot management: Allows full administration of configurations and subscription groups via a Telegram bot interface.
• Advanced connection masking: Features customizable uTLS fingerprints, ALPN routing, and configurable connection ports.
• Persistent state storage: Saves configuration and usage data directly to disk to maintain state across service restarts.

Getting started: Fork the repository on GitHub and deploy it to a platform like Railway.

1. 9.5Update_9.5Jul 10, 2026182 downloads

   What's New / تغییرات جدید 🇬🇧 English New Features 🌐 Added XHTTP transport support (packet-up and stream-up modes) alongside the existing VLESS-over-WebSocket 🚦 Added per-config speed limiting (bandwidth throttling, Mbps-based, Token Bucket implementation) 🗂 Added Sub-Groups: bundle multiple configs into a group and get a single, beautifully designed public subscription page (/p/{key}) — optionally password-protected 🤖 Added a full Telegram management bot (optional) — create configs via a step-by-step wizard (protocol, fingerprint, ALPN, port, traffic/speed/IP limits, expiry), list/toggle/delete configs, and manage sub-groups, all without opening the web panel 💾 State (configs, stats, sub-groups) is now persisted to disk (DATA_DIR, default /data) instead of living only in memory — requires a persistent Volume mounted at that path to survive restarts/redeploys New Environment Variables DATA_DIR — storage path (needs a persistent Volume) TELEGRAM_BOT_TOKEN / TELEGRAM_ADMIN_IDS — enable the Telegram bot Fixes / Corrections Corrected outdated docs claiming data was in-memory only and always reset on restart — this is no longer true as long as a Volume is att

• public-apis/public-apis

  A collective list of free APIs

  486.1K stars · Python

• donnemartin/system-design-primer

  Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.

  373.2K stars · Python

• practical-tutorials/project-based-learning

  Curated list of project-based tutorials

  285.8K stars · Python

• NousResearch/hermes-agent

  The agent that grows with you

  251.2K stars · Python

• yt-dlp/yt-dlp

  A feature-rich command-line audio/video downloader

  195.5K stars · Python

• microsoft/markitdown

  Python tool for converting files and office documents to Markdown.

  188.4K stars · Python