Skip to content

XPAM Script v1.3.8

Choose a tag to compare

@deepru deepru released this 12 Jul 23:29
· 32 commits to main since this release

XPAM Script v1.3.8

Релиз-обновление на базе v1.3.7. Главное — полная совместимость с 3x-ui v3.5.0,
где MTProto перешёл на мульти-клиентскую модель. Пользовательский интерфейс не изменился.

Те же команды <prefix>-xpam, <prefix>-links, <prefix>-health, <prefix>-repair.
VLESS и Telegram links по-прежнему берутся из актуальной базы 3x-ui.


🚀 Главное в v1.3.8

  • Совместимость с 3x-ui v3.5.0 (мульти-клиентский MTProto, Xray 26.7.11).
    В v3.5.0 секрет MTProto переехал с уровня inbound'а на отдельных клиентов, а
    создание inbound'а стало строже парсить клиентов. XPAM читает и пишет обе
    формы
    , поэтому одна и та же сборка работает и на 3x-ui 3.4.2, и на 3.5.0.
  • Починка создания MTProto на 3.5.0. MTG теперь создаётся с клиентом,
    несущим секрет, — Telegram proxy работает на чистой установке под 3.5.0
    (которая вырезает секрет уровня inbound'а). Обратная совместимость с 3.4.2
    сохранена.
  • Починка создания VLESS на 3.5.0. Устранён отказ создания VLESS из-за более
    строгого разбора клиента (поле tgId теперь отправляется числом).

✅ Совместимость

Релиз полностью протестирован с 3x-ui v3.5.0 / Xray 26.7.11 (чистая
установка на Ubuntu 24.04) и сохраняет совместимость с 3x-ui 3.4.2. Базовая
проверенная связка панели обновлена до 3x-ui 3.5.0 / Xray 26.7.11.

♻️ Что изменилось (важно прочитать)

  • MTProto стал мульти-клиентским. sudo <prefix>-links --show-secrets теперь
    показывает ссылку каждого включённого клиента — как VLESS, так и Telegram.
  • MTProto-клиент получает subscription id. Благодаря этому панель 3x-ui
    показывает его ссылку/QR на странице «Клиенты».
    • ⚠️ Панельный QR/копирование ссылки для MTProto использует внутренний порт
      (ограничение самого 3x-ui, issue #5126). Авторитетная рабочая ссылка (:443)
      — из sudo <prefix>-links --show-secrets. У managed-клиента об этом есть
      напоминание в комментарии.

🔄 Обновление с v1.3.7

Обновление — штатное, через меню:

  1. sudo <prefix>-xpam → раздел обновления XPAM.
  2. Апдейтер скачает релиз, проверит SHA256, подготовит staging, сделает backup,
    применит новую версию, запустит post-update health/deep-health и откатится при
    ошибке.
  3. После обновления выполните sudo <prefix>-health --deep для контроля.

Данные подключения (VLESS / Telegram links), домены и DoubleHop-состояние при
обновлении не меняются.

Порядок обновления при переходе на 3x-ui 3.5.0: сначала обновите XPAM до v1.3.8,
и только затем обновляйте панель 3x-ui до 3.5.0. Существующие MTProto-инбаунды
при апгрейде мигрируют автоматически, а v1.3.8 корректно читает и старую, и
новую форму секрета.

🧪 Проверка релиза

Перед публикацией v1.3.8 проверен на чистом VPS:

  • Ubuntu 24.04 + 3x-ui v3.5.0 — установка, VLESS-инбаунд, MTProto-инбаунд с
    рабочим секретом и Telegram-ссылкой, <prefix>-links --show-secrets.
  • Целостность архива и путь установки/самообновления (wrapper-структура, SHA256).

🔐 Секреты

Не публикуйте вывод sudo <prefix>-links --show-secrets, VLESS/Telegram links,
пароли и токены в чатах, issues, скриншотах или публичных логах.