# Geph

Geph (迷霧通) is a modular Internet censorship circumvention system designed specifically to deal with national filtering.

Repository: https://github.com/geph-official/geph4-client
Canonical: https://ross.abutalabs.com/products/geph
Homepage: https://geph.io
Language: Rust
License: GPL-3.0
License Family: copyleft
Topics: vpn, circumvention, rust
Last push: 2025-02-13T15:12:15+00:00
Link (homepage): https://geph.io

## Health v2 (maintenance only)
Score: 35/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 6, release rhythm 35, longevity 100
- inputs: {"age_days": 2180, "days_push": 566, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3033, forks 351 (observed 2026-08-28T04:07:38.996724+00:00)

## What it is
Geph (迷霧通) is a modular Internet censorship circumvention system designed to defeat national-level filtering such as China's Great Firewall and Iranian censorship. The geph4-client is its Rust command-line client that establishes resilient tunnels to exit servers through rotating bridge relays, exposing local SOCKS5/HTTP proxies and VPN-mode routing.

## Use cases
- bypass the Great Firewall from China
- circumvent national internet censorship in Iran
- route traffic through a censorship-resistant SOCKS5 proxy
- run a VPN client that resists ISP-level blocking
- connect to the internet through rotating bridge relays when exit servers are blocked
- proxy applications over an obfuscated tunnel from the command line

## When to choose
- you need to bypass sophisticated national-level censorship like the GFW
- you want a VPN whose servers cannot link browsing activity to your identity via blind-signature auth
- you need a lightweight CLI client with local SOCKS5/HTTP proxies
- you want automatic failover across multiple obfuscated routes and bridges

## When to avoid
- you just need a general-purpose VPN for streaming or privacy from advertisers, not censorship resistance
- you need a fully decentralized system (decentralization via Earendil is still in progress)
- you require a GUI-only experience without touching configuration
- you need a widely audited, mainstream VPN with large third-party review

## Facets
- artifact type: application
- maturity: active
- function: vpn, proxy, networking, security, privacy, cli
- domain: privacy, censorship-circumvention, networking, security, cross-platform
- platform: windows, rust, cli, cross-platform
- tags: censorship-circumvention, anti-censorship, great-firewall, socks5-proxy, obfuscation, blind-signatures, two-hop-architecture, linux, macos, android, ios

## Member repositories
- geph-official/geph4-client (main) score 35
- geph-official/geph2 (mirror) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:38.996724+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-30T07:29:46.780856+00:00, confidence not recorded.
  - readme: https://github.com/geph-official/geph4-client (fetched 2026-08-28T04:07:38.996724+00:00, sha b207ccb5a71a)
  - homepage: https://geph.io (fetched 2026-08-29T09:44:41.728083+00:00, sha 8230de7bc7bd)
  - registry_crates: https://crates.io/api/v1/crates/geph4-client (fetched 2026-08-29T09:44:41.743557+00:00, sha 13859aa35ddb)
- Data as of 2026-08-30T08:39:29.467469+00:00.