Практическая защитная инструкция по 3X-UI и ghsa-jm48-m3rr-9hgg: как подтвердить исправленную версию 3.3.1, провести ограниченный обратимый тест, распознать корректный исход и передать владельцу минимум данных без активного exploit payload.
Применимость 3X-UI и версионная граница
До теста фиксируют границу: пакет, версия, функция и среда исполнения. Для 3X-UI запись ghsa-jm48-m3rr-9hgg описывает механизм: администратор мог через импорт изменённой базы задать Xray log path вне ожидаемой области и добиться записи файла с правами Xray. В advisory перечислены диапазоны «github.com/mhsanaei/3x-ui/v3: <= 3.3.0; github.com/mhsanaei/3x-ui/v2: <= 2.9.4» и first patched version «3.3.1». Сначала ищут именно этот package в SBOM, lockfile, image или установленном runtime, после чего подтверждают, что процесс загрузил ожидаемый artifact. Отсутствующий компонент даёт not-applicable; найденный, но неактивный путь — affected-unverified; новый manifest при старом процессе — patched-unverified. Backport оценивают по changelog и фактическому patch, а не по строковому сравнению. Дата review 2026-08-24 объясняет своевременность проверки, не частоту атак и не состояние системы читателя.
Baseline перед изменением 3X-UI
Инвентарь этой проверки строится вокруг механизма дефекта: версия панели, digest образа, uid непривилегированного Xray на стенде, копия пустой SQLite, допустимый log root, import validation log и список файлов temp directory. Каждое поле получает значение fact, not-applicable или unknown; пустота не означает безопасность. Рядом сохраняют digest артефакта, health до теста, владельца остановки, resource budget и план возврата. Если baseline уже красный, обновление не смешивают с прежним инцидентом. Секреты, cookies, tokens, реальные сетевые адреса, содержимое сообщений и абсолютные домашние пути не копируют. Такой снимок помогает различить неактивную dependency, смешанные версии, неверную конфигурацию и регрессию именно в границе 3X-UI.
Ограниченный тест для 3X-UI
На стенде заранее задают ресурсный потолок и проводят одно действие: в disposable instance импортировать только пустую базу-копию с log path-маркером, выходящим из выделенного temp root, не добавляя inbound и не запуская сетевой Xray listener. Перед действием фиксируют штатный A, безопасный отрицательный B и повторный штатный A2. Между ними не меняют одновременно dependency, permissions, network и storage. Marker синтетический, не содержит действующего exploit-кода и не обращается к чужим системам. Ожидаемый исход записан заранее: import отклоняет path до применения либо нормализует его внутрь выделенного root, outside-canary не меняется, listener не создаётся. Общий timeout, crash, HTTP 500, потеря readiness или необъяснимый побочный объект не считаются доказательством исправления. В этих случаях ставят failed-safe-check либо unknown, выполняют cleanup и возвращаются к A2.
Критерий решения по ghsa-jm48-m3rr-9hgg
После опыта сопоставляют baseline, отрицательный случай и возврат. Для этой страницы проверяемое условие звучит так: import отклоняет path до применения либо нормализует его внутрь выделенного root, outside-canary не меняется, listener не создаётся. В строке результата хранят artifact digest, применимость функции, исход A/B/A2, health после очистки и доказательство версии. Контролируемый отказ обязан иметь validation, authorization, bounds, resource-limit или policy class, соответствующий механизму advisory. Пустой ответ, неизвестное исключение, изменение соседнего объекта или ручная правка оставляют fail. При mixed versions матрицу делят по процессам; усреднение скрывает риск. Статус passed-bounded-check подтверждает только ghsa-jm48-m3rr-9hgg в указанной конфигурации и момент проверки, а не общую безопасность 3X-UI.
Стоп-линия и восстановление 3X-UI
Если safe-check не даёт ответа, сохраняют unknown и останавливаются. Конкретный запрет здесь: нужна production database, root-процесс, реальный ключ или inbound, запись в home/system path либо запуск сетевого трафика. При первом совпадении input, права и нагрузку не расширяют. Запланированное восстановление: удалить disposable instance и temp database, проверить canary digest, вернуть snapshot прав и убедиться в отсутствии listener. Оно завершено только после повторного baseline, нулевого diff вне стендового объекта и закрытия временных sessions, listeners, handles или subprocess. Если cleanup невозможно доказать, итог остаётся failed-safe-check. Такая дисциплина не допускает превращения защитной диагностики в воспроизведение атаки и сохраняет production вне эксперимента.
Минимальный пакет владельцу 3X-UI
Завершение фиксируют только после cleanup и повторного baseline. Для 3X-UI достаточно: версия, image digest, uid class, нормализованный path без домашнего каталога, import result, canary digest, listener count и cleanup. Добавляют время, ожидаемый и фактический исход, две прямые ссылки ниже и ответственного за cleanup. Полный advisory, персональные сведения, credentials, рабочие payload, дампы памяти и подробности чужой инфраструктуры не пересылают. Финальный словарь ограничен статусами not-applicable, update-required, patched-unverified, passed-bounded-check, failed-safe-check и unknown. При расхождении источника, package manager и runtime выбирают unknown и передают вопрос владельцу. Материал не обещает отсутствие других дефектов, индексацию страницы или рост поисковых позиций.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, даты, версии и ссылки перепроверены. Реальные пользовательские данные, активные опасные payload и вымышленные результаты тестов не использовались.
Источники и проверка
- GitHub Advisory Database ghsa-jm48-m3rr-9hgg по 3X-UI проверено 2026-08-30
- Релиз 3X-UI 3.3.1 проверено 2026-08-30
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.