v1.3.1 — Compact mobile user list

Patch release focused on the Telegram Mini App user list.

• Client rows use a compact two-line mobile layout.
• Traffic and all four actions fit on the same line at regular phone widths.
• Extra-small screens switch to a safe three-line layout without horizontal overflow.
• Unlimited expiry now reads «Без срока» instead of «до Без срока».
• Russian and English documentation and the mobile screenshot were updated.

Server update:

cd /opt/xui-telegram-admin
sudo ./scripts/update.sh 1.3.1

v1.3.0 — Reliable 3x-ui updates and client controls

Русский

• Исправлено зависание обновления 3x-ui: бот больше не запускает интерактивное меню x-ui update.
• Официальный updater загружается из точного стабильного тега, выполняется без вопросов про TLS и проверяет итоговую версию и состояние сервиса.
• Добавлены включение/отключение клиента и сброс его трафика.
• На экране версии показываются официальные предупреждения релиза и ссылка на changelog.
• Проверена совместимость с 3x-ui 3.6.0 и xray-core 26.7.28.

Важно: после обновления приложения с 1.2.x один раз повторно установите managed-host scripts на каждом сервере по разделу 9 инструкции. Это заменит старый root-owned xui-safe-update.

English

• Fixed hanging 3x-ui updates: the bot no longer invokes the interactive x-ui update menu.
• The official updater is downloaded from the exact stable tag, runs without TLS prompts, and verifies the final version and service state.
• Added client enable/disable and per-client traffic reset controls.
• The version screen now shows official release advisories and a changelog link.
• Reviewed compatibility with 3x-ui 3.6.0 and xray-core 26.7.28.

Important: after upgrading the application from 1.2.x, reprovision the managed-host scripts on every server once by following section 9 of the installation guide. This replaces the old root-owned xui-safe-update.

v1.2.1 — Documentation and screenshot refresh

Русский

• Полностью обновлена техническая документация по managed inventory, мастеру серверов, встроенным SSH-туннелям, резервному копированию и диагностике.
• Пересняты все экраны Mini App и добавлен снимок мастера сервера.
• Добавлен безопасный локальный стенд с вымышленными данными для воспроизводимых скриншотов.
• Удалена устаревшая генерация tunnel Compose overlay из интерактивного установщика; старые overlays остаются совместимыми.

English

• Refreshed the complete technical documentation for managed inventory, server onboarding, built-in SSH tunnels, backups, and diagnostics.
• Replaced all Mini App screenshots and added the server wizard.
• Added a safe local fictional-data fixture server for reproducible screenshots.
• Removed obsolete tunnel Compose generation from the interactive installer while preserving legacy overlay compatibility.

Upgrade: sudo ./scripts/update.sh 1.2.1

v1.2.0 — Managed server onboarding

Русский

Встроенный мастер серверов

• Добавление, проверка, изменение и удаление серверов прямо в Mini App.
• Генерация Ed25519-ключей без передачи приватного ключа через API.
• Обязательное подтверждение SHA-256 fingerprint SSH-сервера.
• Проверка SSH и API 3x-ui до сохранения.

Динамическая конфигурация

• Статический config/servers.json остаётся совместимым bootstrap-источником.
• Первое изменение из Mini App переносит текущий список в зашифрованный data/managed-servers.enc.
• Ключ хранится отдельно в data/inventory.key; изменения сразу видят API и Telegram-бот.
• Встроенные SSH-туннели больше не требуют новых Compose-сервисов или Docker socket.

Обновление

cd /opt/xui-telegram-admin
sudo ./scripts/update.sh 1.2.0

Updater сохраняет старый tunnel, встроенный в пользовательский docker-compose.yml. После обновления его можно безопасно перевести на новый встроенный SSH-туннель через настройки сервера.

English

Built-in server wizard

• Create, verify, edit, and delete servers directly in the Mini App.
• Generate Ed25519 keys without returning private key material through the API.
• Explicitly confirm the SSH server SHA-256 fingerprint.
• Verify SSH and the 3x-ui API before saving.

Dynamic configuration

• Static config/servers.json remains a compatible bootstrap source.
• The first Mini App change migrates the current list to encrypted data/managed-servers.enc.
• The separate key is stored in data/inventory.key; API and Telegram bot see changes immediately.
• Built-in SSH tunnels require neither new Compose services nor the Docker socket.

Upgrade

cd /opt/xui-telegram-admin
sudo ./scripts/update.sh 1.2.0

