Skip to content

Sonys9/rproxy-hub

RProxy Hub

Rust Proxy Hub

⚡️ Blazing fast traffic forwarder using proxies ⚡️

🛠 Currently it's in developing 🛠

App Logo

Why?

  • 🔥 Blazingly fast — Built in pure Rust with zero garbage collection. It just flies.
  • 🦀 Guaranteed stability — Compiler-enforced memory safety means no random segfaults or runtime crashes.
  • Async under the hood — Driven by Tokio to handle thousands of concurrent proxy connections with near-zero latency.
  • 🎨 Clean CLI — Features good interface and high customizable banner system

🚀 Usage & CLI Arguments

You can configure the application using the following command-line arguments:

Argument Short Long Default Required Description
<FORWARD TO IP> Yes Forward to destination IP address and port (e.g., 46.174.54.240:8308).
<PATH TO PROXIES> Yes Path to the file containing the list of proxies.
<LISTEN IP> -l --listen-ip 127.0.0.1:0 No Local IP address and port to bind and listen on.
-s --silent false No Do not print the application startup banner.

Example Command

RUST_LOG=info cargo run --release 46.174.54.240:8308 proxies.txt --listen-ip 127.0.0.1:3000

Important

This app only supports HTTP, HTTPS and SOCKS v4/v5 proxies. Many standard HTTP/SOCKS proxies only forward TCP traffic. If you encounter connectivity issues with UDP-based targets, verify that your listed proxies have UDP forwarding enabled.

🗺️ Banner Placeholders Reference

You can fully customize the application startup banner using dynamic template tags. The parser will automatically replace these tags with live server configurations and ANSI colors.

🧩 System Variables

Use these placeholders to display live runtime information from your configuration:

Placeholder Description Example Output
%app_version% Application version parsed from Cargo.toml 0.1.0
%listen_ip% The IP and port the server is currently binding to 127.0.0.1:0
%forward_to% The destination target IP and port for routing 12.67.12.8:9822
%proxies_path% System path pointing to your active proxy list file proxies.txt

🎨 Color & Styling Markers

You can style text, background, and font weights using both standard named profiles, text styles, and 24-bit TrueColor (RGB).

1. Text (Foreground) Styling

  • %color_fg_rgb_R_G_B% — Set raw 24-bit TrueColor text color. Replace R, G, B with numbers from 0 to 255.
    • Example: %color_fg_rgb_255_165_0% creates orange text.
  • %color_fg_NAME% — Set text color by its standard name string.
    • Available names: Defined in COLORS map within colors.rs (e.g., red, green, yellow, blue, magenta, cyan, white, black).

2. Background Styling

  • %color_bg_rgb_R_G_B% — Set raw 24-bit TrueColor background color using numbers from 0 to 255.
  • %color_bg_NAME% — Set background color by its standard name string (uses the same color list as foreground).

3. Text Styles & Resets

  • %color_STYLE% — Apply specific text formatting or resets.
    • Available styles: reset, bold, dim, italic, underline, blink, invert.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Code of Conduct

This project adheres to a Code of Conduct. By participating, you are expected to uphold this code.

Security

For security concerns, please refer to our Security Policy.

Releases

No releases published

Packages

 
 
 

Contributors

Languages