MTProxyMax

The Ultimate Telegram MTProto Proxy Manager

One script. Full control. Zero hassle.

Version License Engine Platform Bash Docker

Quick Start • Features • Comparison • Telegram Bot • CLI Reference • Changelog

--- MTProxyMax is a full-featured Telegram MTProto proxy manager powered by the **telemt 3.x Rust engine**. It wraps the raw proxy engine with an interactive TUI, a complete CLI, a Telegram bot for remote management, per-user access control, traffic monitoring, proxy chaining, and automatic updates — all in a single bash script. MTProxyMax Main Menu ```bash sudo bash -c "$(curl -fsSL https://git.samnet.dev/SamNet-dev/MTProxyMax/raw/branch/main/install.sh)" ``` Alternative (mirror, for restricted regions): ```bash sudo bash -c "$(curl -fsSL https://dl.samnet.dev/SamNet-dev/MTProxyMax/raw/branch/main/install.sh)" ``` --- ## Why MTProxyMax? Most MTProxy tools give you a proxy and a link. That's it. MTProxyMax gives you a **full management platform**: - 🔐 **Multi-user secrets** with individual bandwidth quotas, device limits, and expiry dates - 🤖 **Telegram bot** with 17 commands — manage everything from your phone - 🖥️ **Interactive TUI** — no need to memorize commands, menu-driven setup - 📊 **Prometheus metrics** — real per-user traffic stats, not just iptables guesses - 🔗 **Proxy chaining** — route through SOCKS5 upstreams for extra privacy - 🔄 **Auto-recovery** — detects downtime, restarts automatically, alerts you on Telegram - 🐳 **Pre-built Docker images** — installs in seconds, not minutes --- ## 🚀 Quick Start ### One-Line Install ```bash sudo bash -c "$(curl -fsSL https://git.samnet.dev/SamNet-dev/MTProxyMax/raw/branch/main/install.sh)" ``` Alternative (mirror, for restricted regions): ```bash sudo bash -c "$(curl -fsSL https://dl.samnet.dev/SamNet-dev/MTProxyMax/raw/branch/main/install.sh)" ``` The interactive wizard walks you through everything: port, domain, first user secret, and optional Telegram bot setup. ### Manual Install ```bash curl -fsSL https://git.samnet.dev/SamNet-dev/MTProxyMax/raw/branch/main/mtproxymax.sh -o mtproxymax chmod +x mtproxymax sudo ./mtproxymax install ``` Alternative (mirror): `curl -fsSL https://dl.samnet.dev/SamNet-dev/MTProxyMax/raw/branch/main/mtproxymax.sh -o mtproxymax` ### After Install ```bash mtproxymax # Open interactive TUI mtproxymax status # Check proxy health ``` --- ## ✨ Features ### 🛡️ FakeTLS V2 Obfuscation Your proxy traffic looks identical to normal HTTPS traffic. The **Fake TLS V2** engine mirrors real TLS 1.3 sessions — per-domain profiles, real cipher suites, dynamic certificate lengths, and realistic record fragmentation. The TLS handshake SNI points to a cover domain (e.g., `cloudflare.com`), making it indistinguishable from regular web browsing to any DPI system. **Traffic masking** goes further — when a non-Telegram client probes your server, the connection is forwarded to the real cover domain. Your server responds exactly like cloudflare.com would. --- ### 👥 Multi-User Secret Management Each user gets their own **secret key** with a human-readable label: - **Add/remove** users instantly — config regenerates and proxy hot-reloads - **Enable/disable** access without deleting the key - **Rotate** a user's secret — new key, same label, old link stops working - **QR codes** — scannable directly in Telegram --- ### 🔒 Per-User Access Control Fine-grained limits enforced at the engine level: | Limit | Description | Example | |-------|-------------|---------| | **Max Connections** | Simultaneous TCP connections | `100` | | **Max IPs** | Unique devices/IPs allowed | `5` | | **Data Quota** | Total bandwidth cap | `10G`, `500M` | | **Expiry Date** | Auto-disable after date | `2026-12-31` | ```bash mtproxymax secret setlimits alice 100 5 10G 2026-12-31 ``` --- ### 📋 User Management Recipes
Prevent Key Sharing ```bash mtproxymax secret setlimit alice ips 1 # Single person only mtproxymax secret setlimit family ips 5 # Family of up to 5 devices ``` If someone with `ips 1` shares their link, the second device gets rejected automatically.
IP Limit Tiers | Scenario | `max_ips` | |----------|-----------| | Single person, one device | `1` | | Single person, multiple devices | `2-3` | | Small family | `5` | | Small group / office | `20-30` | | Public/open link | `0` (unlimited) |
Time-Limited Sharing Link ```bash mtproxymax secret add shared-link mtproxymax secret setlimits shared-link 50 30 10G 2026-06-01 ``` When the expiry date hits, the link stops working automatically.
Per-Person Keys (Recommended) ```bash mtproxymax secret add alice mtproxymax secret add bob mtproxymax secret add charlie # Each person gets their own link — revoke individually mtproxymax secret setlimit alice ips 2 mtproxymax secret setlimit bob ips 1 mtproxymax secret setlimit charlie ips 3 ```
Disable, Rotate, Remove ```bash mtproxymax secret disable bob # Temporarily cut off mtproxymax secret enable bob # Restore access mtproxymax secret rotate alice # New key, old link dies instantly mtproxymax secret remove bob # Permanent removal ```
--- ### 🤖 Telegram Bot (17 Commands) Full proxy management from your phone. Setup takes 60 seconds: ```bash mtproxymax telegram setup ``` | Command | Description | |---------|-------------| | `/mp_status` | Proxy status, uptime, connections | | `/mp_secrets` | List all users with active connections | | `/mp_link` | Get proxy details + QR code image | | `/mp_add