# SadeghHayeri/GreenTunnel

GreenTunnel is an anti-censorship utility designed to bypass the DPI system that is put in place by various ISPs to block access to certain websites.

Repository: https://github.com/SadeghHayeri/GreenTunnel
Canonical: https://ross.abutalabs.com/products/greentunnel
Language: TypeScript
License: MIT
License Family: permissive
Topics: dpi, filtering, isp, sni, deep-packet-inspection, proxy, vpn, socks, firewall-bypass
Last push: 2026-08-11T15:21:52+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 95, longevity 100
- inputs: {"age_days": 2728, "days_push": 22, "days_rel": 38, "gap_med": 0, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4902, forks 309 (observed 2026-08-28T04:09:02.123946+00:00)

## What it is
GreenTunnel is an anti-censorship tool that bypasses ISP Deep Packet Inspection (DPI) systems by splitting TLS ClientHello packets and using encrypted DNS (DoH/DoT). It ships as a CLI, a library, and an Electron desktop app that runs a local proxy.

## Use cases
- bypass ISP website blocking caused by deep packet inspection
- access blocked websites without a VPN
- prevent DNS-based blocking by resolving DNS over HTTPS
- split TLS ClientHello so the SNI hostname is not visible to DPI
- run a local proxy to defeat hostname-based censorship
- restore system proxy settings automatically after crashes

## When to choose
- your ISP blocks sites via DPI based on hostname/SNI inspection
- you need lightweight censorship circumvention without hiding your IP
- you want encrypted DNS (DoH/DoT) to avoid DNS-level blocking
- you prefer a simple desktop app or CLI over configuring a full VPN

## When to avoid
- you need to hide your IP address or location - it is not a VPN
- censorship is not hostname/DPI-based (e.g., IP blocking or port filtering)
- you need full traffic encryption or anonymity
- your environment cannot run Node.js 24+ or install a local proxy

## Facets
- artifact type: application
- maturity: active
- function: proxy, security, networking, privacy, cli
- domain: censorship-circumvention, privacy, networking, security
- platform: cross-platform, cli
- tags: anti-censorship, dpi-bypass, sni-splitting, dns-over-https, dns-over-tls, electron-app, local-proxy, firewall-bypass, nodejs, desktop, docker

## Member repositories
- SadeghHayeri/GreenTunnel (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:02.123946+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:18:08.230877+00:00, confidence not recorded.
  - readme: https://github.com/SadeghHayeri/GreenTunnel (fetched 2026-08-28T04:09:02.123946+00:00, sha ff3babeb5c17)
- Data as of 2026-08-30T08:39:29.467469+00:00.