explaingit

code-leafy/g2rayxcodeleafy

Analysis updated 2026-05-18

60ShellAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Bash panel that turns a free GitHub Codespace into a VLESS proxy server you manage through a menu driven terminal interface.

Mindmap

mindmap
  root((g2rayxcodeleafy))
    What it does
      VLESS proxy panel
      Runs in Codespaces
      Menu driven CLI
    Tech stack
      Bash
      Xray-core
    Use cases
      Free cloud proxy hosting
      QR code client setup
      Traffic monitoring
    Audience
      Developers
      Codespaces users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a personal VLESS proxy node using free GitHub Codespaces compute

USE CASE 2

Generate a QR code to connect a phone client to the proxy

USE CASE 3

Monitor live traffic and switch routing modes through a terminal menu

USE CASE 4

Subscribe to community donated proxy configs shared through the repo

What is it built with?

BashXray-core

How does it compare?

code-leafy/g2rayxcodeleafyayghri/i-have-adhdnikvpn-iran/nikvpn-codespace
Stars606165
LanguageShellShellShell
Setup difficultymoderateeasyeasy
Complexity3/51/52/5
Audiencedevelopervibe codergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Runs only inside GitHub Codespaces and requires curl, jq, and Bash 4.0 or newer, intended for educational and research use per the README's disclaimer.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

G2rayXCodeLeafy is an interactive Bash script that sets up and manages a VLESS proxy server using the Xray engine, designed specifically to run inside a GitHub Codespace rather than a traditional server. VLESS is a proxy protocol often used to route internet traffic through a remote server, commonly for bypassing network restrictions in regions with limited internet access. Once launched inside a Codespace, the script presents a menu driven panel in the terminal for generating and starting a proxy configuration, monitoring live traffic statistics, and producing a QR code that can be scanned to import the connection into a client app. It includes a keepalive loop meant to stop the Codespace from going idle and shutting down, automatic restarts if something fails, and support for switching between different routing modes such as automatic IP detection or a custom CDN route. The repository also maintains a shared text file of configuration links donated by other users of the project, which anyone can subscribe to. To use it, you fork the repository on GitHub, open a Codespace from your fork, and wait a few minutes for the environment to build. The panel script starts automatically in the terminal once the Codespace is ready, or can be run manually with a single command if it does not. The requirements are a GitHub account for Codespaces access, the curl and jq command line tools, and Bash version 4 or newer, with the underlying Xray engine detected and installed automatically. The README states plainly that the project is intended for educational and research purposes only, that the developer does not encourage bypassing network restrictions in violation of local law, and that users are responsible for complying with regulations in their own region. The project is written in Bash and released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through forking this repo and launching the panel in a GitHub Codespace.
Prompt 2
Explain the difference between the automatic detect, custom IP, and CDN routing modes in this panel.
Prompt 3
Show me how the auto-keepalive loop stops the Codespace from going idle.
Prompt 4
Help me understand the requirements and legal disclaimer before using this tool.

Frequently asked questions

What is g2rayxcodeleafy?

A Bash panel that turns a free GitHub Codespace into a VLESS proxy server you manage through a menu driven terminal interface.

What language is g2rayxcodeleafy written in?

Mainly Shell. The stack also includes Bash, Xray-core.

What license does g2rayxcodeleafy use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is g2rayxcodeleafy to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is g2rayxcodeleafy for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.