# someonelikedani/mtproxy-installer architecture

> Architecture diagram of the GitHub repository someonelikedani/mtproxy-installer, 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/someonelikedani/mtproxy-installer
- Repository: https://github.com/someonelikedani/mtproxy-installer

## Overview

This repository is a shell-based installer and uninstaller for a private MTProxy on Ubuntu/Debian. An operator runs the installer, which obtains and builds upstream MTProxy, configures its systemd service, stores protected settings, and prints Telegram connection links. Optional branches pin an upstream version and enable anti-abuse rules; uninstall removes the installation and its iptables abuse chain. Only README documentation was available, so relationships below reflect documented behavior rather than inspected shell calls.

Main entry points: [`install.sh`](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh) (Installer CLI), [`uninstall.sh`](https://github.com/someonelikedani/mtproxy-installer/blob/main/uninstall.sh) (Uninstaller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Installation"]
  node_installer["Installer CLI<br/>[install.sh]"]
  node_upstream["Official MTProxy"]
  node_version["Version selection<br/>[install.sh]"]
  node_build["MTProxy build<br/>[install.sh]"]
  node_dependencies["Dependencies<br/>[install.sh]"]
end

subgraph group_operations["Service and state"]
  node_systemd["systemd service"]
  node_proxy["MTProxy service<br/>[install.sh]"]
  node_state[("Install state")]
  node_status["Status and checks<br/>[install.sh]"]
  node_uninstaller["Uninstaller<br/>[uninstall.sh]"]
end

subgraph group_security["Security and access"]
  node_antiabuse["Anti-abuse rules<br/>[install.sh]"]
  node_firewall["Firewall backend"]
  node_ip["Server IP detection<br/>[install.sh]"]
  node_links["Telegram links<br/>[install.sh]"]
end

node_operator(("Operator"))

node_operator -->|"runs"| node_installer
node_installer -->|"installs"| node_dependencies
node_installer -->|"clones"| node_upstream
node_installer -->|"selects"| node_version
node_version -->|"pins ref"| node_upstream
node_installer -->|"builds"| node_build
node_build -->|"produces"| node_proxy
node_installer -->|"creates unit"| node_systemd
node_systemd -->|"runs"| node_proxy
node_installer -->|"saves settings"| node_state
node_operator -->|"requests"| node_status
node_operator -->|"runs"| node_uninstaller
node_operator -.->|"enables"| node_antiabuse
node_antiabuse -->|"configures"| node_firewall
node_uninstaller -->|"removes chain"| node_firewall
node_installer -->|"detects IP"| node_ip
node_installer -->|"prints"| node_links

click node_installer "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_version "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_build "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_dependencies "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_proxy "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_status "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_uninstaller "https://github.com/someonelikedani/mtproxy-installer/blob/main/uninstall.sh"
click node_antiabuse "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_ip "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"
click node_links "https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh"

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,node_upstream,node_version,node_build,node_dependencies toneBlue
class node_systemd,node_proxy,node_state,node_status,node_uninstaller toneAmber
class node_antiabuse,node_firewall,node_ip,node_links toneMint
class node_operator toneIndigo
```

## Components

### Installation

- [Installer CLI](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`
- **Official MTProxy**
- [Version selection](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`
- [MTProxy build](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`
- [Dependencies](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`

### Service and state

- **systemd service**
- [MTProxy service](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`
- **Install state**
- [Status and checks](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`
- [Uninstaller](https://github.com/someonelikedani/mtproxy-installer/blob/main/uninstall.sh): `uninstall.sh`

### Security and access

- [Anti-abuse rules](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`
- **Firewall backend**
- [Server IP detection](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`
- [Telegram links](https://github.com/someonelikedani/mtproxy-installer/blob/main/install.sh): `install.sh`

### Other components

- **Operator**

## Connections

- Operator → Installer CLI: runs (evidence: `README.md`)
- Installer CLI → Dependencies: installs (evidence: `README.md`)
- Installer CLI → Official MTProxy: clones (evidence: `README.md`)
- Installer CLI → Version selection: selects (evidence: `README.md`)
- Version selection → Official MTProxy: pins ref (evidence: `README.md`)
- Installer CLI → MTProxy build: builds (evidence: `README.md`)
- MTProxy build → MTProxy service: produces (evidence: `README.md`)
- Installer CLI → systemd service: creates unit (evidence: `README.md`)
- systemd service → MTProxy service: runs (evidence: `README.md`)
- Installer CLI → Install state: saves settings (evidence: `README.md`)
- Operator → Status and checks: requests (evidence: `README.md`)
- Operator → Uninstaller: runs (evidence: `README.md`)
- Operator → Anti-abuse rules: enables (evidence: `README.md`)
- Anti-abuse rules → Firewall backend: configures (evidence: `README.md`)
- Uninstaller → Firewall backend: removes chain (evidence: `README.md`)
- Installer CLI → Server IP detection: detects IP (evidence: `README.md`)
- Installer CLI → Telegram links: prints (evidence: `README.md`)
