G2rayXCodeLeafy is a powerful, interactive web panel dashboard designed to instantly deploy and manage Xray VLESS xHTTP configurations. Built specifically for the GitHub Codespaces environment, it automates port management, client creation, subscription generation, traffic monitoring, and connection controls through a modern browser-based UI.
Once the Python backend starts, it serves a full dashboard on the forwarded Codespaces web port. From there, you can manage clients, preview generated configs, copy subscription links, view logs, monitor usage, and control the Xray core without using a terminal UI.
Note: The panel includes an optional background wake-lock/keepalive feature to help keep the Codespace active while the proxy is in use. Use this feature at your own risk and follow GitHub Codespaces usage policies.
🔗 Community Donated Configs (SUB)
Want to use public nodes donated by other G2ray users? Import this subscription link directly into your V2ray/Xray client:
https://raw.githubusercontent.com/Code-Leafy/G2rayXCodeLeafy/main/configs.txt
Manage everything from a clean browser UI instead of a terminal/curses interface. Create clients, edit limits, view QR codes, copy subscription links, restart Xray, and monitor the system from one dashboard.
Generate VLESS xHTTP client links and subscription outputs for GitHub Codespaces forwarding domains. The panel is designed around modern Xray clients and avoids deprecated insecure TLS options.
Tracks real-time RX/TX data consumption, connection status, Xray uptime, CPU/RAM usage, disk usage, and estimated Codespaces free-tier quota.
Build custom per-client subscription layouts directly in the web panel. Add proxy entries, info entries, placeholders, custom names, usage indicators, and live mobile-style previews.
Includes optional controls for keeping the runtime active while the service is in use. This can be toggled from the web dashboard.
Donate a generated config from the panel to share access with the community while keeping your personal clients separate.
| 🛠️ Configuration Optimizer |
|---|
| To finalize your setup, take the config received from the panel and visit NetLeafy. Set the server mode to G2ray and paste your link to generate a fully optimized connection. |
No local installation required.
-
Fork the Repository: Click Fork at the top-right of this GitHub page.
-
Create a Codespace: Open your fork → Click the green Code button → Codespaces tab → Create codespace on main.
-
Wait for Environment: Allow 1–2 minutes for the container to build.
-
Launch Backend: The
g2leafy.pybackend should start automatically in the integrated VS Code terminal. -
Open Web Dashboard: Open the forwarded web port URL printed in the terminal. It will look similar to:
https://<your-codespace-name>-8080.app.github.dev/
When launched, the backend prints your dashboard and Xray forwarding URLs in the terminal.
# If the backend does not start automatically for any reason, run:
python3 g2leafy.pyThen open the dashboard URL in your browser:
https://<your-codespace-name>-8080.app.github.dev/
Inside the web dashboard, you can:
- View live traffic, speed, uptime, and hardware usage from Dashboard.
- Manage Codespaces region/IP/quota details from Codespace Settings.
- Create, edit, enable, disable, delete, and QR-share clients from Client Profiles.
- Build custom per-client subscriptions from Subscription Lab.
- Configure routing, DNS, sniffing, logging, and core options from Advanced Settings.
- View Xray and panel logs from Console Logs.
Opening the Xray forwarded port directly in a browser may show
400. That is normal for VLESS xHTTP. Use the generated VLESS or subscription link in a compatible client instead.
graph LR
A[GitHub Codespace] -->|Runs| B[G2Leafy Python Backend]
B -->|Serves Web UI on 8080| C[Browser Dashboard]
B -->|Generates Config| D[Xray-core]
D -->|Binds Port 443| E[Codespace App Domain]
E -->|VLESS over xHTTP| F[End User Client]
📁 Project Structure
G2rayXCodeLeafy/
├── data/ # Dynamic storage for usage stats, UUIDs, panel state, and configs
├── logs/ # Xray and panel logs
├── assets/ # Media resources, previews, and videos
├── configs.txt # Community donated subscription configs
└── g2leafy.py # Python backend, web dashboard server, and Xray manager
❓ FAQ & Troubleshooting
No. Current versions use a web panel dashboard. The terminal is only used to start the Python backend and print the dashboard URL.
Open the forwarded web port, usually:
https://<your-codespace-name>-8080.app.github.dev/
That is expected. Port 443 is used by Xray VLESS xHTTP, not the web dashboard. Browsers send normal HTTP requests, while Xray expects xHTTP proxy traffic. Use the generated config in your V2ray/Xray client.
Open Codespace Settings in the dashboard and enable the optional wake-lock feature if you understand the risks. Make sure your usage complies with GitHub Codespaces policies.
For optimal routing, try setting your GitHub Codespace region to a nearby or well-connected region such as Europe West in your GitHub account settings.
Make sure the generated config uses the Codespaces forwarding domain for sni and host. Modern Xray versions removed deprecated allowInsecure behavior. The panel should generate configs without allowInsecure and rely on valid TLS verification for *.app.github.dev.
⚠️ Educational Purpose Only: This project is provided for educational and research purposes. Users are solely responsible for compliance with all local laws. The developer assumes no liability for misuse.
MIT License · Crafted by Code-Leafy