Crate mproxy_reverse

source ·
Expand description

Multicast Network Dispatcher and Proxy

MPROXY: Reverse Proxy

Forward upstream TCP and UDP upstream to downstream listeners. Messages are routed via UDP multicast to downstream sender threads. Spawns one thread per listener.

Quick Start

In Cargo.toml

[dependencies]
mproxy-reverse = "0.1"

Example src/main.rs

use mproxy_reverse::{reverse_proxy_tcp_udp, reverse_proxy_udp, reverse_proxy_udp_tcp};

pub fn main() {
    let udp_listen_addr: Option<String> = Some("0.0.0.0:9920".into());
    let tcp_listen_addr: Option<String> = None;
    let multicast_addr: String = "[ff02::1]:9918".into();
    let tcp_output_addr: Option<String> = Some("[::1]:9921".into());
    let udp_output_addr: Option<String> = None;

    let mut threads = vec![];

    // TCP connection listener -> UDP multicast channel
    if let Some(tcpin) = tcp_listen_addr {
        let tcp_rproxy = reverse_proxy_tcp_udp(tcpin, multicast_addr.clone());
        threads.push(tcp_rproxy);
    }

    // UDP multicast listener -> TCP sender
    if let Some(tcpout) = &tcp_output_addr {
        let tcp_proxy = reverse_proxy_udp_tcp(multicast_addr.clone(), tcpout.to_string());
        threads.push(tcp_proxy);
    }

    // UDP multicast listener -> UDP sender
    if let Some(udpout) = udp_output_addr {
        let udp_proxy = reverse_proxy_udp(multicast_addr, udpout);
        threads.push(udp_proxy);
    }

    for thread in threads {
        thread.join().unwrap();
    }
}

Command Line Interface

Install with Cargo

cargo install mproxy-reverse
MPROXY: Reverse Proxy

Forward upstream TCP and UDP upstream to downstream listeners.
Messages are routed via UDP multicast to downstream sender threads.
Spawns one thread per listener.

USAGE:
  mproxy-reverse  [FLAGS] [OPTIONS]

OPTIONS:
  --udp-listen-addr [HOSTNAME:PORT]     Spawn a UDP socket listener, and forward to --multicast-addr
  --tcp_listen_addr [HOSTNAME:PORT]     Reverse-proxy accepting TCP connections and forwarding to --multicast-addr
  --multicast-addr  [MULTICAST_IP:PORT] Defaults to '[ff02::1]:9918'
  --tcp-output-addr [HOSTNAME:PORT]     Forward packets from --multicast-addr to TCP downstream
  --udp_output_addr [HOSTNAME:PORT]     Forward packets from --multicast-addr to UDP downstream

FLAGS:
  -h, --help    Prints help information
  -t, --tee     Print UDP input to stdout

EXAMPLE:
  mproxy-reverse --udp-listen-addr '0.0.0.0:9920' --tcp-output-addr '[::1]:9921' --multicast-addr '224.0.0.1:9922'

See Also

Functions

reverse_proxy_tcp_udp
Listen for incoming TCP connections and forward received bytes to a UDP socket address
reverse_proxy_udp
Forward bytes from UDP upstream socket address to UDP downstream socket address
reverse_proxy_udp_tcp
Forward a UDP socket stream (e.g. from a multicast channel) to connected TCP clients. Spawns a listener thread, plus one thread for each incoming TCP connection.