arm64builds/mtproxy repository overview

⁠🛡️ Telegram MTProto Proxy Docker

Anti-Censorship & Pro Privacy

Unblock Telegram instantly with this ultra-lightweight, multi-architecture MTProto Proxy.
Designed for privacy, security, and bypassing censorship (DPI) using FakeTLS.

🚀 Fix Telegram Lag & Throttling
Perfect for regions where Telegram is slowed down. Enjoy instant message delivery and fast video downloads without buffering.

Ideal for Raspberry Pi, low-end VPS, and servers with limited resources.

---

⁠🏆 Why use this over the official image?

The official telegrammessenger/proxy Docker image has not been updated since 2018.
It is outdated, heavy, and lacks support for modern secure protocols.

This image is superior because:

• 🚀 Modern & Maintained — Built on a current, actively maintained Go MTProto library
• 🛡️ More Secure — Supports modern FakeTLS and anti-replay protections
• 📉 95% Smaller — Official image is ~200MB+, this image is ~10MB
• 🌐 Universal — Native support for ARM64 (Raspberry Pi, Ampere), AMD64, and more

---

⁠📋 Table of Contents

• ✨ Key Features
• 🚀 Quick Start
• 🐳 Docker Compose
• ⚙️ Configuration
• 💾 Persistence
• 🔧 Troubleshooting
• 🤝 Credits

---

⁠✨ Key Features

• 🌐 Multi-Architecture Support

  Runs on almost everything:

  linux/amd64, linux/arm64, linux/arm/v7, linux/riscv64,
  linux/s390x, linux/ppc64le, linux/386

• ⚡ High Speed & Anti-Throttling

  Bypasses ISP throttling so Telegram works at full speed.

• 📦 Ultra Lightweight

  Based on Alpine Linux — compressed image size is only ~10–15MB.

• 🔒 FakeTLS (DPI Bypass)

  Disguises traffic as normal HTTPS (default: cdnjs.cloudflare.com).

• 🛡️ Anti-Replay Protection

  Prevents active probing attacks.

• 👁️ Privacy First

  The proxy acts as a blind tunnel and does not log traffic.

• 🔑 Secure by Default

  Automatically generates strong random secrets.

---

⁠🚀 Quick Start

docker run -d
--name mtproxy
--restart always
-p 8443:8888
arm64builds/mtproxy:latest

View connection links:

docker logs mtproxy

---

⁠🐳 Docker Compose (Recommended)

mkdir -p ~/mtproxy && cd ~/mtproxy curl -O https://raw.githubusercontent.com/cleanerspam/MTProxy/main/docker-compose.yml⁠

echo "HOST_PORT=443" > .env echo "SECRET=" >> .env

docker compose up -d docker compose logs -f mtproxy

---

⁠⚙️ Configuration

---

⁠💾 Persistence

touch .env

docker run -d
-p 8443:8888
-v $(pwd)/.env:/data/.env
arm64builds/mtproxy:latest

---

⁠🔧 Troubleshooting

Check logs:

docker logs mtproxy

Open firewall port:

sudo ufw allow 443/tcp

---

⁠🤝 Credits

Core library: https://github.com/9seconds/mtg⁠
Protocol: Telegram MTProto

"Arguing that you don't care about the right to privacy because you have nothing to hide is no different than saying you don't care about free speech because you have nothing to say."
— Edward Snowden