ParsaKSH/spoof-tunnel
client-server tunnel with IP-Spoofing
Build with Backblaze B2
SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.
Loading star history...
Where it stands
Rank, growth pace and release cadence relative to everything GStars tracks.
No releases in the last 90 days; the most recent was 157 days ago, with 2 contributors on GitHub.
Peaked at #83 in the weekly ranking the week of Apr 26, its best in the past year.
Use Cases & Benefits
- Implements a client-server tunnel using mutual bidirectional IP spoofing to bypass Layer 3 firewalls and Deep Packet Inspection.
- Enables stealthy, stateful connection bypass by decoupling logical sessions from physical IP addresses using raw socket packet forging.
- Use for circumventing internet censorship in restrictive environments with strict IP-based firewall rules.
- Use for establishing secure SOCKS5 proxy tunnels over ICMP or UDP in networks blocking conventional VPN or proxy protocols.
- Use for research and testing of advanced network evasion techniques leveraging eBPF and custom TCP-like reliability over spoofed IP packets.
Should you depend on it?
License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.
License
Apache 2.0
Permissive: commercial use, modification and redistribution are allowed with attribution; includes an explicit patent grant from contributors.
Community files
- README: present
Watch-outs
- Owned by an individual account with only 2 contributors on GitHub; plan for bus-factor risk.
General guidance from repository metadata, not legal advice. How we score
From the README
Spoof Tunnel is a Layer 3/Layer 4 tunneling proxy designed to bypass Deep Packet Inspection (DPI) and strict stateful firewalls through mutual bidirectional IP spoofing.
Unlike traditional tunneling protocols that establish a stateful connection between a fixed client IP and a fixed server IP, Spoof Tunnel completely decouples the logical session from the physical network addresses by forging the
Source IPfield in the IP header at both endpoints.The concept of a bidirectional spoofing tunnel emerged in response to the severe internet blackout in Iran following the bloody uprising on January 8 and 9, 2026 (18-19 Dey 1404). During this complete disconnection from the global internet, our primary objective was to reverse-engineer the exact scope and layer of the imposed restrictions.
Upon investigating the BGP routes for Iranian IP prefixes, we observed a surprising detail: unlike the internet shutdown in Afghanistan where BGP routes simply disappeared, Iran's IP ranges were still actively being announced globally. This strongly indicated that the international physical infrastructure was still intact.
Subsequently, it became apparent that certain government-affiliated Iranian entities were able to whitelist their specific IP addresses, successfully restoring their international connectivity. This observation led to the hypothesis that the restriction was being enforced at Layer 3, specifically filtering based on srcIP and dstIP.
Daily snapshots
Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots
Forks
114+13
Open issues
16-1
Compared with peers in Backend
Fastest-growing repositories GStars tracks in this cohort for the week of Nov 1, by 7-day star growth
| Repository | Stars | +7d | Health | Last release |
|---|---|---|---|---|
| anthropics/skills | 187.8K | +2.9K | 15 | — |
| DuarteSantos8/openGym | 19.7K | +2.4K | 60 | 2 days ago |
| shiyu-coder/Kronos | 47.0K | +2.3K | 16 | — |
| NationalSecurityAgency/ghidra | 98.2K | +2.3K | 64 | 14 days ago |
| microsoft/VibeVoice | 56.0K | +1.1K | 29 | — |
| ParsaKSH/spoof-tunnel | 361 | — | 18 | 157 days ago |
| Category median | 56.0K | +2.3K | 29 | — |
Discover Repositories
Search across tracked repositories by name or description