🛰️ MTProto UI

Веб-консоль для развёртывания и мониторинга MTProto-прокси Telegram на удалённых VPS

Добавь сервер по SSH — система сама поставит Docker, поднимет прокси и выдаст готовую ссылку tg://proxy?….

🔒 Безопасность: SSH-credentials шифруются AES-256-GCM · TOFU-проверка host-key (защита от MITM) · JWT в httpOnly-cookie · обязательная смена слабого пароля · HTTPS через Caddy + Let's Encrypt.

Список серверов	Детали сервера
Добавление сервера	Вход

SNI-домен случайно выбирается из russia-mobile-internet-whitelist.

flowchart TD
    U([👤 Пользователь]) -->|HTTPS| C[Caddy + React UI]
    C -->|/api/*| A[Go API · SQLite · JWT]
    A -->|SSH деплой| V1[VPS · mtg]
    A -->|SSH деплой| V2[VPS · tg-ws-proxy]
    A -. ping / TCP .-> V1
    A -. ping / TCP .-> V2

Требования: Docker и Docker Compose. Для production с HTTPS — домен с A-записью и открытые порты 80/443.

git clone https://github.com/dato-dev/mtprotoui.git
cd mtprotoui
cp .env.example .env

Заполни ключевые переменные в .env:

ENCRYPTION_KEY=<openssl rand -base64 32>
JWT_SECRET=<любая длинная случайная строка>
ADMIN_USER=admin
ADMIN_PASSWORD=<временный пароль>

# Production
DOMAIN=mtproto.example.com
ACME_EMAIL=admin@example.com

# Локально (без TLS): DOMAIN=localhost и HTTP_PORT=8080

Запусти:

docker compose up --build -d

Открой WebUI — https://<DOMAIN> (или http://localhost:8080 локально). При первом входе система попросит сменить пароль на надёжный (мин. 12 символов: верхний/нижний регистр, цифра, спецсимвол).

1. «Добавить сервер» → IP, SSH-доступ, тип прокси, порт, теги
2. (опционально) «Проверить SSH»
3. Подтвердить — пойдёт фоновый деплой с прогрессом

Требования к VPS: Linux с SSH (root или пользователь в группе docker), открытый порт прокси, исходящий интернет (Docker Hub, get.docker.com).

Образы публикуются в Docker Hub (dato1/mtprotouiapi, dato1/mtprotouicaddy). Сборка/пуш с машины разработки:

docker login
docker compose -f docker-compose-prod.yml build
docker compose -f docker-compose-prod.yml push

На сервере (рядом нужны только docker-compose-prod.yml и .env):

docker compose -f docker-compose-prod.yml pull
docker compose -f docker-compose-prod.yml up -d

Образы фиксированы на linux/amd64, так что сборка с Apple Silicon корректно запустится на amd64-VPS.

• SSH-credentials шифруются AES-256-GCM (ENCRYPTION_KEY)
• TOFU-проверка SSH host-key: ключ пиннится при первом подключении, при подмене соединение отклоняется
• JWT хранится в httpOnly-cookie
• Обязательная смена слабого начального пароля
• Аудит-лог действий с серверами
• WebUI рекомендуется держать за HTTPS (Caddy + Let's Encrypt)
• Не коммитьте .env — он в .gitignore

# Frontend (Vite проксирует /api → :8080)
cd frontend && npm install && npm run dev

# Backend
cd backend && go run ./cmd/api      # переменные из .env

# Сборка всего стека
docker compose up --build -d

mtprotoui/
├── backend/                # Go API
│   ├── cmd/api/
│   └── internal/{api,auth,crypto,deploy,health,operation,sshclient,store,whitelist}
│       └── deploy/scripts/ # deploy-mtproto.sh, deploy-tgws.sh
├── frontend/               # React + TypeScript (Vite)
├── caddy/                  # Caddy + сборка UI
├── docs/img/               # скриншоты для README
├── docker-compose.yml      # dev (локальная сборка)
├── docker-compose-prod.yml # prod (образы из registry)
└── ROADMAP.md

Реализовано: типы прокси, ротация SNI, редактирование, теги, поиск/фильтр/сортировка, массовые операции, метрики, QR, логи, аудит, TOFU host-key, сброс пароля, ретраи деплоя.

В планах: стриминг логов в реальном времени, метрики уровня прокси (ss/stats-endpoint), уведомления при падении, история uptime, многопользовательский режим, тесты бэкенда.

📋 Полный список и прогресс — в ROADMAP.md.

MIT © 2026 Timur Abdullin