The updater preserves a legacy tunnel embedded in a customized docker-compose.yml. After upgrading, it can be migrated safely to the new built-in SSH tunnel through the server settings.

v1.1.2 — Resilient health diagnostics

Русский

• Раздельная диагностика SSH, канала до панели, API 3x-ui и Xray.
• Работающая панель больше не считается выключенной только из-за недоступного SSH.
• Понятные сообщения для DNS, сети, timeout и ошибок авторизации панели.
• Безопасное обновление приложения через sudo ./scripts/update.sh 1.1.2 с проверкой checksum и сохранением локальных настроек.
• Исправлена релизная упаковка и конфигурация Docker Dependabot.

Перед обновлением существующей установки 1.1.1 прочитайте раздел «Обновление самого приложения» в инструкции. В 1.1.2 и следующих версиях используйте встроенный scripts/update.sh.

English

• Separate health diagnostics for SSH, panel connectivity, the 3x-ui API, and Xray.
• A working panel is no longer marked offline only because SSH management is unavailable.
• Actionable diagnostics for panel DNS, network, timeout, and authentication errors.
• Checksum-verified application updates through sudo ./scripts/update.sh 1.1.2 while preserving local configuration.
• Corrected release packaging and Docker Dependabot configuration.

Before upgrading an existing 1.1.1 installation, read “Updating the application itself” in the installation guide. Use the bundled scripts/update.sh for 1.1.2 and later upgrades.

v1.1.1 — Current 3x-ui client API compatibility

X-UI Telegram Admin v1.1.1

This patch release restores client creation and deletion compatibility with current 3x-ui releases while preserving support for older panels.

Этот patch-релиз восстанавливает создание и удаление пользователей в актуальных версиях 3x-ui, сохраняя совместимость со старыми панелями.

Исправлено / Fixed

• Current 3x-ui client creation through /panel/api/clients/add.
• Automatic fallback to the legacy /panel/api/inbounds/addClient endpoint.
• Current 3x-ui client deletion and per-inbound detach behavior.
• Safe handling of clients attached to multiple inbounds.
• Regression tests for both current API operations.

Обновление / Upgrade

cd /opt/xui-telegram-admin
git pull --ff-only origin main
docker compose up -d --build api bot
docker compose ps
docker compose logs --tail=100 api bot

No configuration changes are required.

Изменения конфигурации не требуются.

v1.1.0 — Multi-distro updates and interactive installer

X-UI Telegram Admin v1.1.0

This release adds multi-distribution server management and a bilingual interactive installer.

Релиз добавляет управление разными дистрибутивами Linux и двуязычный интерактивный установщик.

Highlights

• Package updates for Debian/Ubuntu, Oracle Linux/RHEL/Rocky/Alma, openSUSE/SLES, Alpine, and Arch families.
• Automatic detection of apt-get, dnf, yum, zypper, apk, or pacman.
• Service checks through systemd, OpenRC, or a compatible service command.
• make install wizard for the application domain, Telegram settings, and any number of managed servers.
• Automatic per-server SSH key generation and confirmed known_hosts enrollment.
• Optional remote xuiadmin provisioning and automatic Compose generation for multiple SSH-only panels.
• 18 automated tests, bilingual documentation validation, ShellCheck, Compose validation, and Docker image builds.

New installation

Follow the English installation guide or русскую инструкцию, then run:

make install

Existing installation

After updating the application, copy the new install-managed-host, xui-system-update, xui-safe-update, and xuiadmin.sudoers files to every managed server and rerun install-managed-host with that server's public key. This installs the new distribution-aware wrappers without changing the private SSH key.

Download the archive below and verify it with the attached SHA-256 checksum.

v1.0.0 — First public release

X-UI Telegram Admin v1.0.0

First public release of the Telegram Mini App and bot for securely managing multiple 3x-ui servers.

Первый публичный релиз Telegram Mini App и бота для безопасного управления несколькими серверами 3x-ui.

Highlights

• Multi-server status dashboard with bounded parallel checks.
• Inbound and client management, including exact 3x-ui connection links and QR codes.
• Server package, 3x-ui and Xray update operations through hardened SSH wrappers.
• Support for panels exposed over HTTPS or reachable only through an SSH tunnel.
• Telegram commands for server status, logs and available updates.
• Docker Compose deployment, CI checks and complete Russian and English documentation.

Installation

• English installation guide
• Русская инструкция

Download xui-telegram-admin-1.0.0.tar.gz below and verify it with the attached SHA-256 checksum before installation.

All screenshots and example configurations contain fictional demo data.