
iLEAPP v2026.3.3
Преобразует форензик-извлечения iOS и iPadOS в отчёты HTML, TSV, timeline, KML и LAVA с модульным обнаружением артефактов и поддержкой зашифрованных резервных копий iTunes.

Парсер логов, событий и plist-файлов iOS
iLEAPP анализирует криминалистические извлечения данных iOS и iPadOS и формирует вывод в форматах HTML, TSV, временной шкалы, KML и LAVA. Поддерживаются версии iOS/iPadOS с 11 по текущие.
Полный список артефактов с поиском доступен на leapps.org/artifacts (фильтр по инструменту LEAPP).
Быстрый старт (рекомендуется)
Скачайте готовый релиз — установка Python не требуется.
- Релизы LEAPPs — просмотр всех инструментов семейства LEAPP
- Релизы iLEAPP на GitHub — прямые загрузки
| Платформа | Загрузка |
|---|---|
| Windows (Intel/AMD) | iLEAPP-*-windows-x64-portable.zip |
| Windows (ARM) | iLEAPP-*-windows-arm64-portable.zip |
| macOS (Apple Silicon) | iLEAPP-*-macos-arm64.dmg |
| macOS (Intel) | iLEAPP-*-macos-x64.dmg |
| Linux (Intel/AMD) | iLEAPP-*-linux-x64.AppImage |
| Linux (ARM) | iLEAPP-*-linux-arm64.AppImage |
Каждая загрузка содержит одну программу — ileapp. Файл SHA256SUMS.txt в каждом релизе позволяет проверить загруженный файл.
Совместимость с Linux: официальные AppImage собраны на Ubuntu 22.04 и требуют glibc 2.35 или новее.
GUI — откройте iLEAPP обычным способом: двойным щелчком по ileapp.exe из zip-архива в
Windows, по iLEAPP в папке Applications в macOS или по AppImage в Linux. При запуске без аргументов открывается окно; выберите тип входных
данных, путь к источнику, папку вывода и модули для обработки.
CLI — передайте ileapp аргументы в терминале, и он запустится в режиме командной строки. Папка
вывода должна уже существовать. В Windows используйте ileapp.exe из zip-архива.
ileapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\
В Linux запустите AppImage с теми же аргументами. В macOS он находится внутри приложения; чтобы
просто вводить ileapp в терминале, один раз создайте ссылку на него в вашем PATH:
sudo ln -s /Applications/iLEAPP.app/Contents/MacOS/ileapp /usr/local/bin/ileapp
Типы входных данных
| Тип | Описание |
|---|---|
fs | Папка с извлечёнными файлами с обычными путями и именами |
zip | ZIP-архив, содержащий файлы с обычными именами |
tar | TAR-архив, обычный или сжатый xz (.tar.xz) |
gz | Архив, сжатый GZIP |
itunes | Папка резервной копии iTunes/Finder с хешированными путями и именами |
file | Ввод в виде одного файла |
Поддерживаются зашифрованные резервные копии iTunes/Finder (-t itunes). При обнаружении шифрования GUI запросит пароль перед обработкой. В CLI пароль передаётся с помощью --itunes_password (см. Дополнительные параметры парсинга ниже).
Аргументы CLI
Эти параметры применяются только к CLI (ileapp / ileapp.exe с переданными аргументами или python ileapp.py). GUI (ileapp, запущенный без аргументов, или python ileappGUI.py) предоставляет те же настройки через свой интерфейс вместо флагов командной строки.
Запустите ileapp --help (или python ileapp.py --help из исходников), чтобы получить встроенную справку.
Парсинг кейса
Эти три аргумента обязательны для обычного запуска парсинга:
| Аргумент | Длинная форма | Описание |
|---|---|---|
-t | Тип входных данных: fs, tar, zip, gz, itunes или file | |
-i | --input_path | Путь к входному файлу или папке |
-o | --output_path | Путь к выходной папке (должна уже существовать) |
Пример:
ileapp -t zip -i /path/to/extraction.zip -o /path/to/output/
Дополнительные параметры парсинга
| Аргумент | Длинная форма | Описание |
|---|---|---|
-w | --wrap_text | Передайте этот флаг, чтобы отключить перенос текста в выходных файлах |
-m | --load_profile | Путь к файлу профиля iLEAPP (.ilprofile), ограничивающему набор запускаемых модулей |
-d | --load_case_data | Путь к файлу данных дела LEAPP (.lcasedata) |
--custom_output_folder | Пользовательское имя подпапки для вывода отчёта | |
--custom_artifacts_path | Дополнительная папка для загрузки модулей артефактов (например, scripts/alternate_artifacts) | |
--html_row_limit | Количество строк, при превышении которого таблица артефакта не включается в его HTML-страницу, а страница вместо этого указывает на базу данных LAVA и экспорт в TSV. По умолчанию 50000; 0 записывает все таблицы. В GUI используется значение по умолчанию | |
--itunes_password |
Автономные служебные режимы
Эти режимы не выполняют парсинг дела. Используйте их отдельно — без -t, -i или -o:
| Аргумент | Длинная форма | Описание |
|---|---|---|
-p | --artifact_paths | Записать все пути поиска артефактов в path_list.txt в текущем каталоге |
-c | --create_profile_casedata | Интерактивный мастер для создания файла .ilprofile или .lcasedata в указанной папке |
Примеры:
ileapp -p
ileapp -c /path/to/output/folder/
Участие в разработке
Модули артефактов находятся в scripts/artifacts/ и загружаются динамически во время выполнения.
Новые модули: начните с пошагового руководства How to Write an iLEAPP Module.
Дополнительные материалы:
- Artifact Info Block Structure
- Helper Functions for Artifact Modules
- Updating Modules for Automatic Output Generation
- Updating Complex Modules to Include LAVA Output
- Testing Modules
Тестовые данные и sample_data для вашего PR
PR, который добавляет или изменяет артефакт, проще всего проверить и слить, когда он содержит
две вещи: небольшой тестовый фикстур, вырезанный из реального извлечения, и значения sample_data, которые
фиксируют, что произвёл модуль. Скрипты генерируют и то, и другое. Вот весь процесс.
Одно правило прежде всего: всё, что вы закоммитите здесь, станет публичным. Используйте только данные, которые вам разрешено публиковать, например тестовое устройство, которое вы наполнили сами, публичный исследовательский образ или файл, который вы очистили вручную. Никогда не используйте материалы из реальных дел.
1. Вырежьте фикстур из вашего извлечения
python admin/test/scripts/make_test_data.py <module> --case 1 --input <extraction.zip>
Эта команда извлекает из распакованных данных файлы, соответствующие шаблонам paths вашего модуля, и записывает файл кейса admin/test/cases/testdata.<module>.json, а также по одному небольшому zip-архиву на каждый артефакт в admin/test/cases/data/<module>/.
Правила по размеру: менее 10 МБ на zip — коммитьте его вместе с PR. От 10 до 25 МБ — закоммитьте файл кейса и прикрепите zip к комментарию в PR. Если больше — сообщите об этом в PR, и мейнтейнер организует передачу.
2. Запишите ожидаемый вывод
TZ=UTC python admin/test/scripts/test_module.py <module> -a all -c all
Запускает модуль на фикстуре и записывает снимок вывода в
admin/test/results/<module>/. Закоммитьте снимок тоже. Он становится базовой линией,
которая защищает модуль после слияния. Сохраните часть TZ=UTC: закоммиченные снимки
в UTC, и CI работает в UTC.
3. Запустите то же сравнение, которое выполнит CI