Struct DownstreamProxy 

pub struct DownstreamProxy { /* private fields */ }

Proxy that accepts TCP connections and forwards them over iroh.

The downstream proxy is the client-facing component that receives incoming TCP connections (typically HTTP requests) and routes them to upstream proxies via iroh’s peer-to-peer QUIC connections.

Modes

• TCP mode: Blindly tunnels all traffic to a fixed upstream destination.
• HTTP mode: Parses HTTP requests to enable dynamic routing and supports both forward proxy (absolute-form) and reverse proxy (origin-form) requests.

Connection Pooling

Maintains a pool of iroh connections to upstream endpoints for efficiency. Multiple requests to the same endpoint share a single QUIC connection.

Implementations

impl DownstreamProxy

pub fn new(endpoint: Endpoint, pool_opts: PoolOpts) -> Self

Creates a downstream proxy with the given endpoint and pool options.

pub fn metrics(&self) -> &Arc<DownstreamMetrics>

Returns the downstream metrics tracker.

pub async fn create_tunnel( &self, destination: &EndpointAuthority, ) -> Result<TunnelClientStreams, ProxyError>

Opens a CONNECT tunnel to the upstream proxy and returns the client streams.

Note: any non-200 OK response from upstream is returned as a ProxyError.

pub async fn forward_tcp_listener( &self, listener: TcpListener, mode: ProxyMode, ) -> Result<()>

Accepts TCP connections from the listener and forwards each in a new task.

Runs indefinitely until the listener errors or the task is cancelled.

pub async fn forward_uds_listener( &self, listener: UnixListener, mode: ProxyMode, ) -> Result<()>

Accepts UDS connections from the Unix Domain Socket and forwards each in a new task.

Runs indefinitely until the listener errors or the task is cancelled.

Trait Implementations

impl Clone for DownstreamProxy

fn clone(&self) -> DownstreamProxy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DownstreamProxy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.