A powerful, interactive Bash panel to deploy and manage VLESS XHTTP configurations.
Built specifically for GitHub Codespaces. Fully automated, lightweight, and efficient.

📢 Community Donated Configs (SUB)

https://raw.githubusercontent.com/Code-Leafy/G2rayXCodeLeafy/main/configs.txt

Thank you to everyone who has contributed! Your donations help the community bypass restrictions with ease.
💡 Want to help? You can donate your config directly from the G2ray Panel CLI (Option 1) after generating it. Your privacy is fully protected!

---

📖 Tutorial & Disclaimer

👉Click here for the Step-by-Step Tutorial

[!IMPORTANT] Disclaimer: This project is provided for educational and research purposes only. The developer does not encourage or condone the use of this software for bypassing network restrictions in violation of local laws. Users are solely responsible for their actions and compliance with all applicable regulations in their region. The developer is not responsible for any misuse of this tool.

---

✨ Features

• ⚡ One-Click Deployment — Generate and start Xray engines in seconds.
• 🎛️ Interactive CLI Panel — A beautiful, menu-driven interface to manage your node.
• 🔄 Auto-Keepalive — Smart keepalive loops to prevent your Codespace from hibernating.
• 📡 Live Stats — Monitor traffic usage (RX/TX) and resource consumption in real-time.
• 🌍 Dynamic Routing — Switch between Auto-detect, Custom IPs, and CDN routes instantly.
• 🩺 Self-Healing — Auto-restart engine, public port management, and log monitoring.
• 📋 QR Generation — Generate shareable QR codes directly in your terminal.

---

📋 Requirements

Requirement	Notes
GitHub Account	To use Codespaces
curl / jq	Used for API interaction and JSON parsing
Xray-Core	The core engine (automatically detected/run)

---

🚀 Installation & Usage

Method 1: Standard (Terminal)

# Clone the repository
git clone https://github.com/Code-Leafy/G2ray-Panel.git
cd G2ray-Panel

# Run the panel
bash g2ray.sh

Method 2: Mobile / Web (No Terminal Required)

If you don't have Git installed or are using a phone, follow these steps:

1. Fork the Repo: Click the Fork button at the top right of this page to copy it to your account.
2. Create Codespace: Open your forked repository, click the green Code button, select the Codespaces tab, and then click Create codespace on main.
3. Wait for Load: Wait a few minutes for the environment to build.
4. Launch Panel: Once the terminal loads, the G2ray CLI panel will appear automatically!

First Run: The script will automatically detect that no configuration exists and prompt you to generate one.

---

🎮 Panel Controls

The G2ray Panel provides a full suite of tools:

• Core Controls: Generate configs, start/stop/restart the engine, and view QR codes.
• Configuration: Modify routing, change IPs, and tune the Keepalive frequency.
• Analytics: View real-time data usage, CPU/RAM usage of the engine, and check your Codespace quota/uptime.
• Logs: View the last 15 lines of the engine log to troubleshoot connectivity.

---

🛠️ How It Works

1. Panel initialized via Bash
   └─ Checks for existing config
      ├─ If missing: Runs setup/keygen
      └─ If present: Loads existing environment
2. Xray Engine execution
   └─ Configured with XHTTP protocol
   └─ API enabled for stats tracking
3. Keepalive mechanism
   └─ Background task prevents Codespace inactivity
   └─ Customizable interval (Normal/Aggressive/Economy)

---

📁 Repository Structure

G2ray-Panel/
├── g2ray.sh          # Main management panel
├── configs.txt       # Community donated configs
├── data/             # Configs, UUIDs, and PIDs
├── logs/             # Engine log files
└── README.md         # This file

---

📣 Channel & Support

Get the latest updates, configuration tips, and support on our Telegram channel.

---

⚖️ License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Made with ❤️ by Code-Leafy