Владимир: /* Минимальный конфиг (рекомендуется для начала) */

2026-03-26T16:37:16Z

Минимальный конфиг (рекомендуется для начала)

← Предыдущая версия		Версия от 16:37, 26 марта 2026
Строка 136:		Строка 136:
	cat > /etc/mtg.toml << 'EOF'		cat > /etc/mtg.toml << 'EOF'
	# Ваш секрет (замените на свой!)		# Ваш секрет (замените на свой!)
	secret = "~~ee1234567890abcdef1234567890abcdef676f6f676c652e636f6d~~"		secret = "xxxxxxxx"

	# Адрес и порт для прослушивания		# Адрес и порт для прослушивания

Владимир: /* 📡 Установка MTProto Proxy (mtg) на Linux-сервере */

2026-03-26T16:35:31Z

📡 Установка MTProto Proxy (mtg) на Linux-сервере

← Предыдущая версия		Версия от 16:35, 26 марта 2026
Строка 3:		Строка 3:
	Полная пошаговая инструкция для новичков. Проверено на '''Ubuntu/Debian''' с <code>mtg v2.2.4</code>.		Полная пошаговая инструкция для новичков. Проверено на '''Ubuntu/Debian''' с <code>mtg v2.2.4</code>.
	----		----
	~~----~~

	== Что это и зачем ==		== Что это и зачем ==
	'''mtg''' — это легковесный MTProto-прокси для Telegram. Его задача — дать пользователям доступ к Telegram, встраивая прокси прямо в настройки приложения (без необходимости запускать VPN).		'''mtg''' — это легковесный MTProto-прокси для Telegram. Его задача — дать пользователям доступ к Telegram, встраивая прокси прямо в настройки приложения (без необходимости запускать VPN).

Владимир: Новая страница: « = 📡 Установка MTProto Proxy (mtg) на Linux-сервере = Полная пошаговая инструкция для новичков. Проверено на '''Ubuntu/Debian''' с `mtg v2.2.4`. ---- ---- == Что это и зачем == '''mtg''' — это легковесный MTProto-прокси для Telegram. Его задача — дать пользователям доступ к Telegram, встраивая пр...»

2026-03-26T16:33:29Z

Новая страница: « = 📡 Установка MTProto Proxy (mtg) на Linux-сервере = Полная пошаговая инструкция для новичков. Проверено на '''Ubuntu/Debian''' с <code>mtg v2.2.4</code>. ---- ---- == Что это и зачем == '''mtg''' — это легковесный MTProto-прокси для Telegram. Его задача — дать пользователям доступ к Telegram, встраивая пр...»

Новая страница

= 📡 Установка MTProto Proxy (mtg) на Linux-сервере =
Полная пошаговая инструкция для новичков. Проверено на '''Ubuntu/Debian''' с <code>mtg v2.2.4</code>.
----
----

== Что это и зачем ==
'''mtg''' — это легковесный MTProto-прокси для Telegram. Его задача — дать пользователям доступ к Telegram, встраивая прокси прямо в настройки приложения (без необходимости запускать VPN).

=== Как это работает ===
<pre>
┌──────────────┐ MTProto FakeTLS ┌──────────────┐ ┌──────────────┐
│ Telegram │ ──────────────────────────► │ Ваш │ ──────► │ Telegram │
│ клиент │ маскируется под обычный │ сервер │ │ серверы │
│ │ HTTPS-трафик к google.com │ (mtg) │ │ │
└──────────────┘ └──────────────┘ └──────────────┘
</pre>'''FakeTLS''' — технология маскировки. Для стороннего наблюдателя трафик выглядит как обычное HTTPS-соединение к <code>google.com</code> (или другому указанному домену). На самом деле внутри передаётся зашифрованный трафик Telegram.
----

== Требования ==
{| class="wikitable"
!Требование
!Описание
|-
|'''Сервер'''
|VPS/VDS с Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)
|-
|'''Доступ'''
|SSH-доступ с правами <code>root</code>
|-
|'''Порт'''
|Свободный порт (рекомендуется <code>443</code> или <code>8443</code>)
|-
|'''Доступ к Telegram'''
|Сервер должен иметь '''прямой''' доступ к серверам Telegram (т.е. сервер '''не''' в стране с блокировкой)
|-
|'''Архитектура'''
|<code>amd64</code> (x86_64) — стандарт для большинства VPS
|}
<div style="padding: 10px 15px; margin: 10px 0; background-color: #fff3cd; border-left: 4px solid #ffc107; border-radius: 4px;">
⚠️ '''Внимание:''' MTProto-прокси нужно размещать на сервере, с которого Telegram доступен '''напрямую''' (например, сервер в Европе, США и т.д.). Поднимать его на сервере внутри РФ '''бессмысленно''' — Telegram всё равно будет недоступен.
</div>
----

