goTelegram Pro

goTelegram Pro — установщик и панель управления Telegram MTProxy на базе ядра telemt. Проект ставит на VPS прокси, сайт-маскировку, Telegram-бота, локальную web-админку, сбор статистики и бэкапы.

Главная идея: снаружи сервер выглядит как обычный HTTPS-сайт, а Telegram-клиенты используют тот же домен/порт для MTProxy. Управлять можно из SSH-меню, Telegram-бота или локальной web-панели через SSH-туннель.

Что Входит

ядро telemt с fake-TLS маскировкой;
CLI-меню gotelegram;
Lite-режим без домена и Pro-режим с доменом/сайтом/Let's Encrypt;
Telegram-бот для статуса, ссылок, QR, бэкапов, шаблонов, ключей и статистики;
локальная web-админка на 127.0.0.1:1984;
глобальная и per-key история трафика;
ручные и scheduled бэкапы;
shared-443 схема для совместной работы с 3x-ui/Xray.

Установка

Запускать под root на Ubuntu/Debian:

export GOTELEGRAM_PAT="YOUR_READ_ONLY_GITHUB_TOKEN"; bash <(curl -sL -H "Authorization: token $GOTELEGRAM_PAT" https://raw.githubusercontent.com/anten-ka/gotelegram_pro/main/bootstrap.sh)

bootstrap.sh скачает файлы в /opt/gotelegram, создаст /usr/local/bin/gotelegram и откроет главное меню.

Режимы

Lite работает сразу без домена. Клиент подключается к IP:443, а прокси имитирует TLS под популярный домен вроде google.com.

Pro требует домен, который указывает на VPS. Telegram-клиенты и обычные браузеры используют один публичный домен на 443: Telegram-трафик идёт в telemt, браузер открывает сайт-маскировку через nginx.

Web-Админка

Админка слушает только локально на сервере:

127.0.0.1:1984

Открой через SSH-туннель:

ssh -L 1984:127.0.0.1:1984 root@SERVER_IP

Потом в браузере:

http://127.0.0.1:1984/

Внутри есть dashboard, сервисы, проверка сайта, кто слушает 443, графики трафика, ключи пользователей, QR, IP-лимиты, бэкапы, логи, переключение языка и светлая/тёмная тема.

Ветки

main — продакшен и ветка установки по умолчанию.
beta — публичная бета для следующих сборок и пользовательского тестирования.
alpha — ранние личные сборки владельца.

Новые изменения сначала идут в alpha, потом после проверки в beta, и только затем в main.

Документация

DOCS_HUMAN.md — человеческое руководство с нуля.
DOCS_AI.md — подробная техническая карта для ИИ-агентов и разработчиков.
gotelegram-bot/README.md — заметки по Telegram-боту.

Проверки Перед Пушем

Перед пушем:

bash -n bootstrap.sh install.sh lib/*.sh
python3 -m unittest tests.test_admin_features tests.test_bot_features
PYTHONPYCACHEPREFIX=/tmp/gotelegram-pycache python3 -m py_compile gotelegram-bot/bot.py admin-web/server.py
node --check admin-web/static/app.js
git diff --check

4.0 KiB Raw Blame History Unescape Escape