# prvtpro/amnezia-web-panel architecture

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

- Interactive diagram: https://gitdiagram.com/prvtpro/amnezia-web-panel
- Repository: https://github.com/prvtpro/amnezia-web-panel

## Overview

Amnezia Web Panel is a multi-server administration dashboard for remotely managing VPN protocols, proxy and DNS services, exit-node routing, users, and settings. An administrator adds a server, the panel connects over SSH, then manages and monitors installed services and their clients; end users can also obtain self-service connections through the panel or Telegram. The graph groups the web/API orchestration, remote access, protocol managers, and supporting features. Several README capabilities are represented by manager nodes, but unsampled route wiring is not asserted.

Main entry points: [`app.py`](https://github.com/prvtpro/amnezia-web-panel/blob/main/app.py) (Web API), [`telegram_bot.py`](https://github.com/prvtpro/amnezia-web-panel/blob/main/telegram_bot.py) (Telegram bot), [`managers/ssh_manager.py`](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/ssh_manager.py) (SSH transport), [`managers/awg_manager.py`](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/awg_manager.py) (AmneziaWG)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_panel["Panel and access"]
  node_app["Web API<br/>[app.py]"]
  node_connection_service["Self-service connections"]
  node_telegram_bot["Telegram bot<br/>[telegram_bot.py]"]
  node_captcha["CAPTCHA challenges"]
end

subgraph group_remote["Remote operations"]
  node_ssh["SSH transport<br/>[ssh_manager.py]"]
end

subgraph group_protocols["Protocols and services"]
  node_awg["AmneziaWG<br/>[awg_manager.py]"]
  node_wireguard["WireGuard"]
  node_xray["Xray Reality<br/>[xray_manager.py]"]
  node_telemt["Telemt proxy<br/>[telemt_manager.py]"]
  node_dns["AmneziaDNS<br/>[dns_manager.py]"]
  node_adguard["AdGuard Home<br/>[adguard_manager.py]"]
  node_socks5["SOCKS5 proxy<br/>[socks5_manager.py]"]
  node_nginx["NGINX and TLS<br/>[nginx_manager.py]"]
  node_exit["Exit node<br/>[exit_manager.py]"]
end

subgraph group_features["User and network features"]
  node_backup["Protocol backups<br/>[backup_manager.py]"]
  node_exit_link["Exit-node links"]
  node_wgeasy["WireGuard imports<br/>[wgeasy_import.py]"]
  node_mail["Email delivery<br/>[mail_service.py]"]
end

node_admin(("Administrator"))
node_end_user(("Panel user"))
node_telegram_user(("Telegram user"))
node_smtp["SMTP service"]
node_telegram_api["Telegram API"]

node_admin -->|"manages via"| node_app
node_end_user -->|"requests access"| node_app
node_telegram_user -->|"requests access"| node_telegram_bot
node_app -->|"connects remotely"| node_ssh
node_app -->|"configures service"| node_connection_service
node_app -->|"imports"| node_captcha
node_app -->|"imports"| node_mail
node_app -->|"imports"| node_exit_link
node_app -->|"imports"| node_backup
node_app -->|"manages"| node_awg
node_app -->|"manages"| node_wireguard
node_app -->|"manages"| node_xray
node_app -->|"manages"| node_telemt
node_app -->|"manages"| node_dns
node_app -->|"manages"| node_adguard
node_app -->|"manages"| node_socks5
node_app -->|"manages"| node_nginx
node_app -->|"manages"| node_exit
node_connection_service -->|"opens session"| node_ssh
node_connection_service -->|"provisions clients"| node_awg
node_telegram_bot -->|"imports"| node_connection_service
node_telegram_bot -->|"manages servers"| node_ssh
node_telegram_bot -->|"manages clients"| node_awg
node_telegram_bot -->|"manages clients"| node_wireguard
node_telegram_bot -->|"manages clients"| node_xray
node_telegram_bot -->|"manages clients"| node_telemt
node_telegram_bot -->|"manages service"| node_dns
node_telegram_bot -->|"manages service"| node_socks5
node_telegram_bot -->|"manages service"| node_adguard
node_telegram_bot -->|"manages service"| node_nginx
node_telegram_bot -->|"manages service"| node_exit
node_telegram_bot -->|"calls"| node_telegram_api
node_ssh -.->|"runs remote commands"| node_awg
node_ssh -.->|"runs remote commands"| node_wireguard
node_ssh -.->|"runs remote commands"| node_xray
node_ssh -.->|"runs remote commands"| node_telemt
node_ssh -.->|"runs remote commands"| node_dns
node_ssh -.->|"runs remote commands"| node_adguard
node_ssh -.->|"runs remote commands"| node_socks5
node_ssh -.->|"runs remote commands"| node_nginx
node_ssh -.->|"runs remote commands"| node_exit
node_exit_link -.->|"coordinates links"| node_awg
node_backup -.->|"archives remotely"| node_ssh
node_wgeasy -->|"imports clients"| node_wireguard
node_wgeasy -->|"imports clients"| node_awg
node_mail -->|"sends messages"| node_smtp

click node_app "https://github.com/prvtpro/amnezia-web-panel/blob/main/app.py"
click node_connection_service "https://github.com/prvtpro/amnezia-web-panel/blob/main/connection_service.py"
click node_telegram_bot "https://github.com/prvtpro/amnezia-web-panel/blob/main/telegram_bot.py"
click node_captcha "https://github.com/prvtpro/amnezia-web-panel/blob/main/captcha_challenges.py"
click node_ssh "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/ssh_manager.py"
click node_awg "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/awg_manager.py"
click node_wireguard "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/wireguard_manager.py"
click node_xray "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/xray_manager.py"
click node_telemt "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/telemt_manager.py"
click node_dns "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/dns_manager.py"
click node_adguard "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/adguard_manager.py"
click node_socks5 "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/socks5_manager.py"
click node_nginx "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/nginx_manager.py"
click node_exit "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/exit_manager.py"
click node_backup "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/backup_manager.py"
click node_exit_link "https://github.com/prvtpro/amnezia-web-panel/blob/main/exit_link_service.py"
click node_wgeasy "https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/wgeasy_import.py"
click node_mail "https://github.com/prvtpro/amnezia-web-panel/blob/main/mail_service.py"

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_app,node_connection_service,node_telegram_bot,node_captcha,node_end_user,node_telegram_user toneBlue
class node_ssh toneAmber
class node_awg,node_wireguard,node_xray,node_telemt,node_dns,node_adguard,node_socks5,node_nginx,node_exit,node_telegram_api toneMint
class node_backup,node_exit_link,node_wgeasy,node_mail toneRose
class node_admin,node_smtp toneIndigo
```

## Components

### Panel and access

- [Web API](https://github.com/prvtpro/amnezia-web-panel/blob/main/app.py): `app.py`
- [Self-service connections](https://github.com/prvtpro/amnezia-web-panel/blob/main/connection_service.py): `connection_service.py`
- [Telegram bot](https://github.com/prvtpro/amnezia-web-panel/blob/main/telegram_bot.py): `telegram_bot.py`
- [CAPTCHA challenges](https://github.com/prvtpro/amnezia-web-panel/blob/main/captcha_challenges.py): `captcha_challenges.py`

### Remote operations

- [SSH transport](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/ssh_manager.py): `managers/ssh_manager.py`

### Protocols and services

- [AmneziaWG](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/awg_manager.py): `managers/awg_manager.py`
- [WireGuard](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/wireguard_manager.py): `managers/wireguard_manager.py`
- [Xray Reality](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/xray_manager.py): `managers/xray_manager.py`
- [Telemt proxy](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/telemt_manager.py): `managers/telemt_manager.py`
- [AmneziaDNS](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/dns_manager.py): `managers/dns_manager.py`
- [AdGuard Home](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/adguard_manager.py): `managers/adguard_manager.py`
- [SOCKS5 proxy](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/socks5_manager.py): `managers/socks5_manager.py`
- [NGINX and TLS](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/nginx_manager.py): `managers/nginx_manager.py`
- [Exit node](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/exit_manager.py): `managers/exit_manager.py`

### User and network features

- [Protocol backups](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/backup_manager.py): `managers/backup_manager.py`
- [Exit-node links](https://github.com/prvtpro/amnezia-web-panel/blob/main/exit_link_service.py): `exit_link_service.py`
- [WireGuard imports](https://github.com/prvtpro/amnezia-web-panel/blob/main/managers/wgeasy_import.py): `managers/wgeasy_import.py`
- [Email delivery](https://github.com/prvtpro/amnezia-web-panel/blob/main/mail_service.py): `mail_service.py`

### Other components

- **Administrator**
- **Panel user**
- **Telegram user**
- **SMTP service**
- **Telegram API**

## Connections

- Administrator → Web API: manages via (evidence: `README.md`)
- Panel user → Web API: requests access (evidence: `README.md`)
- Telegram user → Telegram bot: requests access (evidence: `README.md`)
- Web API → SSH transport: connects remotely (evidence: `app.py`)
- Web API → Self-service connections: configures service (evidence: `app.py`)
- Web API → CAPTCHA challenges: imports (evidence: `app.py`)
- Web API → Email delivery: imports (evidence: `app.py`)
- Web API → Exit-node links: imports (evidence: `app.py`)
- Web API → Protocol backups: imports (evidence: `app.py`)
- Web API → AmneziaWG: manages (evidence: `app.py`)
- Web API → WireGuard: manages (evidence: `app.py`)
- Web API → Xray Reality: manages (evidence: `app.py`)
- Web API → Telemt proxy: manages (evidence: `app.py`)
- Web API → AmneziaDNS: manages (evidence: `app.py`)
- Web API → AdGuard Home: manages (evidence: `app.py`)
- Web API → SOCKS5 proxy: manages (evidence: `app.py`)
- Web API → NGINX and TLS: manages (evidence: `app.py`)
- Web API → Exit node: manages (evidence: `app.py`)
- Self-service connections → SSH transport: opens session (evidence: `connection_service.py`)
- Self-service connections → AmneziaWG: provisions clients (evidence: `connection_service.py`)
- Telegram bot → Self-service connections: imports (evidence: `telegram_bot.py`)
- Telegram bot → SSH transport: manages servers (evidence: `telegram_bot.py`)
- Telegram bot → AmneziaWG: manages clients (evidence: `telegram_bot.py`)
- Telegram bot → WireGuard: manages clients (evidence: `telegram_bot.py`)
- Telegram bot → Xray Reality: manages clients (evidence: `telegram_bot.py`)
- Telegram bot → Telemt proxy: manages clients (evidence: `telegram_bot.py`)
- Telegram bot → AmneziaDNS: manages service (evidence: `telegram_bot.py`)
- Telegram bot → SOCKS5 proxy: manages service (evidence: `telegram_bot.py`)
- Telegram bot → AdGuard Home: manages service (evidence: `telegram_bot.py`)
- Telegram bot → NGINX and TLS: manages service (evidence: `telegram_bot.py`)
- Telegram bot → Exit node: manages service (evidence: `telegram_bot.py`)
- Telegram bot → Telegram API: calls (evidence: `telegram_bot.py`)
- SSH transport → AmneziaWG: runs remote commands
- SSH transport → WireGuard: runs remote commands
- SSH transport → Xray Reality: runs remote commands
- SSH transport → Telemt proxy: runs remote commands (evidence: `managers/telemt_manager.py`)
- SSH transport → AmneziaDNS: runs remote commands
- SSH transport → AdGuard Home: runs remote commands
- SSH transport → SOCKS5 proxy: runs remote commands
- SSH transport → NGINX and TLS: runs remote commands
- SSH transport → Exit node: runs remote commands
- Exit-node links → AmneziaWG: coordinates links
- Protocol backups → SSH transport: archives remotely
- WireGuard imports → WireGuard: imports clients (evidence: `managers/wgeasy_import.py`)
- WireGuard imports → AmneziaWG: imports clients (evidence: `managers/wgeasy_import.py`)
- Email delivery → SMTP service: sends messages (evidence: `mail_service.py`)
