# eycorsican/leaf

A versatile and efficient proxy framework.

Repository: https://github.com/eycorsican/leaf
Canonical: https://ross.abutalabs.com/products/eycorsican-leaf
Language: Rust
License: Apache-2.0
License Family: permissive
Last push: 2026-06-18T05:29:10+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 88, release rhythm 72, longevity 100
- inputs: {"age_days": 2166, "days_push": 76, "days_rel": 189, "gap_med": 9.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2820, forks 509 (observed 2026-08-28T04:07:23.930250+00:00)

## What it is
Leaf is a versatile and efficient proxy framework written in Rust, supporting multiple proxy protocols such as Shadowsocks, Trojan, VMess, Vless, and SOCKS5. It provides transparent proxying via TUN and NetFilter, transports like WebSocket, TLS, and QUIC, plus traffic control features like proxy chaining and failover.

## Use cases
- build a custom proxy client in Rust
- run a transparent VPN-like proxy on mobile or desktop
- set up Shadowsocks or Trojan tunnels with TLS and WebSocket
- chain multiple proxies with failover and health checks
- aggregate bandwidth across multiple links with multi-path transport
- embed proxy functionality into an iOS or Android app

## When to choose
- you need a Rust-based, embeddable proxy framework across many platforms
- you want modern transports like QUIC, Reality, or multiplexing
- you need transparent proxying via TUN on Linux, macOS, Windows, iOS, or Android

## When to avoid
- you only need a simple ready-made proxy client with a GUI
- you require inbound VMess/Vless support, which is not implemented
- you need TPROXY-based transparent proxying on Linux today, as it is not yet supported

## Facets
- artifact type: framework
- maturity: active
- function: proxy, networking, security, privacy
- domain: networking, privacy, security, cross-platform
- platform: windows, rust, cli
- tags: shadowsocks, trojan, vmess, vless, tun, transparent-proxy, proxy-chaining, quic, websocket-transport, multiplexing, linux, macos, android, ios

## Member repositories
- eycorsican/leaf (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:23.930250+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:38:19.897736+00:00, confidence not recorded.
  - readme: https://github.com/eycorsican/leaf (fetched 2026-08-28T04:07:23.930250+00:00, sha 8349e78b404c)
- Data as of 2026-08-30T08:39:29.467469+00:00.