MTProxy - GitLite

KO | EN

gitlite — search

#typescript #llm #go #rust #linux #nodejs #java #windows #awesome #cli #vue #mcp #ios #open-source

MTProxy

(★ 6,898)

No description available.

File Explorer

Download Latest Version (.zip)

- common-stats.c
- common-stats.h
- cpuid.c
- cpuid.h
- crc32.c
- crc32.h
- crc32c.c
- crc32c.h
- kprintf.c
- kprintf.h
- md5.c
- md5.h
- mp-queue.c
- mp-queue.h
- parse-config.c
- parse-config.h
- pid.c
- pid.h
- precise-time.c
- precise-time.h
- proc-stat.c
- proc-stat.h
- resolver.c
- resolver.h
- rpc-const.h
- server-functions.c
- server-functions.h
- sha1.c
- sha1.h
- sha256.c
- sha256.h
- tl-parse.c
- tl-parse.h
- aesni256.c
- aesni256.h
- engine-net.c
- engine-net.h
- engine-rpc-common.c
- engine-rpc-common.h
- engine-rpc.c
- engine-rpc.h
- engine-signals.c
- engine-signals.h
- engine.c
- engine.h
- jobs.c
- jobs.h
- mtproto-common.h
- mtproto-config.c
- mtproto-config.h
- mtproto-proxy.c
- net-config.c
- net-config.h
- net-connections.c
- net-connections.h
- net-crypto-aes.c
- net-crypto-aes.h
- net-crypto-dh.c
- net-crypto-dh.h
- net-events.c
- net-events.h
- net-http-server.c
- net-http-server.h
- net-msg-buffers.c
- net-msg-buffers.h
- net-msg.c
- net-msg.h
- net-rpc-targets.c
- net-rpc-targets.h
- net-stats.c
- net-tcp-connections.c
- net-tcp-connections.h
- net-tcp-rpc-client.c
- net-tcp-rpc-client.h
- net-tcp-rpc-common.c
- net-tcp-rpc-common.h
- net-tcp-rpc-ext-server.c
- net-tcp-rpc-ext-server.h
- net-tcp-rpc-server.c
- net-tcp-rpc-server.h
- net-thread.c
- net-thread.h
- net-timers.c
- net-timers.h
- vv-io.h
- vv-tree.c
- vv-tree.h
.gitignore
GPLv2
LGPLv2
Makefile
README.md

# Installation Guide

1. Get the code

git clone https://github.com/TelegramMessenger/MTProxy

Downloads the entire project code from GitHub to your computer.

cd MTProxy

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

APT (Debian/Ubuntu 계열) Built into Debian/Ubuntu-based Linux distributions.

apt install git curl build-essential libssl-dev zlib1g-dev

Installs directly from the APT package repository (Debian/Ubuntu-based).

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Make

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).

make && cd objs/bin

Compiles the code based on the generated build configuration to produce an executable.

✅ If it finishes without errors, it worked. Try running the generated executable directly.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MTProxy
Simple MT-Proto proxy

## Building
Install dependencies, you would need common set of tools for building from source, and development packages for `openssl` and `zlib`.

On Debian/Ubuntu:
```bash
apt install git curl build-essential libssl-dev zlib1g-dev
```
On CentOS/RHEL:
```bash
yum install openssl-devel zlib-devel
yum groupinstall "Development Tools"
```

Clone the repo:
```bash
git clone https://github.com/TelegramMessenger/MTProxy
cd MTProxy
```

To build, simply run `make`, the binary will be in `objs/bin/mtproto-proxy`:

```bash
make && cd objs/bin
```

If the build has failed, you should run `make clean` before building it again.

## Running
1. Obtain a secret, used to connect to telegram servers.
```bash
curl -s https://core.telegram.org/getProxySecret -o proxy-secret
```
2. Obtain current telegram configuration. It can change (occasionally), so we encourage you to update it once per day.
```bash
curl -s https://core.telegram.org/getProxyConfig -o proxy-multi.conf
```
3. Generate a secret to be used by users to connect to your proxy.
```bash
head -c 16 /dev/urandom | xxd -ps
```
4. Run `mtproto-proxy`:
```bash
./mtproto-proxy -u nobody -p 8888 -H 443 -S <secret> --aes-pwd proxy-secret proxy-multi.conf -M 1
```
... where:
- `nobody` is the username. `mtproto-proxy` calls `setuid()` to drop privileges.
- `443` is the port, used by clients to connect to the proxy.
- `8888` is the local port. You can use it to get statistics from `mtproto-proxy`. Like `wget localhost:8888/stats`. You can only get this stat via loopback.
- `<secret>` is the secret generated at step 3. Also you can set multiple secrets: `-S <secret1> -S <secret2>`.
- `proxy-secret` and `proxy-multi.conf` are obtained at steps 1 and 2.
- `1` is the number of workers. You can increase the number of workers, if you have a powerful server.

Also feel free to check out other options using `mtproto-proxy --help`.

5. Generate the link with following schema: `tg://proxy?server=SERVER_NAME&port=PORT&secret=SECRET` (or let the official bot generate it for you).
6. Register your proxy with [@MTProxybot](https://t.me/MTProxybot) on Telegram.
7. Set received tag with arguments: `-P <proxy tag>`
8. Enjoy.

## Random padding
Due to some ISPs detecting MTProxy by packet sizes, random padding is
added to packets if such mode is enabled.

It's only enabled for clients which request it.

Add `dd` prefix to secret (`cafe...babe` => `ddcafe...babe`) to enable
this mode on client side.

## Systemd example configuration
1. Create systemd service file (it's standard path for the most Linux distros, but you should check it before):
```bash
nano /etc/systemd/system/MTProxy.service
```
2. Edit this basic service (especially paths and params):
```bash
[Unit]
Description=MTProxy
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/MTProxy
ExecStart=/opt/MTProxy/mtproto-proxy -u nobody -p 8888 -H 443 -S <secret> -P <proxy tag> <other params>
Restart=on-failure

[Install]
WantedBy=multi-user.target
```
3. Reload daemons:
```bash
systemctl daemon-reload
```
4. Test fresh MTProxy service:
```bash
systemctl restart MTProxy.service
# Check status, it should be active
systemctl status MTProxy.service
```
5. Enable it, to autostart service after reboot:
```bash
systemctl enable MTProxy.service
```

## Docker image
Telegram is also providing [official Docker image](https://hub.docker.com/r/telegrammessenger/proxy/).
Note: the image is outdated.