Crate refractium 

Refractium

A high-performance, lightweight L4 protocol multiplexer.

refractium allows you to route incoming TCP and UDP traffic to different backends based on the protocol identification (magic bytes, SNI, etc.). It supports dynamic protocol registration, load balancing, and health monitoring.

Core Features

• TCP & UDP Support: Multiplex both stream and packet-based traffic.
• Protocol Identification: Built-in support for HTTP, HTTPS (with SNI), SSH, DNS, and FTP.
• Dynamic Routing: Add custom protocols using simple patterns or complex logic.
• Load Balancing: Distribute traffic across multiple backends with health checks.
• Graceful Shutdown: Built-in support for cancellation tokens.

Quick Start

use refractium::{Refractium, Http, types::{ProtocolRoute, ForwardTarget, Transport}};
use std::sync::Arc;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let routes = vec![ProtocolRoute {
        protocol: Arc::new(Http),
        sni: None,
        forward_to: ForwardTarget::Single("127.0.0.1:8080".to_string()),
    }];

    let refractium = Refractium::builder()
        .routes(routes, Vec::new())
        .build()?;

    refractium.run_tcp("0.0.0.0:80".parse()?).await?;
    Ok(())
}

Re-exports

pub use crate::core::types;

pub use crate::core::types::ProtocolMatch;

pub use crate::core::types::ProtocolRoute;

pub use crate::core::types::RefractiumProtocol;

pub use crate::core::types::Transport;

pub use crate::core::Refractium;

pub use crate::core::RefractiumBuilder;

pub use crate::errors::RefractiumError;

pub use crate::errors::Result;

pub use crate::protocols::DynamicProtocol;

pub use crate::protocols::ProtocolRegistry;

pub use crate::protocols::dns::Dns;

pub use crate::protocols::ftp::Ftp;

pub use crate::protocols::http::Http;

pub use crate::protocols::https::Https;

pub use crate::protocols::ssh::Ssh;

pub use bytes;

pub use dyn_clone;

pub use heck;

Modules

core

Core logic for proxying and routing.

errors

Error types and result aliases.

macros

Internal macros for protocol definition.

protocols

Protocol implementations and identification logic. Protocol identification and registry logic.

Macros

define_protocol

Macro to define a new protocol by implementing the RefractiumProtocol trait.