# vedantb7/zerovpn architecture

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

- Interactive diagram: https://gitdiagram.com/vedantb7/zerovpn
- Repository: https://github.com/vedantb7/zerovpn

## Overview

ZeroVPN is a Linux VPN-like secure tunnel. Clients connect over TCP, receive a dynamically assigned VPN address, register it, then forward TUN packets through encrypted frames; the server decrypts client traffic into its TUN interface and supports multiple sessions. The documented product also includes route controls for split/full tunneling, DNS and internet access, monitoring, and CLI management. Some capabilities are documented but their full runtime implementation was not sampled, so uncertain links are omitted.

Main entry points: [`server/tcp_server.cpp`](https://github.com/vedantb7/zerovpn/blob/main/server/tcp_server.cpp) (TCP server), [`client/client.cpp`](https://github.com/vedantb7/zerovpn/blob/main/client/client.cpp) (Namespace client), [`common/server_cli.cpp`](https://github.com/vedantb7/zerovpn/blob/main/common/server_cli.cpp) (Server CLI), [`client/host_client.cpp`](https://github.com/vedantb7/zerovpn/blob/main/client/host_client.cpp) (Host client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["VPN clients"]
  node_client["Namespace client<br/>[client.cpp]"]
  node_host_client["Host client<br/>[host_client.cpp]"]
end

subgraph group_server["Tunnel server"]
  node_tcp_server["TCP server<br/>[tcp_server.cpp]"]
  node_server_entry["Server startup<br/>[tunnel_server.cpp]"]
  node_sessions[("Client sessions<br/>[sessions.cpp]")]
  node_ip_allocator["VPN IP allocation<br/>[ip_allocator.cpp]"]
end

subgraph group_shared["Tunnel primitives"]
  node_client_tun["Client TUN forwarding<br/>[tun.cpp]"]
  node_server_tun["Server TUN forwarding<br/>[tun.cpp]"]
  node_packet["Framing<br/>[packet.cpp]"]
  node_crypto["Packet encryption<br/>[crypto.cpp]"]
end

subgraph group_management["Routing and management"]
  node_client_cli["Client CLI<br/>[client_cli.cpp]"]
  node_routes["Route controls<br/>[routes.cpp]"]
  node_forwarding["Forwarding rules"]
  node_server_cli["Server CLI<br/>[server_cli.cpp]"]
  node_stats[("Traffic statistics<br/>[stats.cpp]")]
end

node_user(("VPN operator"))
node_destination["Destination endpoint"]
node_internet(("Internet services"))

node_user -->|"starts tunnel"| node_client
node_user -.->|"starts optionally"| node_host_client
node_client -->|"connects TCP"| node_tcp_server
node_host_client -->|"connects TCP"| node_tcp_server
node_client -->|"exchanges frames"| node_packet
node_host_client -->|"exchanges frames"| node_packet
node_client -->|"starts forwarding"| node_client_tun
node_host_client -->|"starts forwarding"| node_client_tun
node_client -->|"starts CLI"| node_client_cli
node_tcp_server -->|"allocates address"| node_ip_allocator
node_tcp_server -->|"records sessions"| node_sessions
node_tcp_server -->|"receives frames"| node_packet
node_tcp_server -->|"decrypts packets"| node_crypto
node_tcp_server -->|"writes packets"| node_server_tun
node_server_entry -->|"starts server"| node_tcp_server
node_server_entry -->|"configures interface"| node_server_tun
node_client_cli -->|"controls routes"| node_routes
node_client_cli -->|"prints statistics"| node_stats
node_server_cli -->|"controls server"| node_tcp_server
node_server_cli -->|"lists sessions"| node_sessions
node_server_cli -->|"prints statistics"| node_stats
node_server_cli -->|"controls rules"| node_forwarding
node_client_tun -.->|"encrypts packets"| node_crypto
node_server_tun -.->|"routes traffic"| node_internet
node_server_tun -.->|"forwards traffic"| node_destination
node_routes -.->|"enables tunneling"| node_internet

click node_client "https://github.com/vedantb7/zerovpn/blob/main/client/client.cpp"
click node_host_client "https://github.com/vedantb7/zerovpn/blob/main/client/host_client.cpp"
click node_client_tun "https://github.com/vedantb7/zerovpn/blob/main/common/tun.cpp"
click node_client_cli "https://github.com/vedantb7/zerovpn/blob/main/common/client_cli.cpp"
click node_tcp_server "https://github.com/vedantb7/zerovpn/blob/main/server/tcp_server.cpp"
click node_server_entry "https://github.com/vedantb7/zerovpn/blob/main/server/tunnel_server.cpp"
click node_server_tun "https://github.com/vedantb7/zerovpn/blob/main/common/tun.cpp"
click node_sessions "https://github.com/vedantb7/zerovpn/blob/main/common/sessions.cpp"
click node_ip_allocator "https://github.com/vedantb7/zerovpn/blob/main/common/ip_allocator.cpp"
click node_packet "https://github.com/vedantb7/zerovpn/blob/main/common/packet.cpp"
click node_crypto "https://github.com/vedantb7/zerovpn/blob/main/common/crypto.cpp"
click node_routes "https://github.com/vedantb7/zerovpn/blob/main/common/routes.cpp"
click node_forwarding "https://github.com/vedantb7/zerovpn/blob/main/common/forwarding_rules.cpp"
click node_server_cli "https://github.com/vedantb7/zerovpn/blob/main/common/server_cli.cpp"
click node_stats "https://github.com/vedantb7/zerovpn/blob/main/common/stats.cpp"
click node_destination "https://github.com/vedantb7/zerovpn/blob/main/server/destination_server.cpp"

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_client,node_host_client toneBlue
class node_tcp_server,node_server_entry,node_sessions,node_ip_allocator toneAmber
class node_client_tun,node_server_tun,node_packet,node_crypto toneMint
class node_client_cli,node_routes,node_forwarding,node_server_cli,node_stats toneRose
class node_user,node_internet toneIndigo
class node_destination toneTeal
```

## Components

### VPN clients

- [Namespace client](https://github.com/vedantb7/zerovpn/blob/main/client/client.cpp): `client/client.cpp`
- [Host client](https://github.com/vedantb7/zerovpn/blob/main/client/host_client.cpp): `client/host_client.cpp`

### Tunnel server

- [TCP server](https://github.com/vedantb7/zerovpn/blob/main/server/tcp_server.cpp): `server/tcp_server.cpp`
- [Server startup](https://github.com/vedantb7/zerovpn/blob/main/server/tunnel_server.cpp): `server/tunnel_server.cpp`
- [Client sessions](https://github.com/vedantb7/zerovpn/blob/main/common/sessions.cpp): `common/sessions.cpp`
- [VPN IP allocation](https://github.com/vedantb7/zerovpn/blob/main/common/ip_allocator.cpp): `common/ip_allocator.cpp`

### Tunnel primitives

- [Client TUN forwarding](https://github.com/vedantb7/zerovpn/blob/main/common/tun.cpp): `common/tun.cpp`
- [Server TUN forwarding](https://github.com/vedantb7/zerovpn/blob/main/common/tun.cpp): `common/tun.cpp`
- [Framing](https://github.com/vedantb7/zerovpn/blob/main/common/packet.cpp): `common/packet.cpp`
- [Packet encryption](https://github.com/vedantb7/zerovpn/blob/main/common/crypto.cpp): `common/crypto.cpp`

### Routing and management

- [Client CLI](https://github.com/vedantb7/zerovpn/blob/main/common/client_cli.cpp): `common/client_cli.cpp`
- [Route controls](https://github.com/vedantb7/zerovpn/blob/main/common/routes.cpp): `common/routes.cpp`
- [Forwarding rules](https://github.com/vedantb7/zerovpn/blob/main/common/forwarding_rules.cpp): `common/forwarding_rules.cpp`
- [Server CLI](https://github.com/vedantb7/zerovpn/blob/main/common/server_cli.cpp): `common/server_cli.cpp`
- [Traffic statistics](https://github.com/vedantb7/zerovpn/blob/main/common/stats.cpp): `common/stats.cpp`

### Other components

- **VPN operator**
- [Destination endpoint](https://github.com/vedantb7/zerovpn/blob/main/server/destination_server.cpp): `server/destination_server.cpp`
- **Internet services**

## Connections

- VPN operator → Namespace client: starts tunnel (evidence: `README.md`)
- VPN operator → Host client: starts optionally (evidence: `README.md`)
- Namespace client → TCP server: connects TCP (evidence: `client/client.cpp`)
- Host client → TCP server: connects TCP (evidence: `client/host_client.cpp`)
- Namespace client → Framing: exchanges frames (evidence: `client/client.cpp`)
- Host client → Framing: exchanges frames (evidence: `client/host_client.cpp`)
- Namespace client → Client TUN forwarding: starts forwarding (evidence: `client/client.cpp`)
- Host client → Client TUN forwarding: starts forwarding (evidence: `client/host_client.cpp`)
- Namespace client → Client CLI: starts CLI (evidence: `client/client.cpp`)
- TCP server → VPN IP allocation: allocates address (evidence: `server/tcp_server.cpp`)
- TCP server → Client sessions: records sessions (evidence: `server/tcp_server.cpp`)
- TCP server → Framing: receives frames (evidence: `server/tcp_server.cpp`)
- TCP server → Packet encryption: decrypts packets (evidence: `server/tcp_server.cpp`)
- TCP server → Server TUN forwarding: writes packets (evidence: `server/tcp_server.cpp`)
- Server startup → TCP server: starts server (evidence: `server/tunnel_server.cpp`)
- Server startup → Server TUN forwarding: configures interface (evidence: `server/tunnel_server.cpp`)
- Client CLI → Route controls: controls routes (evidence: `common/client_cli.cpp`)
- Client CLI → Traffic statistics: prints statistics (evidence: `common/client_cli.cpp`)
- Server CLI → TCP server: controls server (evidence: `common/server_cli.cpp`)
- Server CLI → Client sessions: lists sessions (evidence: `common/server_cli.cpp`)
- Server CLI → Traffic statistics: prints statistics (evidence: `common/server_cli.cpp`)
- Server CLI → Forwarding rules: controls rules (evidence: `common/server_cli.cpp`)
- Client TUN forwarding → Packet encryption: encrypts packets
- Server TUN forwarding → Internet services: routes traffic (evidence: `README.md`)
- Server TUN forwarding → Destination endpoint: forwards traffic (evidence: `README.md`)
- Route controls → Internet services: enables tunneling (evidence: `README.md`)
