# soufianetahiri/mirai-botnet architecture

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

- Interactive diagram: https://gitdiagram.com/soufianetahiri/mirai-botnet
- Repository: https://github.com/soufianetahiri/mirai-botnet

## Overview

This repository contains Mirai’s bot, command-and-control service, and Telnet loader. The documented operational loop is bot discovery/reporting, result reception, loading, and subsequent bot activity; the bot also resolves and connects to the CNC, where commands are managed. The graph keeps those product stages distinct from the bot’s internal runtime. Relationships among unsampled CNC modules and some loader startup details are not inferred; edges reflect sampled source or explicit README statements.

Main entry points: [`mirai/bot/main.c`](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/main.c) (Bot runtime), [`mirai/bot/attack.c`](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack.c) (Command execution), [`mirai/cnc`](https://github.com/soufianetahiri/mirai-botnet/tree/master/mirai/cnc) (CNC service), [`loader/src/server.c`](https://github.com/soufianetahiri/mirai-botnet/blob/master/loader/src/server.c) (Telnet loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bot["Bot runtime"]
  node_botmain["Bot runtime<br/>[main.c]"]
  node_scanner["Device discovery<br/>[scanner.c]"]
  node_resolver["Domain resolution<br/>[resolv.c]"]
  node_attack["Command execution<br/>[attack.c]"]
  node_attackapp["Application methods<br/>[attack_app.c]"]
  node_attacktcp["TCP methods<br/>[attack_tcp.c]"]
  node_attackudp["UDP methods<br/>[attack_udp.c]"]
  node_attackgre["GRE methods<br/>[attack_gre.c]"]
  node_killer["Process management<br/>[killer.c]"]
end

subgraph group_control["Control plane"]
  node_cnc["CNC service"]
  node_cncdb[("CNC database access<br/>[database.go]")]
  node_clientlist["Bot client list<br/>[clientList.go]"]
end

subgraph group_loading["Loading pipeline"]
  node_scanlisten["Result receiver<br/>[scanListen.go]"]
  node_loader["Telnet loader<br/>[server.c]"]
  node_loaderconn["Loader connections<br/>[connection.c]"]
  node_loaderbinary["Binary selection<br/>[binary.c]"]
end

subgraph group_support["Operational utilities"]
  node_enc["Table encoder<br/>[enc.c]"]
end

node_operator(("Operator"))
node_database[("MySQL service")]

node_operator -.->|"manages"| node_cnc
node_cnc -.->|"uses"| node_cncdb
node_cncdb -.->|"stores data"| node_database
node_botmain -->|"resolves CNC"| node_resolver
node_botmain -->|"connects"| node_cnc
node_botmain -->|"starts"| node_scanner
node_botmain -->|"initializes"| node_attack
node_botmain -->|"initializes"| node_killer
node_attack -.->|"dispatches"| node_attackapp
node_attack -.->|"dispatches"| node_attacktcp
node_attack -.->|"dispatches"| node_attackudp
node_attack -.->|"dispatches"| node_attackgre
node_scanner -->|"reports results"| node_scanlisten
node_scanlisten -->|"forwards results"| node_loader
node_loader -->|"handles sessions"| node_loaderconn
node_loader -.->|"selects payload"| node_loaderbinary
node_cnc -.->|"tracks clients"| node_clientlist
node_operator -->|"configures strings"| node_enc

click node_botmain "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/main.c"
click node_scanner "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/scanner.c"
click node_resolver "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/resolv.c"
click node_attack "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack.c"
click node_attackapp "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_app.c"
click node_attacktcp "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_tcp.c"
click node_attackudp "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_udp.c"
click node_attackgre "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_gre.c"
click node_killer "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/killer.c"
click node_cnc "https://github.com/soufianetahiri/mirai-botnet/tree/master/mirai/cnc"
click node_cncdb "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/cnc/database.go"
click node_clientlist "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/cnc/clientList.go"
click node_scanlisten "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/tools/scanListen.go"
click node_loader "https://github.com/soufianetahiri/mirai-botnet/blob/master/loader/src/server.c"
click node_loaderconn "https://github.com/soufianetahiri/mirai-botnet/blob/master/loader/src/connection.c"
click node_loaderbinary "https://github.com/soufianetahiri/mirai-botnet/blob/master/loader/src/binary.c"
click node_enc "https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/tools/enc.c"

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_botmain,node_scanner,node_resolver,node_attack,node_attackapp,node_attacktcp,node_attackudp,node_attackgre,node_killer toneBlue
class node_cnc,node_cncdb,node_clientlist,node_database toneAmber
class node_scanlisten,node_loader,node_loaderconn,node_loaderbinary toneMint
class node_enc toneRose
class node_operator toneIndigo
```

## Components

### Bot runtime

- [Bot runtime](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/main.c): `mirai/bot/main.c`
- [Device discovery](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/scanner.c): `mirai/bot/scanner.c`
- [Domain resolution](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/resolv.c): `mirai/bot/resolv.c`
- [Command execution](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack.c): `mirai/bot/attack.c`
- [Application methods](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_app.c): `mirai/bot/attack_app.c`
- [TCP methods](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_tcp.c): `mirai/bot/attack_tcp.c`
- [UDP methods](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_udp.c): `mirai/bot/attack_udp.c`
- [GRE methods](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/attack_gre.c): `mirai/bot/attack_gre.c`
- [Process management](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/bot/killer.c): `mirai/bot/killer.c`

### Control plane

- [CNC service](https://github.com/soufianetahiri/mirai-botnet/tree/master/mirai/cnc): `mirai/cnc`
- [CNC database access](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/cnc/database.go): `mirai/cnc/database.go`
- [Bot client list](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/cnc/clientList.go): `mirai/cnc/clientList.go`

### Loading pipeline

- [Result receiver](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/tools/scanListen.go): `mirai/tools/scanListen.go`
- [Telnet loader](https://github.com/soufianetahiri/mirai-botnet/blob/master/loader/src/server.c): `loader/src/server.c`
- [Loader connections](https://github.com/soufianetahiri/mirai-botnet/blob/master/loader/src/connection.c): `loader/src/connection.c`
- [Binary selection](https://github.com/soufianetahiri/mirai-botnet/blob/master/loader/src/binary.c): `loader/src/binary.c`

### Operational utilities

- [Table encoder](https://github.com/soufianetahiri/mirai-botnet/blob/master/mirai/tools/enc.c): `mirai/tools/enc.c`

### Other components

- **Operator**
- **MySQL service**

## Connections

- Operator → CNC service: manages
- CNC service → CNC database access: uses
- CNC database access → MySQL service: stores data
- Bot runtime → Domain resolution: resolves CNC (evidence: `mirai/bot/main.c`)
- Bot runtime → CNC service: connects
- Bot runtime → Device discovery: starts (evidence: `mirai/bot/main.c`)
- Bot runtime → Command execution: initializes (evidence: `mirai/bot/main.c`)
- Bot runtime → Process management: initializes (evidence: `mirai/bot/main.c`)
- Command execution → Application methods: dispatches
- Command execution → TCP methods: dispatches
- Command execution → UDP methods: dispatches
- Command execution → GRE methods: dispatches
- Device discovery → Result receiver: reports results
- Result receiver → Telnet loader: forwards results
- Telnet loader → Loader connections: handles sessions (evidence: `loader/src/server.c`)
- Telnet loader → Binary selection: selects payload
- CNC service → Bot client list: tracks clients
- Operator → Table encoder: configures strings
