# pkok1099/wpmulti-rs architecture

> Architecture diagram of the GitHub repository pkok1099/wpmulti-rs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pkok1099/wpmulti-rs
- Repository: https://github.com/pkok1099/wpmulti-rs

## Overview

wpmulti is a userspace multi-tunnel WireGuard daemon that exposes SOCKS5 and HTTP/HTTPS proxies. Its main workflow loads and validates tunnel and daemon configuration, manages tunnel lifecycle and listeners, routes proxy requests through a tunnel-backed network stack, and provides administration through a REST API and TUI. The graph also includes DNS, health, and CLI capabilities. Relationships are limited to those shown in the README or source index; unsampled subsystems are represented by their exact tree paths.

Main entry points: [`src/core/mod.rs`](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/mod.rs) (Tunnel manager), [`src/tui/app.rs`](https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/app.rs) (TUI monitor), [`src/core/listener.rs`](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/listener.rs) (Proxy listeners), [`src/netstack/stack.rs`](https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/stack.rs) (Virtual IP stack)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration"]
  node_config_loader["Config loading<br/>[mod.rs]"]
  node_wg_parser["WireGuard parser<br/>[wg_conf.rs]"]
  node_toml_schema["Daemon settings<br/>[toml_config.rs]"]
end

subgraph group_tunnel_runtime["Tunnel runtime"]
  node_manager["Tunnel manager<br/>[mod.rs]"]
  node_registry[("Tunnel registry<br/>[registry.rs]")]
  node_lifecycle["Tunnel lifecycle<br/>[lifecycle.rs]"]
  node_health["Health monitoring<br/>[health.rs]"]
end

subgraph group_proxy_network["Proxy networking"]
  node_listeners["Proxy listeners<br/>[listener.rs]"]
  node_tunnel_router["Tunnel selection<br/>[router.rs]"]
  node_proxy_router["Proxy connector<br/>[router.rs]"]
  node_socks5["SOCKS5 proxy<br/>[socks5.rs]"]
  node_http_proxy["HTTP proxy<br/>[http.rs]"]
  node_netstack["Virtual IP stack<br/>[stack.rs]"]
  node_bridge["WireGuard bridge<br/>[bridge.rs]"]
  node_dns["Tunnel DNS<br/>[dns.rs]"]
  node_stream["Virtual streams<br/>[stream.rs]"]
end

subgraph group_administration["Administration"]
  node_admin_server["Admin API server<br/>[server.rs]"]
  node_admin_routes["Admin endpoints<br/>[routes.rs]"]
  node_metrics["Prometheus metrics<br/>[metrics.rs]"]
  node_tui_app["TUI monitor<br/>[app.rs]"]
  node_tui_ui["TUI display<br/>[ui.rs]"]
  node_config_editor["TUI config editor<br/>[config_editor.rs]"]
  node_logs["Log display<br/>[logs.rs]"]
end

subgraph group_operations["Operations"]
  node_cli["CLI commands<br/>[commands.rs]"]
end

node_user(("Operator or client"))
node_tunnel_files["WireGuard configs"]

node_user -->|"runs commands"| node_cli
node_tunnel_files -->|"loads tunnel files"| node_config_loader
node_config_loader -->|"parses WireGuard"| node_wg_parser
node_cli -->|"loads configs"| node_config_loader
node_cli -->|"reads settings"| node_toml_schema
node_cli -->|"starts daemon"| node_manager
node_manager -->|"manages entries"| node_registry
node_manager -->|"coordinates lifecycle"| node_lifecycle
node_manager -->|"probes tunnels"| node_health
node_manager -->|"supervises listeners"| node_listeners
node_listeners -->|"configures routing"| node_proxy_router
node_listeners -->|"serves SOCKS5"| node_socks5
node_listeners -->|"serves HTTP"| node_http_proxy
node_socks5 -->|"connects requests"| node_proxy_router
node_http_proxy -->|"connects requests"| node_proxy_router
node_proxy_router -->|"selects tunnel"| node_tunnel_router
node_tunnel_router -->|"checks candidates"| node_registry
node_tunnel_router -->|"activates tunnel"| node_lifecycle
node_lifecycle -->|"creates stack"| node_netstack
node_netstack -->|"bridges packets"| node_bridge
node_netstack -->|"resolves domains"| node_dns
node_netstack -->|"provides streams"| node_stream
node_user -->|"calls admin API"| node_admin_server
node_admin_server -->|"dispatches requests"| node_admin_routes
node_admin_routes -->|"controls tunnels"| node_manager
node_admin_routes -->|"serves metrics"| node_metrics
node_user -->|"opens dashboard"| node_tui_app
node_tui_app -->|"queries API"| node_admin_server
node_tui_app -->|"renders dashboard"| node_tui_ui
node_tui_app -->|"edits settings"| node_config_editor
node_tui_app -->|"displays logs"| node_logs

