fluxy
| Crates.io | fluxy |
| lib.rs | fluxy |
| version | 0.3.3 |
| created_at | 2024-11-13 14:16:34.934456+00 |
| updated_at | 2025-10-17 07:30:10.930156+00 |
| description | Async HTTP/SOCKS5 proxy with randomized source IP pools and UDP support |
| homepage | |
| repository | https://github.com/xxxbrian/fluxy |
| max_upload_size | |
| id | 1446550 |
| size | 72,165 |
Bojin Li (xxxbrian)
documentation
README
fluxy
High-performance HTTP & SOCKS5 proxy that rotates outbound addresses from configurable IPv4/IPv6 pools.
Features
- HTTP CONNECT proxy with full request forwarding.
- SOCKS5 proxy supporting TCP
CONNECTand UDPASSOCIATE. - 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-bindor--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