# matrixtm/mhddos architecture

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

- Interactive diagram: https://gitdiagram.com/matrixtm/mhddos
- Repository: https://github.com/matrixtm/mhddos

## Overview

MHDDoS is a network-testing toolkit with both a command-line runner and web-panel implementations. The web workflow is: an operator submits a task in the panel, its backend validates the request and starts the Python runner, and the panel tracks task state and logs. The README documents Layer 7, Layer 4/3, amplification, utility, and console capabilities; those method families are grouped here rather than enumerated. The tree and excerpts show two backend implementations, but do not establish which is the preferred deployment. Links for unsampled routes and subsystems are omitted.

Main entry points: [`web/public/app.js`](https://github.com/matrixtm/mhddos/blob/main/web/public/app.js) (Panel interface), [`start.py`](https://github.com/matrixtm/mhddos/blob/main/start.py) (Task runner), [`web/app.py`](https://github.com/matrixtm/mhddos/blob/main/web/app.py) (Flask API), [`web/src/server.ts`](https://github.com/matrixtm/mhddos/blob/main/web/src/server.ts) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web panel"]
  node_panel["Panel interface<br/>[app.js]"]
  node_locales["Localization<br/>[i18n.js]"]
end

subgraph group_backend["Panel backends"]
  node_flask["Flask API<br/>[app.py]"]
  node_express["Express API<br/>[server.ts]"]
  node_diagnostics["Network diagnostics<br/>[app.py]"]
  node_system["Host metrics<br/>[app.py]"]
  node_auth["Token auth<br/>[app.py]"]
end

subgraph group_runtime["Test runtime"]
  node_runner["Task runner<br/>[start.py]"]
end

subgraph group_resources["Panel resources"]
  node_datafiles["Proxy and request data"]
end

node_operator(("Operator"))
node_target(("Authorized test target"))
node_external(("Network services"))

node_operator -->|"uses"| node_panel
node_panel -->|"requests API"| node_flask
node_panel -.->|"requests API"| node_express
node_panel -->|"loads strings"| node_locales
node_flask -->|"starts task"| node_runner
node_express -->|"spawns task"| node_runner
node_runner -->|"sends test traffic"| node_target
node_runner -->|"reads resources"| node_datafiles
node_panel -->|"requests checks"| node_diagnostics
node_diagnostics -->|"queries network"| node_external
node_panel -->|"requests metrics"| node_system
node_panel -->|"requests token"| node_auth

click node_panel "https://github.com/matrixtm/mhddos/blob/main/web/public/app.js"
click node_locales "https://github.com/matrixtm/mhddos/blob/main/web/public/i18n.js"
click node_flask "https://github.com/matrixtm/mhddos/blob/main/web/app.py"
click node_express "https://github.com/matrixtm/mhddos/blob/main/web/src/server.ts"
click node_runner "https://github.com/matrixtm/mhddos/blob/main/start.py"
click node_datafiles "https://github.com/matrixtm/mhddos/tree/main/files"
click node_diagnostics "https://github.com/matrixtm/mhddos/blob/main/web/app.py"
click node_system "https://github.com/matrixtm/mhddos/blob/main/web/app.py"
click node_auth "https://github.com/matrixtm/mhddos/blob/main/web/app.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_panel,node_locales toneBlue
class node_flask,node_express,node_diagnostics,node_system,node_auth toneAmber
class node_runner toneMint
class node_datafiles toneRose
class node_operator,node_target,node_external toneIndigo
```

## Components

### Web panel

- [Panel interface](https://github.com/matrixtm/mhddos/blob/main/web/public/app.js): `web/public/app.js`
- [Localization](https://github.com/matrixtm/mhddos/blob/main/web/public/i18n.js): `web/public/i18n.js`

### Panel backends

- [Flask API](https://github.com/matrixtm/mhddos/blob/main/web/app.py): `web/app.py`
- [Express API](https://github.com/matrixtm/mhddos/blob/main/web/src/server.ts): `web/src/server.ts`
- [Network diagnostics](https://github.com/matrixtm/mhddos/blob/main/web/app.py): `web/app.py`
- [Host metrics](https://github.com/matrixtm/mhddos/blob/main/web/app.py): `web/app.py`
- [Token auth](https://github.com/matrixtm/mhddos/blob/main/web/app.py): `web/app.py`

### Test runtime

- [Task runner](https://github.com/matrixtm/mhddos/blob/main/start.py): `start.py`

### Panel resources

- [Proxy and request data](https://github.com/matrixtm/mhddos/tree/main/files): `files`

### Other components

- **Operator**
- **Authorized test target**
- **Network services**

## Connections

- Operator → Panel interface: uses
- Panel interface → Flask API: requests API
- Panel interface → Express API: requests API
- Panel interface → Localization: loads strings
- Flask API → Task runner: starts task
- Express API → Task runner: spawns task
- Task runner → Authorized test target: sends test traffic
- Task runner → Proxy and request data: reads resources
- Panel interface → Network diagnostics: requests checks
- Network diagnostics → Network services: queries network
- Panel interface → Host metrics: requests metrics
- Panel interface → Token auth: requests token