== Установка mtg ==

=== Шаг 1: Подключитесь к серверу по SSH ===
<syntaxhighlight lang="bash">
ssh root@ВАШ_IP_СЕРВЕРА
</syntaxhighlight>

=== Шаг 2: Скачайте последнюю версию mtg ===
<syntaxhighlight lang="bash">
# Скачиваем архив с GitHub
curl -sL https://github.com/9seconds/mtg/releases/download/v2.2.4/mtg-2.2.4-linux-amd64.tar.gz -o /tmp/mtg.tar.gz
</syntaxhighlight><div style="padding: 10px 15px; margin: 10px 0; background-color: #d1ecf1; border-left: 4px solid #17a2b8; border-radius: 4px;">
💡 '''Совет:''' Актуальную версию всегда можно проверить на странице релизов: https://github.com/9seconds/mtg/releases

Если у вас ARM-сервер (например, Oracle Cloud Free Tier), скачивайте файл <code>mtg-X.X.X-linux-arm64.tar.gz</code>
</div>

=== Шаг 3: Распакуйте архив ===
<syntaxhighlight lang="bash">
# Распаковываем
tar -xzf /tmp/mtg.tar.gz -C /tmp/
</syntaxhighlight>

=== Шаг 4: Установите бинарник ===
<syntaxhighlight lang="bash">
# Перемещаем бинарник в системную директорию
mv /tmp/mtg-2.2.4-linux-amd64/mtg /usr/local/bin/mtg

# Даём права на исполнение
chmod +x /usr/local/bin/mtg
</syntaxhighlight>

=== Шаг 5: Проверьте установку ===
<syntaxhighlight lang="bash">
mtg --version
</syntaxhighlight>'''Ожидаемый результат:'''<pre>
2.2.4 (go1.26.1: 2026-03-24T08:59:03Z ...)
</pre>✅ Если видите версию — mtg установлен успешно!

=== Шаг 6: Очистите временные файлы ===
<syntaxhighlight lang="bash">
rm -rf /tmp/mtg.tar.gz /tmp/mtg-2.2.4-linux-amd64/
</syntaxhighlight>
----

== Генерация секрета ==
Секрет — это уникальный ключ, который нужен для подключения клиентов к вашему прокси. Он же определяет домен для маскировки (FakeTLS).

=== Генерация в hex-формате ===
<syntaxhighlight lang="bash">
mtg generate-secret --hex google.com
</syntaxhighlight>'''Пример вывода:'''<pre>
ee1234567890abcdef1234567890abcdef676f6f676c652e636f6d
</pre>

=== Генерация в base64-формате ===
<syntaxhighlight lang="bash">
mtg generate-secret google.com
</syntaxhighlight><div style="padding: 10px 15px; margin: 10px 0; background-color: #fff3cd; border-left: 4px solid #ffc107; border-radius: 4px;">
⚠️ '''Внимание:''' '''Сохраните секрет!''' Он понадобится для конфигурации сервера и для подключения клиентов Telegram. Если потеряете — можно сгенерировать новый, но придётся обновить настройки у всех клиентов.
</div>

=== Какой домен выбрать для маскировки? ===
Домен после команды — это сайт, под который маскируется трафик. Правила выбора:
{| class="wikitable"
!✅ Хороший выбор
!❌ Плохой выбор
!Почему
|-
|<code>google.com</code>
|<code>ya.ru</code>
|Российский домен не должен "жить" на европейском IP
|-
|<code>www.microsoft.com</code>
|<code>vk.com</code>
|Аналогично — геолокационное несоответствие
|-
|<code>cloudflare.com</code>
|<code>localhost</code>
|Несуществующий/локальный домен подозрителен
|-
|<code>www.amazon.com</code>
|<code>telegram.org</code>
|Очевидно связан с Telegram
|}
'''Правило:''' выбирайте '''крупный международный сайт''', который территориально соответствует расположению вашего сервера.
----

== Создание конфигурации ==
mtg v2 использует конфигурационный файл в формате '''TOML'''.

