yprox

Crates.ioyprox
lib.rsyprox
version0.2.0
sourcesrc
created_at2023-09-11 15:54:25.449371
updated_at2023-11-13 15:21:46.46493
descriptionA modifying, multiplexer tcp proxy server tool and library.
homepage
repositoryhttps://github.com/fcoury/yprox
max_upload_size
id969742
size57,735
Felipe Coury (fcoury)

documentation

README

yprox

A modifying, multiplexer tcp proxy server tool and library.

Usage

As an executable

To use yprox as an executable, simply install it using Cargo:

cargo install yprox

Then, you can run it with:

yprox <listen_addr> <target_addr1>...<target_addrN>

For example:

yprox 127.0.0.1:8080 127.0.0.1:9000 127.0.0.1:9001

This will start a proxy server that listens on 127.0.0.1:8080 and forwards incoming connections to 127.0.0.1:9000 and 127.0.0.1:9001.

As a library

To use yprox as a library, add it to your Cargo.toml file:

[dependencies]
yprox = "0.1"

Then, you can use it in your code:

use yprox::proxy::Proxy;

#[tokio::main]
async fn main() {
    let listen_addr = "127.0.0.1:8080";
    let target_addrs = vec!["127.0.0.1:9000", "127.0.0.1:9001"];
    proxy(listen_addr, target_addrs).await.unwrap();
}

This will start a proxy server that listens on 127.0.0.1:8080 and forwards incoming connections to 127.0.0.1:9000 and 127.0.0.1:9001.

Using a modifying function

Optionally you can modify the data stream before forwarding it to the target. You can do that using the start_modifying function:

use yprox::proxy::Proxy;

#[tokio::main]
async fn main() {
    let listen_addr = "127.0.0.1:8080";
    let target_addrs = vec!["127.0.0.1:9000", "127.0.0.1:9001"];
    let modify_fn = |data: Vec<u8>| -> Vec<u8> {
        // Modify data here
        data
    };
    proxy(listen_addr, target_addrs, Some(modify_fn)).await.unwrap();
}
Commit count: 20

cargo fmt