MTProxy Docker Installation Script

Версия на русском языке

A simple, reliable, and automated script for installing the Telegram MTProxy server using Docker. This script solves all the complexities of configuring the Telegram proxy server.

📋 Table of Contents

• Overview
• Features
• Requirements
• Quick Start
• Installation Guide
• Usage
• Management Commands
• Troubleshooting
• Uninstallation
• Contributing
• License

🔍 Overview

MTProxy is the official Telegram proxy server that allows users to bypass network restrictions while maintaining secure connections. This script automates the entire installation process using Docker, making it accessible even for users with minimal technical knowledge.

What this script does:

1. Checks system requirements - Verifies root access and system compatibility
2. Installs Docker - Automatically installs Docker if not present
3. Cleans up old installations - Removes any existing MTProxy installations
4. Configures the proxy - Sets up MTProxy with your chosen port
5. Manages firewall rules - Opens necessary ports in UFW/firewalld
6. Generates connection details - Creates ready-to-use proxy links
7. Creates management tools - Installs the mtproxy command for easy management
8. Sets up auto-updates - Configures weekly automatic updates via cron

✨ Features

• 🚀 One-line installation - No complex configuration needed
• 🐳 Docker-based - Isolated, secure, and easy to manage
• 🔐 Automatic secret generation - Secure proxy credentials created automatically
• 🔧 Custom port selection - Choose any available port
• 🛡️ Firewall auto-configuration - Works with UFW and firewalld
• 📊 Built-in management commands - Easy control after installation
• 🔄 Auto-updates - Keeps your proxy server up-to-date
• 📱 QR code generation - Quick mobile setup (if qrencode installed)
• 💾 Persistent configuration - Settings saved across restarts

📦 Requirements

• Operating System: Ubuntu, Debian, CentOS, or any Linux distribution with systemd
• Architecture: x86_64 (amd64)
• Access: Root or sudo privileges
• Network:
  • Public IP address
  • Open port (you choose during installation, default: 8443)
  • Stable internet connection
• RAM: Minimum 512MB
• Disk Space: Minimum 1GB free space

🚀 Quick Start

# Download and run the installation script
wget https://raw.githubusercontent.com/statix05/MTProxyInstall/main/install.sh
chmod +x install.sh
sudo ./install.sh

That's it! Follow the prompts and your proxy will be ready in minutes.

📖 Installation Guide

Step 1: Download the Script

# Using wget
wget https://raw.githubusercontent.com/statix05/MTProxyInstall/main/install.sh

# Or using curl
curl -O https://raw.githubusercontent.com/statix05/MTProxyInstall/main/install.sh

Step 2: Make it Executable

chmod +x install.sh

Step 3: Run the Installation

sudo ./install.sh

Step 4: Follow the Prompts

1. The script will ask for a port number (press Enter for default 8443)
2. Wait for the installation to complete
3. Copy the generated proxy links

Step 5: Configure Your Telegram Client

Use one of the generated links to add the proxy to your Telegram:

• Direct link: tg://proxy?server=YOUR_IP&port=YOUR_PORT&secret=YOUR_SECRET
• Web link: https://t.me/proxy?server=YOUR_IP&port=YOUR_PORT&secret=YOUR_SECRET

💻 Usage

During Installation

$ sudo ./install.sh
=== MTProxy Docker Installation ===

Cleaning up old installations...
Enter proxy port (default 8443): 9443
Starting MTProxy...
✓ MTProxy started successfully!

Connection details:
IP: 123.45.67.89
Port: 9443
Secret: abc123def456...

Connection links:
tg://proxy?server=123.45.67.89&port=9443&secret=abc123def456...

After Installation

The script creates a mtproxy command for easy management:

# Check proxy status
mtproxy status

# View real-time logs
mtproxy logs

# Show connection information
mtproxy info

🛠️ Management Commands

Command	Description
mtproxy status	Check if proxy is running and show port
mtproxy logs	View real-time proxy logs (Ctrl+C to exit)
mtproxy info	Display connection links and proxy details
mtproxy restart	Restart the proxy server
mtproxy stop	Stop the proxy server
mtproxy start	Start the proxy server
mtproxy update	Update to the latest MTProxy version

Examples

# Check if proxy is running
$ mtproxy status
CONTAINER ID   IMAGE                      STATUS         PORTS
abc123def456   telegrammessenger/proxy   Up 2 hours     0.0.0.0:9443->443/tcp
Proxy port: 9443

# View logs
$ mtproxy logs
[*] Starting proxy...
[*] Secret: abc123def456...
[*] Listening on port 443

# Get connection info
$ mtproxy info
MTProxy Information:
===================
IP: 123.45.67.89
Port: 9443
Secret: abc123def456...

Connection links:
tg://proxy?server=123.45.67.89&port=9443&secret=abc123def456...

🔧 Troubleshooting

Common Issues

1. Permission Denied

# Make sure to run with sudo
sudo ./install.sh

2. Port Already in Use

# Check what's using the port
sudo lsof -i :8443
# Choose a different port during installation

3. Cannot Connect to Proxy

# Check if container is running
docker ps | grep mtproxy

# Check firewall
sudo ufw status

# View logs for errors
mtproxy logs

4. Docker Installation Failed

# Install Docker manually
curl -fsSL https://get.docker.com | sudo sh

Getting Help

• Check logs: mtproxy logs
• Verify status: mtproxy status
• Connection info saved in: /etc/mtproxy/info.txt

🗑️ Uninstallation

To completely remove MTProxy and all its data:

# Download cleanup script
wget https://raw.githubusercontent.com/statix05/MTProxyInstall/main/cleanup.sh
chmod +x cleanup.sh
sudo ./cleanup.sh

This will:

• Stop and remove Docker containers
• Delete all proxy data
• Remove systemd services
• Clean up configuration files
• Close firewall ports

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Telegram MTProxy - Official Telegram proxy server
• Docker - Container platform
• Community contributors

---

⭐ If this script helped you, please consider giving it a star on GitHub!