Highly-opinionated (ex-bullshit-free) MTPROTO proxy for Telegram. If you use v1.0 or upgrade broke you proxy, please read the chapter Version 2
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sergey Arkhipov 468f83bbb1
Merge pull request #8 from 9seconds/rlimit
7 vuotta sitten
client Support different client connection types 7 vuotta sitten
config Check secret length in mtg 7 vuotta sitten
mtproto Support different client connection types 7 vuotta sitten
obfuscated2 Support different client connection types 7 vuotta sitten
proxy Support different client connection types 7 vuotta sitten
scripts Add Makefile 8 vuotta sitten
telegram Support different client connection types 7 vuotta sitten
wrappers Use bytes.Buffer pools for wrappers 7 vuotta sitten
.gitignore Add boilerplate 8 vuotta sitten
.gometalinter.json Fix lint issues 8 vuotta sitten
.travis.yml Add travis yaml 8 vuotta sitten
Dockerfile Use upx for image build 7 vuotta sitten
Gopkg.lock Use pool for frames 7 vuotta sitten
Gopkg.toml Working version 8 vuotta sitten
LICENSE Initial commit 8 vuotta sitten
Makefile Fix dockerfile 7 vuotta sitten
README.md Mention run-mtg script 7 vuotta sitten
main.go Setup rlimits for application 7 vuotta sitten
run-mtg.sh Fix run-mtg 7 vuotta sitten

README.md

mtg

Bullshit-free MTPROTO proxy for Telegram

Build Status Docker Build Status

Rationale

There are several available proxies for Telegram MTPROTO available. Here are the most notable:

Almost all of them follow the way how official proxy was build. This includes support of multiple secrets, support of promoted channels etc.

mtg is an implementation in golang which is intended to be:

  • Lightweight It has to consume as less resources as possible but not by losing maintainability.
  • Easily deployable I strongly believe that Telegram proxies should follow the way of ShadowSocks: promoted channels is a strange way of doing business I suppose. I think the only viable way is to have a proxy with minimum configuration which should work everywhere.
  • Single secret I think that multiple secrets solves no problems and just complexify software. I also believe that in case of throwout proxies, this feature is useless luxury.
  • Minimum docker image size Official image is less than 2 megabytes. Literally.
  • No management WebUI This is an implementation of simple lightweight proxy. I won’t do that.

How to build

$ make

If you want to build for another platform:

$ make crosscompile

If you want to build Docker image (called mtg):

$ make docker

Docker image

$ docker pull nineseconds/mtg

Configuration

Basically, to run this tool you need to configure as less as possible.

First, you need to generate a secret:

$ openssl rand -hex 16

or

$ head -c 512 | sha1sum | cut -f 1 -d ' '

Now run the tool:

$ mtg <secret>

This tool will listen on port 3128 by default with the given secret.

One-line runner

$ docker run --name mtg --restart=unless-stopped -p 444:3128 -p 3129:3129 -d nineseconds/mtg -a 444 $(openssl rand -hex 16)

You will have this tool up and running on port 444. Now curl localhost:3129 to get tg:// links or do docker logs mtg. Also, port 3129 will show you some statistics if you are interested in.

Also, you can use run-mtg.sh script