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_hook

Macro to quickly define a new protocol hook.

define_protocol

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

hook_protocol

Automatically generated wrapper to intercept protocol traffic.

refractium_debug

Internal debug logging macro.

refractium_error

Internal error logging macro.

refractium_info

Internal info logging macro.

refractium_trace

Internal trace logging macro.

refractium_warn

Internal warning logging macro.