Skip to main content
Muti Metroo Mole

Muti Metroo

Muti Metroo is a userspace mesh networking agent that creates virtual TCP tunnels across heterogeneous transport layers. It enables multi-hop routing with SOCKS5 ingress and CIDR-based exit routing, operating entirely in userspace without requiring root privileges.

What is Muti Metroo?​

Muti Metroo allows you to build flexible, resilient mesh networks where traffic can flow through multiple intermediate nodes to reach its destination. Think of it as building your own private network overlay that works across different network segments, firewalls, and transport protocols.

Key Features​

FeatureDescription
Multiple TransportsQUIC/TLS 1.3, HTTP/2, and WebSocket - mix protocols in a single mesh
SOCKS5 ProxyAccept client connections with optional authentication
CIDR-Based RoutingAdvertise network routes and handle DNS at exit nodes
Multi-Hop PathsTraffic automatically finds its way through the mesh
Stream MultiplexingMultiple virtual streams over single connections
File TransferUpload/download files and directories across the mesh
Remote ExecutionExecute commands on remote agents (RPC)
Web DashboardVisual topology with metro map visualization
No Root RequiredRuns entirely in userspace

Use Cases​

Corporate Network Access​

Provide secure access to internal resources through multi-hop SOCKS5 proxy chains, bypassing network segmentation without VPN infrastructure.

Multi-Site Connectivity​

Connect multiple office locations through a mesh of agents, enabling seamless access to resources across sites.

Resilient Remote Access​

Maintain connectivity through redundant paths with automatic failover and reconnection.

Development and Testing​

Create complex network topologies for testing distributed applications without physical infrastructure.

How It Works​

  1. Agents connect to form a mesh network, each potentially serving as ingress, transit, or exit
  2. Routes are advertised through the mesh using flood-based propagation
  3. Clients connect via SOCKS5 proxy on an ingress agent
  4. Traffic flows through the mesh following the best route to the exit agent
  5. Exit agents open real TCP connections to destination servers

Quick Start​

Get up and running in minutes:

# Download the binary for your platform (example: Linux amd64)
curl -L -o muti-metroo https://muti-metroo.postalsys.ee/downloads/latest/muti-metroo-linux-amd64
chmod +x muti-metroo
sudo mv muti-metroo /usr/local/bin/

# Run interactive setup wizard
muti-metroo setup

Download binaries for all platforms from the Download page.

The wizard guides you through configuring your first agent, generating TLS certificates, and starting the mesh.

Documentation Overview​

SectionDescription
Getting StartedInstallation, setup, and your first mesh
Core ConceptsArchitecture, roles, transports, and routing
ConfigurationComplete configuration reference
FeaturesSOCKS5, exit routing, file transfer, RPC
DeploymentDocker, Kubernetes, and production deployment
SecurityTLS, authentication, and best practices
CLI ReferenceCommand-line interface documentation
HTTP APIREST API for monitoring and management
ProtocolWire protocol and internals
TroubleshootingCommon issues and FAQ

Next Steps​