Reference

This section contains lookup material for Infrarust. Unlike the Guide (which walks you through tasks) or Configuration (which explains how to set things up), reference pages are structured for quick lookup when you already know what you're looking for.

Configuration

Config Schema documents every option in infrarust.toml and server TOML files: types, defaults, and valid values. If you need to check a field name or see what a default is, start here.

CLI

CLI Reference covers the infrarust binary's command-line flags:

infrarust --config ./infrarust.toml --bind 0.0.0.0:25577 --log-level debug

The three flags are --config (path to the config file, defaults to infrarust.toml), --bind (override the listen address), and --log-level (log verbosity, defaults to info). The RUST_LOG environment variable takes priority over --log-level.

Error Codes

Error Codes lists the error types Infrarust can produce during connection forwarding and server management, with likely causes and fixes.

Proxy Protocol

Proxy Protocol Spec explains Infrarust's support for HAProxy PROXY protocol v1/v2, both receiving from upstream load balancers and sending to backend servers.

Architecture

Architecture Overview describes the internal structure of Infrarust: the crate layout, connection pipeline, plugin system, and how packets flow from client to backend.

Performance Tuning covers worker threads, SO_REUSEPORT, zero-copy mode, and other knobs for high-throughput deployments.

Zerocopy & Splice explains the Linux splice(2) forwarding path used by the zero_copy proxy mode.

Migration

Migration from V1 maps V1 configuration options to their V2 equivalents for anyone upgrading from a previous Infrarust release.