=== Минимальный конфиг (рекомендуется для начала) ===
<syntaxhighlight lang="bash">
cat > /etc/mtg.toml << 'EOF'
# Ваш секрет (замените на свой!)
secret = "ee1234567890abcdef1234567890abcdef676f6f676c652e636f6d"

# Адрес и порт для прослушивания
# 0.0.0.0 означает "все сетевые интерфейсы"
bind-to = "0.0.0.0:8443"

# Защита от replay-атак (рекомендуется оставить включённой)
[defense.anti-replay]
enabled = true
max-size = "1mib"
error-rate = 0.001
EOF
</syntaxhighlight><div style="padding: 10px 15px; margin: 10px 0; background-color: #fff3cd; border-left: 4px solid #ffc107; border-radius: 4px;">
⚠️ '''Внимание:''' Не забудьте заменить значение <code>secret</code> на ваш настоящий секрет, сгенерированный на предыдущем шаге!
</div>

=== Выбор порта ===
{| class="wikitable"
!Порт
!Плюсы
!Минусы
|-
|<code>443</code>
|Максимальная маскировка (стандартный HTTPS-порт)
|Может быть занят другим сервисом (nginx, 3X-UI и т.д.)
|-
|<code>8443</code>
|Альтернативный HTTPS-порт, редко занят
|Чуть менее «стандартный», но вполне нормальный
|-
|<code>3128</code>
|Порт из примера mtg
|Ассоциируется с прокси (Squid), может насторожить DPI
|}
'''Рекомендация:''' если порт <code>443</code> свободен — используйте его. Если занят — используйте <code>8443</code>.

=== Проверка, занят ли порт ===
<syntaxhighlight lang="bash">
ss -tlnp | grep :443
</syntaxhighlight>Если ничего не вывело — порт свободен. Если вывело процесс — порт занят, используйте другой.
----

== Первый запуск и проверка ==

=== Запуск в режиме отладки (для первого раза) ===
Добавьте временно <code>debug = true</code> в начало конфига:<syntaxhighlight lang="bash">
# Открываем конфиг
nano /etc/mtg.toml
</syntaxhighlight>Добавьте первой строкой:<syntaxhighlight lang="toml">
debug = true
</syntaxhighlight>Запустите:<syntaxhighlight lang="bash">
mtg run /etc/mtg.toml
</syntaxhighlight>'''Что вы увидите:'''

* Если всё ОК — mtg начнёт выводить отладочные сообщения и будет ждать подключений
* Если ошибка — mtg покажет описание проблемы и завершится

=== Проверка что порт слушается (в другом терминале) ===
<syntaxhighlight lang="bash">
ss -tlnp | grep 8443
</syntaxhighlight>'''Ожидаемый вывод:'''<pre>
LISTEN 0 4096 0.0.0.0:8443 0.0.0.0:* users:(("mtg",pid=12345,fd=3))
</pre>✅ Если видите строку с <code>mtg</code> — прокси запущен и слушает!

=== Остановка после проверки ===
Нажмите <code>Ctrl+C</code> в терминале, где запущен mtg.<div style="padding: 10px 15px; margin: 10px 0; background-color: #d1ecf1; border-left: 4px solid #17a2b8; border-radius: 4px;">
💡 '''Совет:''' После успешной проверки '''уберите''' строку <code>debug = true</code> из конфига — в рабочем режиме отладка не нужна, она создаёт лишнюю нагрузку.
</div>
----

== Настройка автозапуска (systemd) ==
Чтобы mtg запускался автоматически при загрузке сервера и перезапускался при падении:

=== Шаг 1: Создайте файл сервиса ===
<syntaxhighlight lang="bash">
cat > /etc/systemd/system/mtg.service << 'EOF'
[Unit]
Description=MTProto Proxy (mtg)
Documentation=https://github.com/9seconds/mtg
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/mtg run /etc/mtg.toml
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF
</syntaxhighlight>

=== Шаг 2: Примените и запустите ===
<syntaxhighlight lang="bash">
# Перечитать конфигурацию systemd
systemctl daemon-reload

# Включить автозапуск при загрузке системы
systemctl enable mtg

# Запустить прямо сейчас
systemctl start mtg
</syntaxhighlight>

=== Шаг 3: Проверьте статус ===
<syntaxhighlight lang="bash">
systemctl status mtg
</syntaxhighlight>'''Ожидаемый вывод:'''<pre>
● mtg.service - MTProto Proxy (mtg)
Loaded: loaded (/etc/systemd/system/mtg.service; enabled)
Active: active (running) since ...
</pre>✅ Статус <code>active (running)</code> — всё работает!

