🚀 Infrarust V2 is now in alpha! Check out the new documentation. V1 will be archived once V2 is released.
Skip to content

Infrarust

Universal Minecraft Reverse Proxy

One proxy to rule them all

Infrarust Logo

CURRENT VERSION

v1.5.0 - Crafty integration

🎯 Why Infrarust?

Infrarust is a modern Minecraft reverse proxy that truly works with everything:

Universal Compatibility - Passthrough Mode

  • ✅ All Minecraft versions (1.8 to latest)
  • ✅ Every mod loader (Forge, Fabric, Quilt)
  • ✅ Vanilla and modded servers
  • ✅ Premium and offline modes
  • ✅ No special configuration needed

Technical Stack

  • 🚀 Written in Rust for native performance
  • 🛡️ Built-in protection against attacks
  • 🚫 Advanced ban system with IP, username, and UUID filtering
  • 🐋 Seamless Docker container integration
  • 📝 Simple YAML configuration
  • 🔄 Hot-reload support
  • 📊 Comprehensive monitoring

🚀 Quick Start

bash
# Download and run
curl -LO https://github.com/Shadowner/Infrarust/releases/latest/download/infrarust
chmod +x infrarust
./infrarust

# Or install via cargo
cargo install infrarust

🔮 Key Features

FeatureDescription
Multiple Proxy ModesSupport passthrough, client-only, offline, and server-only modes
Ban SystemBan players by IP, username, or UUID with temporary or permanent bans
Docker IntegrationAutomatically detect and proxy containers with label-based configuration
Command-Line InterfaceManage players, view connections, and handle bans in real-time
Configuration Hot-ReloadChange configuration without restarting the proxy
DDoS ProtectionBuilt-in rate limiting and connection filtering

💡 Perfect For

  • Local Hosting: For those who don't want to expose all their ports
  • Network Owners: Handle multiple server types from one proxy
  • Modpack Creators: Route different modpack versions seamlessly
  • Server Admins: Manage vanilla and modded servers together
  • Community Hosts: Support any client version or mod loader
  • Container Deployments: Seamlessly integrate with Docker environments

📊 Real-World Performance

MetricValue
Memory Usage< 20MB base
CPU UsageMinimal
Latency Overhead< 1ms
Connection Handling10,000+ concurrent

📚 Documentation Highlights

🗺️ Roadmap Highlights

FeatureStatus
Web Dashboard💡 Planned
Plugin API💭 Proposed
Version Translation💭 Proposed
Multi-Proxy Clustering💭 Proposed

🤝 Community

Join our growing community:

Released under the AGPL-3.0 License.