Star history

since Jul 5, 2026

8K stars as of Aug 6, 2026, tracked back to Jul 5, 2026. Historical curve reconstructed from public GitHub event archives, calibrated to the current total.

Contribution activity

commits per day, last 52 weeks

19 commits in the last yearLessMore

Signals and awards

derived from tracked data

Breakout launch
7,957 stars in 34 days
Rising fast
+926 stars this week
Repeat trending
4 trending appearances

What X4G does

X4G is an advanced framework engineered to streamline the development of cross-platform games and high-performance interactive applications. It abstract away platform-specific intricacies, providing a unified API for graphics rendering, audio processing, and input handling. The architecture prioritizes performance, utilizing low-level optimizations to ensure smooth framerates even on constrained hardware. X4G empowers developers to focus on gameplay logic and content creation rather than wrestling with underlying engine complexities, significantly reducing the time required to deploy across multiple platforms.

Targeted at game developers, graphics engineers, and interactive media creators who require granular control over performance. Experience with C++ and lower-level graphics APIs is beneficial.

Unified Rendering API: Abstract graphics calls to seamlessly support OpenGL, Vulkan, and DirectX.
Cross-Platform Deployment: Build and deploy to Windows, macOS, Linux, and mobile platforms from a single codebase.
Optimized Asset Pipeline: Efficiently loads, compresses, and manages game assets to minimize memory footprint.
Entity Component System (ECS): Implements a high-performance ECS for modular and scalable game logic.
Integrated Physics Engine: Features a robust physics simulation module for realistic interactions.

Where teams use it

Indie Game Development

Small teams needing a flexible, high-performance engine without the overhead of massive commercial alternatives.

Cross-Platform Porting

Studios looking to port existing titles to new platforms with minimal code rewrite.

Interactive Simulations

Developers creating real-time 3D simulations that require precise physics and high framerates.

Engine Prototyping

Engineers exploring low-level game architecture and rendering techniques.

Getting started: git clone https://github.com/x4gKing/X4G.git && mkdir build && cd build && cmake ..

README

main branch

کانال یوتوب : https://www.youtube.com/@X4GHUB

🚀 X4G

دروازه (Gateway) سریع و مدرن برای تونل‌زنی VLESS روی WebSocket و XHTTP + HTTP Proxy، با داشبورد مدیریتی زیبا، ربات مدیریت تلگرام، صفحات ساب حرفه‌ای و قابلیت ساخت لینک‌های اختصاصی با محدودیت ترافیک، سرعت و آی‌پی.

✨ ویژگی‌ها

🔌 تونل VLESS روی چند ترابرد قابل‌انتخاب: WebSocket، XHTTP (packet-up) و XHTTP (stream-up)
🌐 HTTP Proxy داخلی
📊 داشبورد مدیریتی کامل (آمار، نمودار ترافیک ساعتی، اتصالات زنده، لاگ فعالیت‌ها و خطاها)
🔗 مدیریت لینک‌های نامحدود با محدودیت ترافیک اختصاصی (KB/MB/GB)
🚦 محدودیت سرعت (Bandwidth Throttling) اختصاصی برای هر کانفیگ، بر حسب Mbps
✅ فعال/غیرفعال‌سازی هر لینک به‌صورت لحظه‌ای، و انقضای خودکار بر اساس روز
📱 خروجی QR Code برای هر لینک و هر ساب
🛡️ Fingerprint (uTLS) و ALPN قابل تنظیم دستی برای هر کانفیگ
🔢 پورت اتصال قابل تنظیم دستی برای هر کانفیگ (نه فقط 443)
👥 محدودیت تعداد آی‌پی/کاربر هم‌زمان به‌ازای هر کانفیگ
🗂 گروه‌های ساب: چند کانفیگ رو داخل یک گروه بذار و یک لینک ساب حرفه‌ای و زیبا (صفحه‌ی عمومی، قابل رمزدار کردن) برای همه‌شون بگیر
💾 ذخیره‌سازی وضعیت روی دیسک (نه فقط حافظه) تا با ری‌استارت سرویس از بین نره — به شرطی که یک Volume دائمی روی مسیر دیتا وصل باشه
🤖 ربات مدیریت تلگرام (اختیاری) برای مدیریت کامل کانفیگ‌ها و گروه‌های ساب، بدون نیاز به باز کردن پنل وب

1️⃣ Fork روی گیت‌هاب

ابتدا روی دکمه Fork کلیک کنید تا این ریپازیتوری را به حساب خود منتقل کنید.

2️⃣ Deploy روی Railway