=== Полезные команды управления ===
{| class="wikitable"
!Команда
!Описание
|-
|<code>systemctl start mtg</code>
|Запустить
|-
|<code>systemctl stop mtg</code>
|Остановить
|-
|<code>systemctl restart mtg</code>
|Перезапустить
|-
|<code>systemctl status mtg</code>
|Проверить статус
|-
|<code>journalctl -u mtg -f</code>
|Смотреть логи в реальном времени
|-
|<code>journalctl -u mtg --since "1 hour ago"</code>
|Логи за последний час
|}
----

== Настройка файрвола ==
Не забудьте открыть порт, на котором работает mtg!

=== UFW (Ubuntu) ===
<syntaxhighlight lang="bash">
ufw allow 8443/tcp
ufw status
</syntaxhighlight>

=== iptables ===
<syntaxhighlight lang="bash">
iptables -A INPUT -p tcp --dport 8443 -j ACCEPT
# Чтобы сохранить правило после перезагрузки:
apt install iptables-persistent -y
netfilter-persistent save
</syntaxhighlight>

=== firewalld (CentOS/Fedora) ===
<syntaxhighlight lang="bash">
firewall-cmd --permanent --add-port=8443/tcp
firewall-cmd --reload
</syntaxhighlight><div style="padding: 10px 15px; margin: 10px 0; background-color: #fff3cd; border-left: 4px solid #ffc107; border-radius: 4px;">
⚠️ '''Внимание:''' Если у вашего хостинга есть '''внешний файрвол''' (Security Groups, Cloud Firewall), откройте порт и там! Это частая причина, почему прокси «не работает» — порт закрыт на уровне провайдера.
</div>
----

== Подключение клиентов Telegram ==

=== Способ 1: Ссылка для быстрого подключения (рекомендуется) ===
Сформируйте ссылку и отправьте её пользователям:<pre>
tg://proxy?server=IP_СЕРВЕРА&port=8443&secret=ВАШ_СЕКРЕТ
</pre>'''Пример:'''<pre>
tg://proxy?server=185.100.200.50&port=8443&secret=ee1234567890abcdef1234567890abcdef676f6f676c652e636f6d
</pre>Или в формате HTTPS (открывается в браузере):<pre>
https://t.me/proxy?server=185.100.200.50&port=8443&secret=ee1234567890abcdef1234567890abcdef676f6f676c652e636f6d
</pre>Пользователь открывает ссылку → Telegram предлагает подключить прокси → нажимает '''«Подключить»''' → готово! 🎉

=== Способ 2: Ручная настройка ===

==== Android ====
<pre>
Настройки → Данные и память → Тип прокси → Добавить прокси
├── Тип: MTProto
├── Сервер: IP вашего сервера
├── Порт: 8443
└── Секрет: ваш секрет
</pre>

==== iOS ====
<pre>
Настройки → Данные и память → Прокси → Добавить прокси
├── Тип: MTProto
├── Сервер: IP вашего сервера
├── Порт: 8443
└── Секрет: ваш секрет
</pre>

==== Telegram Desktop (ПК) ====
<pre>
Настройки → Продвинутые настройки → Тип подключения
→ Использовать свой прокси → Добавить прокси
├── Тип: MTPROTO
├── Хост: IP вашего сервера
├── Порт: 8443
└── Секрет: ваш секрет
</pre>

=== Проверка подключения ===
После добавления прокси рядом с ним появится индикатор:

* 🟢 '''Доступен''' + '''время пинга''' — работает!
* 🔴 '''Недоступен''' — см. раздел диагностики

----

== Диагностика проблем ==

=== Встроенная диагностика mtg ===
В v2.2.4 есть команда <code>mtg doctor</code>:<syntaxhighlight lang="bash">
mtg doctor /etc/mtg.toml
</syntaxhighlight>Она проверит:

* Корректность конфигурации
* Сетевую доступность серверов Telegram
* Доступность домена фронтинга
* Соответствие SNI и DNS

=== Частые проблемы и решения ===
{| class="wikitable"
!Проблема
!Причина
!Решение
|-
|Telegram показывает 🔴 «Недоступен»
|Порт закрыт файрволом
|Откройте порт: <code>ufw allow 8443/tcp</code>
|-
|<code>bind: address already in use</code>
|Порт занят другим процессом
|grep :8443
|-
|<code>mtg: command not found</code>
|Бинарник не в PATH
|Проверьте: <code>ls -la /usr/local/bin/mtg</code>
|-
|Прокси работал, но перестал
|Процесс упал и не перезапустился
|Настройте systemd (см. раздел выше)
|-
|Работает с сервера, не работает из РФ
|ТСПУ заблокировал IP или протокол
|Смените порт на 443; если не помогает — нужна дополнительная обфускация
|}

