Proxy server for MTProto (Telegram)

0.1.6 2018-05-27 15:04 UTC

This package is auto-updated.

Last update: 2021-02-06 02:28:55 UTC


Latest Stable Version Latest Unstable Version

This is just a useful scripts for setting up your own mtprotocol proxy for telegram. Note: this proxy once created can be used by other users who you shared this proxy with and it doesn't give them access to your account, so its completely safe to use it and share with friends! Plus: Sponsored channels are coming. That means that your proxy can force your users to subscribe to some channel. This can be as a motivation to setup such a proxy.

Testing MTProto proxy servers


Supports channel advertising, fully supports ipv6 and the easiest to installl!

Note: Requires to install python3 and python3-crypto packages via apt-get Installation of docker version: https://p1ratrulezzz.me/2018/06/eshhe-odin-variant-mtproto-proxy-s-reklamoj.html

Installation on CentOS (automatic): Check the tutorial in repo https://github.com/HirbodBehnam/MTProtoProxyCentOSInstall and don't forget to star.

Easy install on CentOS command

wget -O - https://git.io/vhgUt | sudo -E bash -

Installation on Ubuntu/Debian:

   cd /opt
   git clone https://github.com/alexbers/mtprotoproxy.git
   cd mtprotoproxy
   apt-get install python3 python3-crypto
   ## edit config.py file with desired port and proxy tag and start! ##
   python3 mtprotoproxy.py

Repo: https://github.com/alexbers/mtprotoproxy (Star this repo and share with friends)

C (Official Telegram MTProxy)

Opinions: Difficult to install. Great use of resources, supports channel advertising, works stable if was successfully installed. Doesn't work on some servers expecially on servers located at Russia (even using VPN). I do not recommend to install unless you want to advertise your channel (in this case it's better to use Python version anyway).

Note: It is a very first version so it can be quite tricky to make it work, though it is possible. Also check my fork with tutorials here https://github.com/p1ratrulezzz/MTProxy-1 and here https://p1ratrulezzz.me/2018/06/creating-your-own-official-mtproto-proxy-with-channel-promotion-very-easy-way.html

Repo: https://github.com/TelegramMessenger/MTProxy

And yes. This server does have an ability to set promoted channel (check my forked repo and blogpost for tutorial)

Server #1: https://t-do.ru/proxy?server=hrushka.peppa.dns-cloud.net&port=587&secret=ddace63eff7aefb133be6e72f5f57d8382

PHP (this repo)

Note: there is an issue with Android clients. It's impossible to send messages. Desktop clients work great.

Pleae, test the servers above to gather statistics on CPU load and etc. Version 0.1.6 has an issue with creating a lot of zombie forks and killing the server completely. Set memory_limit to 32MB on your server per PHP script to save some resources.


Repo: https://github.com/FreedomPrevails/JSMTProxy

Note: if a lot of people are connected and uploading files, server will suffer from high CPU load


Note: requires JRE 8 or JDK 8. On version 9 and higher won't work.

Repo: https://github.com/makkarpov/mtoxy

Before you start installation

Some VPS providers are blocking Telegram connections from their servers. Here is the list of these services and it will be filled in during some time, but for now there are already these ones:

  • OVH
  • IPhoster

Don't use these providers for your MTProto proxy server.


The initial daemon file is in https://github.com/danog/MadelineProto (don't forget to Star this repo)

Tutorial for Ubuntu 16.04 Server

  1. Loggining in via SSH to your VDS as root
  2. Install requirements
   apt-get update
   apt-get install php7.0-cli php7.0-xml php7.0-curl php7.0-opcache php7.0-zip
   apt-get install composer
   wget -O composer-setup.php https://getcomposer.org/installer && php composer-setup.php --install-dir=$(dirname $(which composer)) --filename=composer && rm composer-setup.php
  1. Create mtproxy user
  useradd --shell /usr/sbin/nologin -M -u 3000 -o mtproxy

Note: password you set doesn't matter

  1. Download a package into /opt folder
  cd /opt/
  composer require p1ratrulezzz/mtproxy-server-linux ^0.1
  sh vendor/p1ratrulezzz/mtproxy-server-linux/install.sh

After that you will see that the directory /opt/mtproto-proxy has been created.

4. Run proxy for the first time

  cd /opt/mtproto-proxy
  chmod +x mtproxyd
  ./mtproxyd marcopolo 6666

6666 - is the port to listen on marcopolo - is the seed to generate hashes. It is safe to leave it this way as created hash will be random anyway. But it is better toset your own seed and use for that the one of the generated from Random.org password of any length. It might ask you to login using your existing telegram account. This is ok, just enter your phone number and then an autorization code that you will get via Telegram. This is just a one time setup.

You will see that daemon is running and it will create a file secret.txt.

  cat secret.txt

Note: you can manualy create this file and write your own 32 character string in it. In this case it won't be rewritten.

it will show you your secret password for connecting to your proxy. Something like:


38f75d6bb9f8138e53489cf1b7a132ec - is the 32 characters secret (some kind of a password) used to auth on your proxy server. This password will be written to secret.txt file and you always can reveal it if you have root access. The easiest way to creat your own password is to use md5 hash of any of provided string using any md5 generator (online tools are also OK).

Note: the password can be set manualy. It MUST be any HEX-string (only digits and characters from range a-f and always lowercased). This key is used to encrypt your traffic using AES encryption.

Now press Ctrl+C to terminate the proxy process.

  1. Check permissions for files
  chown -R mtproxy:mtproxy /opt/mtproto-proxy
  1. Install a linux service to start/stop/restart and autostart proxy
   wget -O /etc/init.d/mtproxy 'https://raw.githubusercontent.com/p1ratrulezzz/mtproxy-server-linux/master/etc/init.d/mtproxy'
   chmod +x /etc/init.d/mtproxy
   systemctl daemon-reload
   systemctl start mtproxy
   systemctl enable mtproxy

And check if it is working

   systemctl start mtproxy

You should see that it is "active (running)"

 mtproxy.service - LSB: MTProxy service
   Loaded: loaded (/etc/init.d/mtproxy; bad; vendor preset: enabled)
   Active: active (running) since Thu 2018-05-17 21:55:08 UTC; 1 day 9h ago
     Docs: man:systemd-sysv-generator(8)
  Process: 16657 ExecStop=/etc/init.d/mtproxy stop (code=exited, status=0/SUCCESS)
  Process: 16752 ExecStart=/etc/init.d/mtproxy start (code=exited, status=0/SUCCESS)
    Tasks: 14
   Memory: 55.3M
      CPU: 1min 14.837s
   CGroup: /system.slice/mtproxy.service

Note: you should edit the file /etc/init.d/mtproxy and set your own seed and port.

  1. Test your installation

(use Alpha release as it is the only release availalble that supports MTproto proxies)

Server: your_domain_name_or_ip_address_of_vds_server Port: 6666 Secret: secret_from_secret.txt_file

Note: ip address of VDS/VPS server can be revealed by running a command

   curl ipinfo.io/ip

or (may not be usefull on servers that have internal IP but this is not our case so this should be OK)


Other proxy server implementations

Check this account https://github.com/mtProtoProxy to see all the MTProto proxy implementations.

It is possible to use daemon script from this repo to integrate with any of these servers (except nodejs, for nodejs use pm2 upstart)

Java implementation: https://github.com/makkarpov/mtoxy

Another version of installator for MTProxy (madeline driven)

Check the repo: https://github.com/aquigni/MTProxySystemd . It provides an easy-install shell script. It installs the same version of MTProto Proxy as provided in this repo