mirror of
https://github.com/anten-ka/gotelegram_pro.git
synced 2026-05-19 10:26:05 +00:00
81 lines
4.0 KiB
Markdown
81 lines
4.0 KiB
Markdown
# 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:
|
||
|
||
```bash
|
||
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-Админка
|
||
|
||
Админка слушает только локально на сервере:
|
||
|
||
```text
|
||
127.0.0.1:1984
|
||
```
|
||
|
||
Открой через SSH-туннель:
|
||
|
||
```bash
|
||
ssh -L 1984:127.0.0.1:1984 root@SERVER_IP
|
||
```
|
||
|
||
Потом в браузере:
|
||
|
||
```text
|
||
http://127.0.0.1:1984/
|
||
```
|
||
|
||
Внутри есть dashboard, сервисы, проверка сайта, кто слушает `443`, графики трафика, ключи пользователей, QR, IP-лимиты, бэкапы, логи, переключение языка и светлая/тёмная тема.
|
||
|
||
## Ветки
|
||
|
||
- `main` — продакшен и ветка установки по умолчанию.
|
||
- `beta` — публичная бета для следующих сборок и пользовательского тестирования.
|
||
- `alpha` — ранние личные сборки владельца.
|
||
|
||
Новые изменения сначала идут в `alpha`, потом после проверки в `beta`, и только затем в `main`.
|
||
|
||
## Документация
|
||
|
||
- [DOCS_HUMAN.md](DOCS_HUMAN.md) — человеческое руководство с нуля.
|
||
- [DOCS_AI.md](DOCS_AI.md) — подробная техническая карта для ИИ-агентов и разработчиков.
|
||
- [gotelegram-bot/README.md](gotelegram-bot/README.md) — заметки по Telegram-боту.
|
||
|
||
## Проверки Перед Пушем
|
||
|
||
Перед пушем:
|
||
|
||
```bash
|
||
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
|
||
```
|