=== Проверка из командной строки ===
<syntaxhighlight lang="bash">
# Проверить что процесс запущен
ps aux | grep mtg

# Проверить что порт слушается
ss -tlnp | grep 8443

# Посмотреть логи
journalctl -u mtg --no-pager -n 50
</syntaxhighlight>
----

== Продвинутые настройки ==

=== Полный конфиг с пояснениями ===
<syntaxhighlight lang="toml">
# Режим отладки (true = подробные логи, false = тишина)
# Включайте только при диагностике!
debug = false

# Ваш секрет (FakeTLS)
secret = "ваш_секрет"

# Адрес:порт для прослушивания
bind-to = "0.0.0.0:8443"

# Максимум одновременных подключений
concurrency = 8192

# Предпочтение IPv4/IPv6 для связи с Telegram
# Варианты: "prefer-ipv4", "prefer-ipv6", "only-ipv4", "only-ipv6"
prefer-ip = "prefer-ipv4"

# Допуск расхождения времени (для FakeTLS проверки)
tolerate-time-skewness = "5s"

# DNS-резолвер (DNS-over-HTTPS через Cloudflare)
[network]
dns = "https://1.1.1.1"

# Таймауты
[network.timeout]
tcp = "5s"
http = "10s"
idle = "1m"

# Защита от replay-атак
[defense.anti-replay]
enabled = true
max-size = "1mib"
error-rate = 0.001

# Блокировка подозрительных IP (ботнеты, сканеры)
[defense.blocklist]
enabled = true
download-concurrency = 2
urls = [
"https://iplists.firehol.org/files/firehol_level1.netset",
]
update-each = "24h"
</syntaxhighlight>

=== Запуск через Docker (альтернативный способ) ===
Если предпочитаете Docker:<syntaxhighlight lang="bash">
docker run -d \
--name mtg \
--restart always \
-p 8443:3128 \
nineseconds/mtg:2 \
run /config.toml
</syntaxhighlight>
----

== 📝 Краткая шпаргалка (всё в одном) ==
<syntaxhighlight lang="bash">
# 1. Скачать и установить
curl -sL https://github.com/9seconds/mtg/releases/download/v2.2.4/mtg-2.2.4-linux-amd64.tar.gz -o /tmp/mtg.tar.gz
tar -xzf /tmp/mtg.tar.gz -C /tmp/
mv /tmp/mtg-2.2.4-linux-amd64/mtg /usr/local/bin/mtg
chmod +x /usr/local/bin/mtg

# 2. Сгенерировать секрет
mtg generate-secret --hex google.com
# Сохраните вывод!

# 3. Создать конфиг (замените SECRET на ваш секрет)
cat > /etc/mtg.toml << EOF
secret = "ВАШ_СЕКРЕТ"
bind-to = "0.0.0.0:8443"

[defense.anti-replay]
enabled = true
max-size = "1mib"
error-rate = 0.001
EOF

# 4. Создать systemd-сервис
cat > /etc/systemd/system/mtg.service << 'EOF'
[Unit]
Description=MTProto Proxy (mtg)
After=network.target
[Service]
ExecStart=/usr/local/bin/mtg run /etc/mtg.toml
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF

# 5. Запустить
systemctl daemon-reload
systemctl enable --now mtg

# 6. Открыть порт
ufw allow 8443/tcp

# 7. Проверить
systemctl status mtg

# 8. Ссылка для клиентов:
# tg://proxy?server=IP_СЕРВЕРА&port=8443&secret=ВАШ_СЕКРЕТ
</syntaxhighlight>
----<div style="padding: 10px 15px; margin: 10px 0; background-color: #d4edda; border-left: 4px solid #28a745; border-radius: 4px;">
ℹ️ '''Проект:''' https://github.com/9seconds/mtg

'''Версия:''' v2.2.4 (март 2026)

'''Лицензия:''' MIT
</div>

Установка MTProto Proxy (mtg) на Linux-сервере - История изменений

Владимир в 09:45, 1 апреля 2026

Владимир: /* Минимальный конфиг (рекомендуется для начала) */

Владимир: /* 📡 Установка MTProto Proxy (mtg) на Linux-сервере */