nikvpn-iran/nikvpn-codespace — explained in plain English
Analysis updated 2026-05-18
Bypass government internet filtering from a phone or computer
Access blocked websites using a free GitHub Codespace as the server
Get a VLESS connection link to import into a proxy client app
Keep the Codespace proxy alive during longer browsing sessions
| nikvpn-iran/nikvpn-codespace | filipedeschamps/dotfiles | ayghri/i-have-adhd | |
|---|---|---|---|
| Stars | 65 | 67 | 61 |
| Language | Shell | Shell | Shell |
| Last pushed | — | 2025-04-23 | — |
| Maintenance | — | Stale | — |
| Setup difficulty | easy | moderate | easy |
| Complexity | 2/5 | 2/5 | 1/5 |
| Audience | general | developer | vibe coder |
Figures from each repo's GitHub metadata at analysis time.
Free GitHub account gives 60 hours of Codespace runtime per month.
NikVPN Codespace is a tool for people in Iran who want free internet access past government-imposed filtering. It sets up a VLESS proxy, a type of encrypted tunnel that disguises your internet traffic so it is harder for filtering systems to detect and block, using GitHub Codespaces as the underlying server infrastructure. A codespace is a free cloud computer that GitHub provides for running development environments, this project hijacks that free resource to host the proxy server instead. The setup takes under five minutes. You fork the repository on GitHub, launch a Codespace from it, and the startup scripts automatically install and run Xray-core (the proxy engine) inside a Docker container. Once running, the terminal prints a VLESS connection link that you import into a proxy client app on your phone or computer. Supported client apps include v2rayNG and Nekobox on Android, Streisand and FoXray on iOS, and v2rayN or Nekoray on Windows and Linux. The project includes a keepalive mechanism so the Codespace stays awake and does not go to sleep during use. The transport protocol is VLESS over xHTTP, which is designed to blend in with regular web traffic and resist deep packet inspection (the method Iran's filtering system uses to detect VPNs). You would use this if you are in Iran and need a free, no-registration way to bypass internet censorship for accessing blocked websites. GitHub's free tier provides 60 hours of Codespace runtime per month. The project is written in Shell and requires only a free GitHub account.
A free tool for people in Iran that sets up an encrypted VLESS proxy on GitHub Codespaces to bypass government internet filtering in under five minutes.
Mainly Shell. The stack also includes Shell, Docker, Xray-core.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.