How popular is g2ray on GitHub?

edrisranjbar/g2ray has 2,613 stars and 8,358 forks on GitHub.

edrisranjbar/g2rayFork

AI summary: An automated setup tool for deploying a temporary, cloud-based VLESS proxy server using GitHub Codespaces.

Star on GitHub

Stars: 2.6K
Forks: 8.4K
Watchers: 12
Open issues: 0
Open PRs: 6
Contributors: ~2
Commits: 7
Branches: 1

DockerfileNo licenseCreated May 9, 2026Last push 4mo ago+1 this month

Quick answers

What is g2ray?: An automated setup tool for deploying a temporary, cloud-based VLESS proxy server using GitHub Codespaces.
What does g2ray do?: G2Ray streamlines the complex process of deploying a personal V2Ray (VLESS) proxy server by cleverly leveraging the free compute resources provided by GitHub Codespaces. Upon launching a Codespace from a forked repository, the tool executes an automated setup script that installs and configures all necessary networking dependencies within a few minutes. It then directly outputs a ready-to-use VLESS proxy link into the terminal, bypassing the need for personal infrastructure, credit cards, or complex manual server administration. This approach provides a rapid, cloud-based solution for circumventing network censorship effectively.
Who is g2ray for?: Users facing strict network restrictions who require a rapid, cost-free, and temporary method to deploy a personal proxy utilizing existing cloud infrastructure.
How do I get started with g2ray?: Fork the repository and click 'Create codespace on main'.
How popular is g2ray on GitHub?: edrisranjbar/g2ray has 2,613 stars and 8,358 forks on GitHub.

Star history

since Jul 29, 2026

2.6K stars as of Oct 2, 2026. Measured daily since Jul 29, 2026; GitHub no longer exposes earlier star timestamps.

Contribution activity

commits per day, last 52 weeks

7 commits in the last yearLessMore

What g2ray does

G2Ray streamlines the complex process of deploying a personal V2Ray (VLESS) proxy server by cleverly leveraging the free compute resources provided by GitHub Codespaces. Upon launching a Codespace from a forked repository, the tool executes an automated setup script that installs and configures all necessary networking dependencies within a few minutes. It then directly outputs a ready-to-use VLESS proxy link into the terminal, bypassing the need for personal infrastructure, credit cards, or complex manual server administration. This approach provides a rapid, cloud-based solution for circumventing network censorship effectively.

Users facing strict network restrictions who require a rapid, cost-free, and temporary method to deploy a personal proxy utilizing existing cloud infrastructure.

Automated Codespace Deployment: Executes all installation and server configuration processes automatically the moment the Codespace environment starts.
VLESS Protocol Generation: Creates a secure, standard VLESS proxy link that integrates effortlessly with popular clients like V2RayNG and Clash Meta.
Zero-Infrastructure Dependency: Operates entirely within GitHub's free monthly compute quota without requiring any VPS rental or payment information.
Terminal Output Integration: Displays the generated, configured proxy link directly in the integrated web terminal for immediate, simple user access.
Rapid Server Initialization: Completes the full server configuration, dependency installation, and startup process in approximately two to five minutes.

Where teams use it

Censorship Circumvention

Individuals operating in heavily restricted network environments deploy the proxy rapidly to bypass firewalls and access blocked global services.

Temporary Secure Browsing

Travelers quickly spin up a cloud-based proxy on untrusted public Wi-Fi networks to secure their traffic without purchasing a commercial VPN.

Proxy Client Testing

Network developers generate a temporary VLESS backend instantly to test the connection and import capabilities of custom routing applications.

Educational Exploration

Students safely analyze the automated deployment scripts to learn about remote server configuration and the inner workings of the VLESS protocol.

Getting started: Fork the repository and click 'Create codespace on main'.

README

master branch

G2Ray

Only works in places where you can open GitHub Codespaces

⚠️ Important Notice

Please read this before using this project:

This project creates and runs a V2Ray proxy server. While the intention is for legitimate use, we strongly recommend using a separate GitHub account (not your main account) when forking and running this project, as GitHub may restrict accounts that violate its terms of service.

Overview

G2Ray is an automated setup for running a VLESS proxy through GitHub Codespaces. It provides a quick way to set up your own proxy server for accessing content from restricted regions.

Setup

Create or use a secondary GitHub account (highly recommended)
Fork the repository to your account
Click the green "Code" button above
Go to the "Codespaces" tab
Click "Create codespace on main"
Wait for the setup to complete (usually 2-5 minutes)

How to Use

Wait for Codespace initialization - The setup process takes a few minutes. All dependencies and configurations will be installed automatically.
Get your VLESS link - Once ready, your VLESS proxy link will be printed directly in the terminal
Import the link - Copy the generated VLESS link and import it into:
- V2RayNG (Android)
- Clash Meta
- Or any other proxy application that supports VLESS

Important Notes

GitHub Codespaces Quota

GitHub provides 120 free compute hours per month (per core)
For a 2-core Codespace: 120 ÷ 2 = 60 hours/month
Stop your Codespace when not in use to preserve your hours
You can always restart it later when needed

Compatible Networks

Tested on Shecan (free plan). If these IPs work for you, the proxy should be functional:

63.141.252.203
50.7.5.83
94.130.50.12

If these IPs don't work, try different datacenters or ISPs from your region.

Troubleshooting

If the Codespace fails to start, try creating a new one
Check that your GitHub account has Codespaces enabled
Ensure you have enough compute hours remaining for the month
For network issues, try switching proxy protocols in your client app

Support the Project

If you find this project useful, consider supporting its development:

Cryptocurrency Donations

Bitcoin: bc1qdwdpeqv0l8ala8tm46rtfeghuxl70een84npj3
Ethereum: 0x695CCF873d51E4C2dC1321b405C63BFE99c5a536
Solana: C2d9u9nY2hZfxsi5Fwz1o5VjGGQujWmxeqZ3upKvHBfD
TON Coin: UQAjStDMoMUusqRAuQGZ0Qbc2Th45yUUMdKlbhQ_6aS2TWlD
Buy me a coffee ☕ (donate to the main REPO, he made it happen)

Disclaimer

This tool is provided for educational and legitimate use only. Users are responsible for complying with their local laws and regulations regarding proxy usage. The author is not responsible for any misuse or legal consequences arising from the use of this tool.

License

This project is open-source. Please check the LICENSE file for details.

View on GitHub

Recent activity

commits and pull requests

Update config.jsonOpen
#30 by sorenapd · updated 3mo ago
testClosed
#34 by farhadrm01 · updated 4mo ago
Original sourceClosed
#35 by yo-agile · updated 4mo ago
Add Shayan section to READMEClosed
#31 by shayantataloo7 · updated 4mo ago
Rename .devcontainer/devcontainer.json to ShayantClosed
#33 by shayantataloo7 · updated 4mo ago
G2rayClosed
#32 by shayantataloo7 · updated 4mo ago
Initial commitOpen
#29 by hoseinairdrops956-hash · updated 4mo ago
Initial commitClosed
#2 by bridgesidh-prog · updated 4mo ago
enhance: run startup shell script with pretty messages and the vless conf
edrisranjbar committed 9ac2ac5 · 4mo ago
Update README.md
edrisranjbar committed 2c85bb9 · 4mo ago
Update donation section with cryptocurrency wallets and payment gateway link
edrisranjbar committed a3ddf62 · 4mo ago
enhance: improve console output with clear, outstanding formatting and visual indicators
edrisranjbar committed c8bb81f · 4mo ago

Commits per week

last 52 weeks

7 commits in the last 52 weeks.

When work happens

weekday and hour

Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Who is committing