nikvpn-iran

nikvpn-iran / nikvpn-codespace

Public

Free VLESS proxy using GitHub Codespaces - NikVPN for Iran

45
365
69% credibility
Found May 17, 2026 at 73 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

NikVPN Codespace is a free tool that helps people in regions with internet restrictions set up their own private proxy server using GitHub's free cloud computing service. Users fork the project, launch it with one click, and get a connection link they can use in popular VPN apps on their phones or computers. The service uses the VLESS protocol with xHTTP transport for reliable, censorship-resistant connections, and includes tips for keeping the cloud computer running longer.

How It Works

1
🔍 You hear about free internet access

A friend tells you about a way to browse freely using GitHub's free service, and shares a link to a project called NikVPN.

2
🍴 You copy the project to your account

With one click, you fork the repository to your own GitHub account so you can use it as your own personal setup.

3
🚀 You launch your personal proxy

You click a button to start a cloud computer that automatically sets up your private connection in about 2-3 minutes.

4
🔗 Your connection link appears

A special link shows up on your screen that connects your devices to your new private, fast proxy server.

5
📡 You make your connection visible

In the ports tab, you change one setting so your connection can be accessed from outside the cloud computer.

6
You connect your devices
📲
On your phone

You open v2rayNG, Nekobox, or Hiddify and import your link with one tap

💻
On your computer

You open v2rayN, Nekoray, or Hiddify and paste your connection link

🌍 You browse freely

Everything works! You can now access the open internet from your devices, and you have 60 free hours every month to use it.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 73 to 45 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is nikvpn-codespace?

This is a Shell-based project that turns GitHub Codespaces into a free VLESS proxy server. It downloads Xray-core, generates a unique UUID for your connection, and spins up a VLESS server with xHTTP transport on port 443. The setup runs entirely inside a Docker container, and you get a shareable VLESS link printed to your terminal. Everything happens in the cloud for free using your monthly 60 hours of Codespace time.

Why is it gaining traction?

The hook is obvious: free proxy infrastructure without needing a credit card or external server. Many developers in regions with heavy internet restrictions need quick access to uncensored connectivity, and this project leverages a legitimate free service to provide it. The setup is genuinely one-click after forking, and the README walks through every step including the tricky port visibility settings. The tmux keepalive trick is clever - it prevents the container from going idle by periodically hitting github.com, extending your session up to the 4-hour maximum.

Who should use this?

This is for developers in restricted network regions who need a temporary, free proxy for research or development work. It works with v2rayNG on Android, v2rayN on Windows, and Nekoray on Linux. If you need something more permanent or business-critical, look elsewhere - the Codespace will eventually time out and you must manually restart it. The project is narrowly scoped: it does one thing (VLESS proxy) and doesn't try to be a full VPN solution.

Verdict

This is a clever workaround that actually works as described. However, with only 45 stars and a credibility score of 0.699%, the project lacks community validation and long-term stability guarantees. The documentation is solid in Persian, but sparse in English. Consider it a temporary solution, not a reliable infrastructure component. For anything beyond casual use, pay for a proper VPN service.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.