click node_config_loader "https://github.com/pkok1099/wpmulti-rs/blob/main/src/config/mod.rs"
click node_wg_parser "https://github.com/pkok1099/wpmulti-rs/blob/main/src/config/wg_conf.rs"
click node_toml_schema "https://github.com/pkok1099/wpmulti-rs/blob/main/src/config/toml_config.rs"
click node_cli "https://github.com/pkok1099/wpmulti-rs/blob/main/src/cli/commands.rs"
click node_manager "https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/mod.rs"
click node_registry "https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/registry.rs"
click node_lifecycle "https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/lifecycle.rs"
click node_health "https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/health.rs"
click node_listeners "https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/listener.rs"
click node_tunnel_router "https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/router.rs"
click node_proxy_router "https://github.com/pkok1099/wpmulti-rs/blob/main/src/proxy/router.rs"
click node_socks5 "https://github.com/pkok1099/wpmulti-rs/blob/main/src/proxy/socks5.rs"
click node_http_proxy "https://github.com/pkok1099/wpmulti-rs/blob/main/src/proxy/http.rs"
click node_netstack "https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/stack.rs"
click node_bridge "https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/bridge.rs"
click node_dns "https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/dns.rs"
click node_stream "https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/stream.rs"
click node_admin_server "https://github.com/pkok1099/wpmulti-rs/blob/main/src/api/server.rs"
click node_admin_routes "https://github.com/pkok1099/wpmulti-rs/blob/main/src/api/routes.rs"
click node_metrics "https://github.com/pkok1099/wpmulti-rs/blob/main/src/api/metrics.rs"
click node_tui_app "https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/app.rs"
click node_tui_ui "https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/ui.rs"
click node_config_editor "https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/config_editor.rs"
click node_logs "https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/logs.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_config_loader,node_wg_parser,node_toml_schema,node_user toneBlue
class node_manager,node_registry,node_lifecycle,node_health toneAmber
class node_listeners,node_tunnel_router,node_proxy_router,node_socks5,node_http_proxy,node_netstack,node_bridge,node_dns,node_stream toneMint
class node_admin_server,node_admin_routes,node_metrics,node_tui_app,node_tui_ui,node_config_editor,node_logs toneRose
class node_cli,node_tunnel_files toneIndigo
```

## Components

### Configuration

- [Config loading](https://github.com/pkok1099/wpmulti-rs/blob/main/src/config/mod.rs): `src/config/mod.rs`
- [WireGuard parser](https://github.com/pkok1099/wpmulti-rs/blob/main/src/config/wg_conf.rs): `src/config/wg_conf.rs`
- [Daemon settings](https://github.com/pkok1099/wpmulti-rs/blob/main/src/config/toml_config.rs): `src/config/toml_config.rs`

### Tunnel runtime

- [Tunnel manager](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/mod.rs): `src/core/mod.rs`
- [Tunnel registry](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/registry.rs): `src/core/registry.rs`
- [Tunnel lifecycle](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/lifecycle.rs): `src/core/lifecycle.rs`
- [Health monitoring](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/health.rs): `src/core/health.rs`

### Proxy networking

- [Proxy listeners](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/listener.rs): `src/core/listener.rs`
- [Tunnel selection](https://github.com/pkok1099/wpmulti-rs/blob/main/src/core/router.rs): `src/core/router.rs`
- [Proxy connector](https://github.com/pkok1099/wpmulti-rs/blob/main/src/proxy/router.rs): `src/proxy/router.rs`
- [SOCKS5 proxy](https://github.com/pkok1099/wpmulti-rs/blob/main/src/proxy/socks5.rs): `src/proxy/socks5.rs`
- [HTTP proxy](https://github.com/pkok1099/wpmulti-rs/blob/main/src/proxy/http.rs): `src/proxy/http.rs`
- [Virtual IP stack](https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/stack.rs): `src/netstack/stack.rs`
- [WireGuard bridge](https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/bridge.rs): `src/netstack/bridge.rs`
- [Tunnel DNS](https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/dns.rs): `src/netstack/dns.rs`
- [Virtual streams](https://github.com/pkok1099/wpmulti-rs/blob/main/src/netstack/stream.rs): `src/netstack/stream.rs`

### Administration

- [Admin API server](https://github.com/pkok1099/wpmulti-rs/blob/main/src/api/server.rs): `src/api/server.rs`
- [Admin endpoints](https://github.com/pkok1099/wpmulti-rs/blob/main/src/api/routes.rs): `src/api/routes.rs`
- [Prometheus metrics](https://github.com/pkok1099/wpmulti-rs/blob/main/src/api/metrics.rs): `src/api/metrics.rs`
- [TUI monitor](https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/app.rs): `src/tui/app.rs`
- [TUI display](https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/ui.rs): `src/tui/ui.rs`
- [TUI config editor](https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/config_editor.rs): `src/tui/config_editor.rs`
- [Log display](https://github.com/pkok1099/wpmulti-rs/blob/main/src/tui/logs.rs): `src/tui/logs.rs`

### Operations

- [CLI commands](https://github.com/pkok1099/wpmulti-rs/blob/main/src/cli/commands.rs): `src/cli/commands.rs`

### Other components

- **Operator or client**
- **WireGuard configs**

## Connections

- Operator or client → CLI commands: runs commands (evidence: `src/cli/commands.rs`)
- WireGuard configs → Config loading: loads tunnel files (evidence: `src/config/mod.rs`)
- Config loading → WireGuard parser: parses WireGuard (evidence: `src/config/mod.rs`)
- CLI commands → Config loading: loads configs (evidence: `src/cli/commands.rs`)
- CLI commands → Daemon settings: reads settings (evidence: `src/cli/commands.rs`)
- CLI commands → Tunnel manager: starts daemon (evidence: `src/cli/commands.rs`)
- Tunnel manager → Tunnel registry: manages entries (evidence: `src/core/mod.rs`)
- Tunnel manager → Tunnel lifecycle: coordinates lifecycle (evidence: `src/core/mod.rs`)
- Tunnel manager → Health monitoring: probes tunnels (evidence: `src/core/mod.rs`)
- Tunnel manager → Proxy listeners: supervises listeners (evidence: `src/core/mod.rs`)
- Proxy listeners → Proxy connector: configures routing (evidence: `src/core/listener.rs`)
- Proxy listeners → SOCKS5 proxy: serves SOCKS5
- Proxy listeners → HTTP proxy: serves HTTP
- SOCKS5 proxy → Proxy connector: connects requests (evidence: `src/proxy/socks5.rs`)
- HTTP proxy → Proxy connector: connects requests (evidence: `src/proxy/http.rs`)
- Proxy connector → Tunnel selection: selects tunnel (evidence: `src/proxy/router.rs`)
- Tunnel selection → Tunnel registry: checks candidates (evidence: `src/core/router.rs`)
- Tunnel selection → Tunnel lifecycle: activates tunnel (evidence: `src/core/router.rs`)
- Tunnel lifecycle → Virtual IP stack: creates stack (evidence: `src/core/lifecycle.rs`)
- Virtual IP stack → WireGuard bridge: bridges packets (evidence: `src/netstack/stack.rs`)
- Virtual IP stack → Tunnel DNS: resolves domains (evidence: `src/netstack/stack.rs`)
- Virtual IP stack → Virtual streams: provides streams (evidence: `src/netstack/stack.rs`)
- Operator or client → Admin API server: calls admin API (evidence: `README.md`)
- Admin API server → Admin endpoints: dispatches requests (evidence: `src/api/server.rs`)
- Admin endpoints → Tunnel manager: controls tunnels (evidence: `src/api/routes.rs`)
- Admin endpoints → Prometheus metrics: serves metrics (evidence: `src/api/routes.rs`)
- Operator or client → TUI monitor: opens dashboard (evidence: `README.md`)
- TUI monitor → Admin API server: queries API (evidence: `README.md`)
- TUI monitor → TUI display: renders dashboard (evidence: `src/tui/app.rs`)
- TUI monitor → TUI config editor: edits settings (evidence: `src/tui/app.rs`)
- TUI monitor → Log display: displays logs (evidence: `src/tui/app.rs`)
