A lightweight and fast proxy utility tries to include any useful features.
You may find some configuration samples here, it also serves as a reference for the JSON config format.
Install Rust: https://www.rust-lang.org/tools/install
Install nightly toolchain:
rustup default nightlyInstall a C compiler, e.g. GCC:
apt update && apt install gcc
# Or clang on macOS
# brew update && brew install clangClone & Build:
git clone https://github.com/eycorsican/leaf.git
cd leaf
git submodule init
git submodule update
cargo build -p leaf-binRun:
./target/debug/leaf -hYou may build leaf with a selected set of features.
By including only the demanded features, you will get an optimized artifact with smaller binary size and lower runtime memory footprint.
For example, this build command,
cargo build --release --manifest-path leaf-bin/Cargo.toml --no-default-features --features "leaf/config-json leaf/inbound-socks leaf/outbound-direct leaf/outbound-shadowsocks leaf/ring-aead"will result in an executable supports only the JSON config format, socks inbound, direct and shadowsocks outbounds.
Note that for proxy protocols with AEAD crypto functions, one of the leaf/ring-aead and leaf/openssl-aead features must be included. Similarly, one of the leaf/rustls-tls and leaf/openssl-tls must be included for leaf/outbound-tls feature.
Refer to leaf/Cargo.toml for a full list of available features.
App Store: https://apps.apple.com/us/app/leaf-lightweight-proxy/id1534109007
TestFlight: https://testflight.apple.com/join/std0FFCS
Demo for Developer: https://github.com/eycorsican/ileaf
Running as transparent proxy on OpenWrt:
# Install the TUN package.
opkg update && opkg install kmod-tun
# Get the default interface address.
ADDRESS=`ip route get 1 | awk '{print $7;exit}'`
# Get the default gateway address.
GATEWAY=`ip route get 1 | awk '{print $3;exit}'`
TUN_NAME=tun8
TUN_ADDRESS=172.16.0.2
TUN_GATEWAY=172.16.0.1
# Properly configure the config file.
cat <<EOF > cfg.conf
[General]
loglevel = debug
dns-server = 223.5.5.5, 1.1.1.1
dns-interface = $ADDRESS
always-real-ip = *
tun = $TUN_NAME, $TUN_ADDRESS, 255.255.255.0, $TUN_GATEWAY, 1500
[Proxy]
Direct = direct, interface=$ADDRESS
Proxy = ss, 1.2.3.4, 9999, encrypt-method=chacha20-ietf-poly1305, password=9999, interface=$ADDRESS
[Rule]
DOMAIN-SUFFIX, google.com, Proxy
FINAL, Direct
EOF
# Open another SSH session to run leaf with the config.
# It's important to run in a seperate window since we still need
# the variables defined above to continue our setup process.
# I suggest you use `screen`: opkg update && opkg install screen
leaf -c cfg.conf
# Route traffic initiated from leaf to the original gateway.
ip route add default via $GATEWAY table default
ip rule add from $ADDRESS table default
# Route local traffic to TUN.
ip route del default table main
ip route add default via $TUN_GATEWAY
# Route traffic from other deivces to TUN.
iptables -I FORWARD -o $TUN_NAME -j ACCEPTRe-run:
# Stop leaf via ctrl+c.
# Make some changes to your `cfg.conf`.
# Re-run leaf.
leaf -c cfg.conf
# Re-add the default route to TUN.
ip route add default via $TUN_GATEWAYRecover the original network:
# Stop leaf via ctrl+c.
# Remove iptables rules.
iptables -D FORWARD -o $TUN_NAME -j ACCEPT
# Cleanup the routing table.
ip rule del from $ADDRESS
ip route del default table default
# Recover the original default route.
ip route add default via $GATEWAYCheck if everything looks fine:
iptables -L FORWARD -n
ip route show table main
ip route show table default
ip rule show