sartoopjj

sartoopjj / vpn-over-github

Public

Tunnels TCP connections through GitHub. Supports gist and git transports

82
56
69% credibility
Found Apr 27, 2026 at 82 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

This tool tunnels your internet traffic through GitHub's gists or repositories to create a SOCKS5 proxy connection.

How It Works

1
📰 Discover the tunnel idea

You hear about a clever way to create a private internet path using your personal space on GitHub, perfect for testing or bypassing blocks.

2
💻 Set up the far-end helper

Download and run a small program on a remote computer with steady internet to act as the tunnel's exit point.

3
🔗 Link your spaces together

Share matching details from your GitHub account between the helper and your device, like a secret handshake.

4
▶️ Start the far-end helper

Turn on the helper program and let it quietly wait for your connections from afar.

5
📱 Launch on your device

Open the companion program on your computer or phone, matching the shared details.

6
📊 Watch the dashboard glow

A colorful screen shows live connections, speeds, and usage bars filling up as data flows.

🌐 Browse through your tunnel

Direct your web browser or apps through the new path and enjoy private, unrestricted access.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 82 to 82 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 vpn-over-github?

This Go tool tunnels TCP connections through GitHub using gist or git transports, turning your GitHub account into a makeshift relay for SOCKS5 proxies. Clients batch traffic into JSON payloads pushed to private gists or repos, while a server polls them to forward to the internet—think free TCP tunnel without extra servers. It solves quick remote access in firewalled setups, like routing VSCode or AnyDesk over GitHub.

Why is it gaining traction?

Unlike ngrok TCP tunnels or Cloudflare tunnels TCP, it leverages existing GitHub PATs for zero-infra TCP tunnels, with git transport dodging REST rate limits for sustained use. The client TUI dashboard tracks connections, quotas, and throughput in real-time, making it dead simple to monitor dev tunnels GitHub-style. Developers dig the hack: create TCP tunnels instantly, no billing, just a repo and token.

Who should use this?

Network engineers testing remote tunnels GitHub in censored regions, or ops folks needing quick TCP tunnels AnyDesk/SSH without WireGuard tunnels GitHub overhead. Ideal for frontend devs tunneling VSCode remote sessions, or anyone prototyping integrated tunnels GitHub over DNS/HTTPS/SSH alternatives.

Verdict

Fun proof-of-concept for free TCP tunnel needs, but 82 stars and 0.699999988079071% credibility score signal early-stage maturity—solid docs and tests, yet ToS violations and 100-500ms latency limit it to light interactive connections. Grab for PoCs, not prod.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.