وارد سایت Railway.app شوید.
روی New Project → Deploy from GitHub repo کلیک کنید.
ریپازیتوری Fork شده را انتخاب کنید.
Railway به‌صورت خودکار پروژه را Deploy می‌کند.

💡 پس از دیپلوی، یک دامنه عمومی (Public Domain) برای سرویس خود از تنظیمات Railway فعال کنید تا متغیر RAILWAY_PUBLIC_DOMAIN به‌درستی مقداردهی شود.

💾 ذخیره‌سازی دائمی (Volume)

وضعیت سرویس (کانفیگ‌ها، آمار مصرف، گروه‌های ساب، رمز ادمین) روی فایل x4g_state.json داخل مسیر DATA_DIR (پیش‌فرض /data) ذخیره می‌شود. برای این‌که این اطلاعات با هر ری‌استارت یا دیپلوی جدید روی Railway از بین نرود، حتماً یک Volume بسازید و آن را روی همان مسیر (/data) به سرویس متصل کنید (از تنظیمات سرویس → بخش Volumes). بدون این کار، اطلاعات فقط روی همان کانتینر فعلی می‌مانند و با تعویض کانتینر پاک می‌شوند.

3️⃣ اتصال به کانفیگ‌ها

پس از دیپلوی موفق:

به آدرس https://your-app.up.railway.app/dashboard بروید.
در صفحه داشبورد کلی، لینک VLESS پیش‌فرض (بدون محدودیت) را مشاهده و کپی کنید.
این لینک را در کلاینت دلخواه (v2rayNG، NekoBox، Streisand و...) وارد کنید.
برای ساخت لینک‌های جداگانه با محدودیت ترافیک، سرعت، آی‌پی و... به بخش مدیریت لینک‌ها بروید.

🔧 تنظیمات دستی هر کانفیگ

هنگام ساخت یا ویرایش هر کانفیگ می‌توانید این موارد را جداگانه تنظیم کنید:

پروتکل/ترابرد: vless-ws (VLESS روی WebSocket) یا یکی از حالت‌های XHTTP (xhttp-packet-up / xhttp-stream-up)
Fingerprint (uTLS): مقادیر chrome / firefox / safari / ios / android / edge / 360 / qq / random / randomized
ALPN: پیش‌فرض پروتکل، یا مقدار دستی مثل h2,http/1.1 یا http/1.1
پورت اتصال: هر پورتی بین 1 تا 65535 (نه فقط 443) — دقت کنید که این پورت باید واقعاً روی دامنه/سرویس شما باز و در دسترس باشد
محدودیت حجم: بر حسب KB/MB/GB (0 = نامحدود)
محدودیت سرعت: بر حسب Mbps، به‌صورت مستقل برای هر کانفیگ (0 = نامحدود)
محدودیت آی‌پی هم‌زمان: تعداد آی‌پی/کاربری که مجاز است هم‌زمان از همان کانفیگ استفاده کند (0 = نامحدود)
انقضا: تعداد روزهای اعتبار کانفیگ (بدون مقدار = بدون انقضا)

🗂 گروه‌های ساب (لینک ساب حرفه‌ای)

به‌جای لینک ساب ساده (/sub/{uuid} که فقط متن base64 کانفیگ رو برمی‌گردونه)، می‌تونید چند کانفیگ رو داخل یک گروه ساب قرار بدید تا یک صفحه‌ی عمومی و زیبا (/p/{uuid_key}) براشون ساخته بشه؛ شامل نمایش گرافیکی لیست کانفیگ‌ها، وضعیت هرکدوم، مصرف و QR Code، و در صورت نیاز قابل رمزدار کردن با پسورد. برای ساخت این لینک:

به بخش «گروه‌های ساب» در پنل (یا از طریق ربات تلگرام) بروید.
یک گروه جدید بسازید.
کانفیگ(های) مورد نظر را داخل همان گروه اضافه کنید.
لینک صفحه‌ی عمومی گروه را از همان‌جا کپی کنید.

🤖 ربات مدیریت تلگرام (اختیاری)

اگر می‌خواهید بدون باز کردن پنل وب، از طریق تلگرام کانفیگ‌ها را مدیریت کنید:

دو متغیر محیطی زیر را در تنظیمات سرویس Railway اضافه کنید:
- TELEGRAM_BOT_TOKEN — توکن ربات از @BotFather
- TELEGRAM_ADMIN_IDS — آیدی عددی تلگرام ادمین‌های مجاز، جدا شده با کاما (مثلاً 123456789,987654321)
بعد از ری‌استارت سرویس، به ربات پیام /start بدهید.

