ParsaKSH

    ParsaKSH/spoof-tunnel

    client-server tunnel with IP-Spoofing

    backend
    ebpf
    internet-censorship
    layer3-firewall-bypass
    spoof
    spoofing-tunnel
    Go
    Apache-2.0
    361 stars
    114 forks
    361 GitHub watchers
    Updated Oct 27, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    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 IP field 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.

    Excerpt from the ParsaKSH/spoof-tunnel README on GitHub (Apache-2.0 license). © its authors.Read the full README on GitHub

    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

    ParsaKSH/spoof-tunnel compared with Backend repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    anthropics/skills187.8K+2.9K15—
    DuarteSantos8/openGym19.7K+2.4K602 days ago
    shiyu-coder/Kronos47.0K+2.3K16—
    NationalSecurityAgency/ghidra98.2K+2.3K6414 days ago
    microsoft/VibeVoice56.0K+1.1K29—
    ParsaKSH/spoof-tunnel361—18157 days ago
    Category median56.0K+2.3K29—

    Discover Repositories

    Search across tracked repositories by name or description