X-UI Telegram Admin

Управление всей инфраструктурой 3x-ui прямо из Telegram

Серверы, пользователи, ссылки и QR-коды, диагностика и безопасные обновления — в одном Mini App.

English · Установка · Использование · Конфигурация · Релизы · Поддержать

Что это за проект

X-UI Telegram Admin превращает Telegram в защищённый центр управления несколькими серверами 3x-ui. Публичные панели подключаются напрямую, закрытые — через автоматически создаваемый SSH-туннель. Количество серверов не зашито в код и управляется из самого Mini App.

Серверы и система	Пользователи и подключения
Добавление, изменение и удаление серверов	Просмотр inbounds, клиентов, трафика и online-статуса
Раздельная проверка SSH, панели, API и Xray	Создание, блокировка, сброс трафика и удаление клиентов
Обновление Linux для apt-get, dnf, yum, zypper, apk и pacman	Точные ссылки и QR-коды, сформированные самой 3x-ui
Безопасное обновление 3x-ui с резервной копией и журналом	Несколько конфигураций подключения одного клиента

Дополнительно доступны сравнение версии 3x-ui с последним стабильным релизом, краткая выжимка изменений, фоновые задания, аудит действий и команды /status, /logs, /updates в Telegram.

Интерфейс

Состояние сервера и раздельная диагностика	Компактное управление клиентами

Показать остальные экраны

Все изображения созданы на локальном стенде с вымышленными серверами, пользователями, UUID и ссылками подключения.

Быстрый старт

Понадобятся Linux-сервер с Docker Engine и Compose v2, домен с открытыми TCP 80/443, Telegram-бот и SSH-доступ к управляемым серверам.

Интерактивный установщик запросит параметры Telegram и серверов, создаст конфигурацию и SSH-ключи, проверит подключение и запустит приложение:

git clone https://github.com/Sampsih/3xui-telegram-bot.git
cd 3xui-telegram-bot
make install

Пошаговая подготовка Telegram, DNS, SSH-пользователей и закрытых панелей описана в руководстве по установке. Обновляйте приложение по инструкции из последнего релиза: локальные настройки, ключи, инвентарь и данные сохраняются автоматически.

Как это работает

flowchart LR
    TG["Telegram"] --> BOT["Bot"]
    TG --> APP["Mini App"]
    APP --> API["HTTPS / FastAPI"]
    BOT --> CORE["Inventory + jobs"]
    API --> CORE
    CORE --> SSH["SSH"]
    CORE --> PANEL["3x-ui API"]
    SSH --> HOSTS["Server 1 … N"]
    PANEL --> HOSTS

Loading

Backend хранит управляемый инвентарь в зашифрованном виде, проверяет host key и доступность SSH и панели до сохранения сервера. Изменения сразу становятся доступны Mini App и боту без перезапуска контейнеров. Для закрытой панели встроенный TunnelManager поднимает SSH port forward автоматически.

Основная цель совместимости — актуальная MHSanaei/3x-ui. Для старых панелей без clients/subLinks предусмотрен ограниченный fallback генерации ссылок; нестандартным forks может потребоваться отдельный API adapter.

Безопасность

• Telegram initData проверяется на backend, доступ ограничен allowlist пользователей;
• SSH host keys сверяются через known_hosts;
• обновления запускаются только через фиксированные root-owned wrappers;
• raw SSH выключен по умолчанию и запрещён для пользователя root;
• контейнеры работают с read-only filesystem, без Linux capabilities и с no-new-privileges.

Секреты, приватные ключи, аудит и базы исключены из Git. Перед публикацией собственного fork ознакомьтесь с политикой безопасности.

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

Руководство	Содержание
Установка	Развёртывание, Telegram, DNS, SSH и 3x-ui
Использование	Mini App, команды бота, пользователи и обновления
Конфигурация	Все переменные и параметры серверов
Архитектура	Компоненты, инвентарь, сеть и масштабирование
Решение проблем	Диагностика типовых ошибок
Разработка	Локальный запуск, тесты и проверки
Участие в проекте	Правила подготовки изменений
История изменений	Что добавлено в каждом релизе

Поддержать проект

Если проект оказался полезен, его развитие можно поддержать удобным способом:

TON (Gram)

UQBDpkQH_ryzYKm5iiBQLuFz32SJllk4WI3drZfjQCYFHKX4

Открыть перевод в TON-кошельке · Проверить адрес в TON Viewer

Перед подтверждением перевода обязательно сверьте адрес в кошельке.

Лицензия

GNU General Public License v3.0 — проект можно использовать, изучать, изменять и распространять, в том числе коммерчески, при соблюдении условий GPLv3.