امکانات ربات:

📋 لیست، مشاهده، فعال/غیرفعال‌سازی و حذف کانفیگ‌ها
➕ ساخت کانفیگ جدید با یک ویزارد مرحله‌به‌مرحله (برچسب → پروتکل → Fingerprint → ALPN → پورت → محدودیت حجم → محدودیت سرعت → محدودیت آی‌پی → روز انقضا)
🔗 دریافت لینک اتصال VLESS و لینک ساب هر کانفیگ
🗂 ساخت و مدیریت گروه‌های ساب و دریافت لینک ساب حرفه‌ای مستقیماً داخل چت

⚙️ متغیرهای محیطی

متغیر	توضیح	پیش‌فرض
`ADMIN_PASSWORD`	رمز عبور ورود به داشبورد وب	`X4GKING`
`SECRET_KEY`	کلید امضای سشن/پسورد؛ اگر تنظیم نشود، خودکار ساخته و روی دیسک ذخیره می‌شود	—
`DATA_DIR`	مسیر ذخیره‌سازی وضعیت (نیازمند Volume دائمی)	`/data`
`TELEGRAM_BOT_TOKEN`	توکن ربات تلگرام (اختیاری)	—
`TELEGRAM_ADMIN_IDS`	آیدی عددی ادمین‌های مجاز ربات، جدا با کاما (اختیاری)	—
`RAILWAY_PUBLIC_DOMAIN`	دامنه عمومی سرویس؛ به‌صورت خودکار توسط Railway تنظیم می‌شود	`localhost`

⚠️ نکته مهم

اگرچه وضعیت سرویس (کانفیگ‌ها، آمار، گروه‌های ساب) روی دیسک ذخیره می‌شود، اما بدون اتصال یک Volume دائمی به مسیر DATA_DIR، این اطلاعات فقط داخل همان کانتینر فعلی باقی می‌مانند و با تعویض/بازسازی کانتینر روی Railway از بین می‌روند. حتماً طبق راهنمای بخش «ذخیره‌سازی دائمی» بالا، یک Volume متصل کنید.

X4G · پشتیبانی: لینک گروه

View on GitHub

Releases and announcements

1 total

9.5Update_9.5Jul 10, 2026124 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

Date	List	Rank	Stars gained
Jul 12, 2026	daily	#15	+3
Jul 11, 2026	daily	#12	+3
Jul 8, 2026	daily	#13	+6
Jul 7, 2026	daily	#10	+8

public-apis/public-apis
A collective list of free APIs
454.9K stars · Python
donnemartin/system-design-primer
Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.
362.2K stars · Python
practical-tutorials/project-based-learning
Curated list of project-based tutorials
277.2K stars · Python
NousResearch/hermes-agent
The agent that grows with you
227K stars · Python
Significant-Gravitas/AutoGPT
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
186.2K stars · Python
yt-dlp/yt-dlp
A feature-rich command-line audio/video downloader
183K stars · Python

x4gKing/X4GPublic

Star history

Contribution activity

Signals and awards

What X4G does

Where teams use it

Indie Game Development

Cross-Platform Porting

Interactive Simulations

Engine Prototyping

README

🚀 X4G

✨ ویژگی‌ها

1️⃣ Fork روی گیت‌هاب

2️⃣ Deploy روی Railway

💾 ذخیره‌سازی دائمی (Volume)

3️⃣ اتصال به کانفیگ‌ها

🔧 تنظیمات دستی هر کانفیگ

🗂 گروه‌های ساب (لینک ساب حرفه‌ای)

🤖 ربات مدیریت تلگرام (اختیاری)

⚙️ متغیرهای محیطی

⚠️ نکته مهم

Recent activity

Recent open issues

Releases and announcements

Commits per week

When work happens

Who is committing

Star history

Contribution activity

Signals and awards

What X4G does

Where teams use it

Indie Game Development

Cross-Platform Porting

Interactive Simulations

Engine Prototyping

README

🚀 X4G

✨ ویژگی‌ها

1️⃣ Fork روی گیت‌هاب

2️⃣ Deploy روی Railway

💾 ذخیره‌سازی دائمی (Volume)

3️⃣ اتصال به کانفیگ‌ها

🔧 تنظیمات دستی هر کانفیگ

🗂 گروه‌های ساب (لینک ساب حرفه‌ای)

🤖 ربات مدیریت تلگرام (اختیاری)

⚙️ متغیرهای محیطی

⚠️ نکته مهم

Recent activity

Recent open issues

Releases and announcements

Commits per week

When work happens

Who is committing

Trending appearances

Related repositories