# genome96/darkaons architecture

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

- Interactive diagram: https://gitdiagram.com/genome96/darkaons
- Repository: https://github.com/genome96/darkaons

## Overview

This repository appears to provide a VPS tunneling/proxy setup, but the README documents only downloading and running `v5.sh`; the installer and most deployment components were not sampled. The clearest inspected runtime is `Fls/ws.py`, a threaded TCP-to-WebSocket-style proxy that accepts clients, checks request headers, connects to an allowed target, and relays bytes. Other nodes preserve substantial configuration and service areas visible in the tree without guessing their wiring. Evidence for those unsampled areas is limited to filenames and the README.

Main entry points: [`Fls/ws.py`](https://github.com/genome96/darkaons/blob/main/Fls/ws.py) (Connection handler), [`v5.sh`](https://github.com/genome96/darkaons/blob/main/v5.sh) (Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup"]
  node_installer["Installer<br/>[v5.sh]"]
end

subgraph group_proxy["Proxy runtime"]
  node_ws_server["WS server<br/>[ws.py]"]
  node_ws_handler["Connection handler<br/>[ws.py]"]
end

subgraph group_deployment["Deployment components"]
  node_configs["Service configs"]
  node_service_files["Service definitions"]
  node_vpn_files["VPN components"]
  node_bot_archives["Bot archives"]
  node_menu_archive["Menu archive<br/>[menu.zip]"]
end

node_operator(("Operator"))
node_target(("Tunnel target"))

node_operator -->|"runs"| node_installer
node_ws_server -->|"spawns"| node_ws_handler
node_ws_handler -->|"connects"| node_target

click node_installer "https://github.com/genome96/darkaons/blob/main/v5.sh"
click node_ws_server "https://github.com/genome96/darkaons/blob/main/Fls/ws.py"
click node_ws_handler "https://github.com/genome96/darkaons/blob/main/Fls/ws.py"
click node_configs "https://github.com/genome96/darkaons/tree/main/Cfg"
click node_service_files "https://github.com/genome96/darkaons/tree/main/Fls"
click node_vpn_files "https://github.com/genome96/darkaons/tree/main/Vpn"
click node_bot_archives "https://github.com/genome96/darkaons/tree/main/Bot"
click node_menu_archive "https://github.com/genome96/darkaons/blob/main/Cdy/menu.zip"

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_installer toneBlue
class node_ws_server,node_ws_handler toneAmber
class node_configs,node_service_files,node_vpn_files,node_bot_archives,node_menu_archive toneMint
class node_operator,node_target toneIndigo
```

## Components

### Setup

- [Installer](https://github.com/genome96/darkaons/blob/main/v5.sh): `v5.sh`

### Proxy runtime

- [WS server](https://github.com/genome96/darkaons/blob/main/Fls/ws.py): `Fls/ws.py`
- [Connection handler](https://github.com/genome96/darkaons/blob/main/Fls/ws.py): `Fls/ws.py`

### Deployment components

- [Service configs](https://github.com/genome96/darkaons/tree/main/Cfg): `Cfg`
- [Service definitions](https://github.com/genome96/darkaons/tree/main/Fls): `Fls`
- [VPN components](https://github.com/genome96/darkaons/tree/main/Vpn): `Vpn`
- [Bot archives](https://github.com/genome96/darkaons/tree/main/Bot): `Bot`
- [Menu archive](https://github.com/genome96/darkaons/blob/main/Cdy/menu.zip): `Cdy/menu.zip`

### Other components

- **Operator**
- **Tunnel target**

## Connections

- Operator → Installer: runs (evidence: `README.md`)
- WS server → Connection handler: spawns (evidence: `Fls/ws.py`)
- Connection handler → Tunnel target: connects (evidence: `Fls/ws.py`)
