Skip to content
Последнее обновление
3 нояб. 2026 г., 03:46

Диагностический отчет (.zip) и конфиденциальность ​

ЦЕНТР ДИАГНОСТИКИ И СБОЕВ

Ищете решение частых сбоев или расшифровку кодов ошибок?

При решении сложных проблем с лаунчером, ошибок прямого соединения P2P или зависаний загрузки зависимостей разработчики или участники сообщества могут попросить вас предоставить Диагностический отчет XMCL (Diagnostic Report).

В этом руководстве описано, как сгенерировать такой отчет, какие технические сведения он включает, и как архитектура XMCL гарантирует сохранность ваших персональных данных и аккаунтов.


1. Как сгенерировать диагностический отчет ​

Отчет можно экспортировать прямо из интерфейса XMCL:

  1. Откройте Настройки (значок шестеренки в нижнем левом углу).
  2. Перейдите во вкладку Хранилище или Диагностика.
  3. Нажмите Экспортировать диагностический отчет (или комбинацию Ctrl+Shift+D / Cmd+Shift+D в актуальных версиях).
  4. XMCL сформирует единый архив .zip на вашем рабочем столе или в указанной папке (например, xmcl-diagnostic-2026-10-26.zip).

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

  • Windows: %APPDATA%\xmcl\logs\
  • macOS: ~/Library/Application Support/xmcl/logs/
  • Linux: ~/.config/xmcl/logs/

2. Что содержится в отчете? ​

Архив .zip является открытым и незашифрованным — вы можете распаковать его и просмотреть каждый файл перед передачей:

Файл / КаталогСодержимое и назначение
main.logЖурнал основного процесса Electron/DeskGap: запуск, файловый ввод-вывод, IPC-сообщения, проверка обновлений.
renderer.logЖурнал графического интерфейса: жизненный цикл Vue 3, ошибки фронтенда, переходы между разделами.
device.jsonСведения о системе: версия ОС, номер сборки ядра, общий объем оперативной памяти (RAM), архитектура CPU (x64, arm64), модель GPU.
java.jsonОбнаруженные в системе среды Java: версии, пути, мажорные версии, вендор (Adoptium, Oracle, Zulu).
instance.json (очищенный)Конфигурация активного инстанса: версия Minecraft, загрузчик (Fabric, Forge, NeoForge, Quilt), выделенная память (-Xmx), аргументы JVM.
network.logЗапросы на скачивание файлов, зеркала CDN, STUN/TURN рукопожатия для комнат P2P.

3. Строгая конфиденциальность: что НИКОГДА не собирается ​

XMCL придерживается принципов локального хранения и прозрачности открытого исходного кода. В диагностический отчет категорически не попадают:

  • Токены авторизации Microsoft / Xbox: токены сессий (Access Token, Refresh Token) сохраняются исключительно в системных хранилищах учетных данных ОС (Windows DPAPI, macOS Keychain, Linux Secret Service) и никогда не пишутся в логи.
  • Пароли сторонних / оффлайн учетных записей: пароли и секретные ключи серверов не сохраняются в текстовом виде.
  • Системные пути и имена пользователей: пути к файлам, содержащие имя вашей учетной записи (например, C:\Users\Имя\), автоматически заменяются на <USER_HOME> или анонимные заглушки.
  • Миры, сохранения и переписка: игровые сохранения, инвентарь, IP-адреса из servers.dat и переписка из чата полностью исключены из отчета.

4. Проверка перед передачей ​

Перед отправкой архива в открытые источники:

  1. Распакуйте и просмотрите: откройте .zip любым архиватором (7-Zip, WinRAR и др.).
  2. Проверьте текстовые файлы: при желании откройте main.log или renderer.log в текстовом редакторе и убедитесь в отсутствии специфических локальных сетевых имен.
  3. Удалите лишнее: если вопрос касается только лаунчера, логи самой игры из архива можно удалить.

5. Куда безопасно отправить диагностический отчет ​

После проверки вы можете прикрепить отчет к обращению в официальных сообществах:

  • GitHub Issues: прикрепите .zip к вашему тикету в репозитории voxelum/x-minecraft-launcher/issues.
  • Официальный Discord: передайте файл в каналах #support или #troubleshooting на сервере XMCL Discord.
  • Reddit: загружайте выдержки через mclo.gs и оставляйте вопросы в сабреддите r/xmcl.

СОВЕТ

Никогда не выкладывайте полные логи на публичные сервисы хранения текста. Для Discord и GitHub всегда используйте mclo.gs, который надежно маскирует приватные пути и случайные сетевые адреса.