Lib.rs

› Command line utilities | Network programming
#socks5-proxy #udp #http-proxy #http #ip-pool

app fluxy

Async HTTP/SOCKS5 proxy with randomized source IP pools and UDP support

by xxxbrian

9 releases

0.3.3 Oct 17, 2025
0.3.2 Oct 17, 2025
0.2.2 Oct 11, 2025
0.1.3 Oct 11, 2025
0.1.1 Nov 16, 2024

#1082 in Command line utilities

MIT license

42KB
966 lines

fluxy

High-performance HTTP & SOCKS5 proxy that rotates outbound addresses from configurable IPv4/IPv6 pools.

github crates.io license

Features

  • HTTP CONNECT proxy with full request forwarding.
  • SOCKS5 proxy supporting TCP CONNECT and UDP ASSOCIATE.
  • Address pool randomisation: each outbound connection or datagram binds to a random IP drawn from the subnets you provide (-4 / -6).
  • Structured tracing with per-connection IDs, pluggable log levels, and consistent formatting.
  • Async, Tokio-based architecture tuned for low overhead.

Installation

cargo install fluxy

Build from source:

git clone https://github.com/xxxbrian/fluxy.git
cd fluxy
cargo build --release

The release binary will be available at target/release/fluxy.

Pre-built archives for popular targets are published on the GitHub Releases page.

Usage

fluxy \
  --http-bind 127.0.0.1:6152 \
  --socks-bind 127.0.0.1:6153 \
  --ipv4-subnet 44.31.223.0/24 \
  --ipv6-subnet 2a0e:aa07:e0a0::/48 \
  --log debug

CLI flags

Flag Description
-H, --http-bind <ADDR> Listen address for the HTTP proxy.
-S, --socks-bind <ADDR> Listen address for the SOCKS5 proxy.
-4, --ipv4-subnet <CIDR> IPv4 subnet used for outbound socket binding (optional).
-6, --ipv6-subnet <CIDR> IPv6 subnet used for outbound socket binding (optional).
--log <LEVEL> Log level (trace, debug, info, warn, error). Defaults to info.
-v, --version Print version information and exit.
-h, --help Show the help text.

Supply at least one of --http-bind or --socks-bind. Supplying both runs both proxies concurrently.

Preparing address pools

Fluxy binds every outbound socket to a random address within the subnets you configure. These source addresses must be routable on your host. For local testing (or when operating as a BGP player with many announced prefixes), assign the pool or a subset of addresses to a loopback/VRF interface before starting the proxy:

# Linux
sudo ip addr add 44.31.223.0/24 dev lo

# macOS
sudo ifconfig lo0 alias 44.31.223.0 255.255.255.0

License

MIT © Bojin Li

Dependencies

~14–28MB
~292K SLoC