
如果你想贡献代码,请在这里联系我:https://abrignoni.github.io
博客文章见:https://leapps.org/blog
预构建版本无需安装 Python:ALEAPP GitHub Releases, 或访问 LEAPPs Releases 获取整个 LEAPP 系列。
| 平台 | 下载 |
|---|---|
| Windows (Intel/AMD) | ALEAPP-*-windows-x64-portable.zip |
| Windows (ARM) | ALEAPP-*-windows-arm64-portable.zip |
| macOS (Apple Silicon) | ALEAPP-*-macos-arm64.dmg |
| macOS (Intel) | ALEAPP-*-macos-x64.dmg |
| Linux (Intel/AMD) | ALEAPP-*-linux-x64.AppImage |
| Linux (ARM) | ALEAPP-*-linux-arm64.AppImage |
| Debian、Ubuntu (Intel/AMD、ARM) | ALEAPP-*-linux-x64.deb、ALEAPP-*-linux-arm64.deb |
| Fedora 及其他基于 RPM 的 Linux (Intel/AMD、ARM) | ALEAPP-*-linux-x64.rpm、ALEAPP-*-linux-arm64.rpm |
每个下载包都包含一个程序 aleapp。每个发行版中的 SHA256SUMS.txt 可用于校验下载内容。
.deb 和 .rpm 与 AppImage 包含相同的构建,并将 aleapp 添加到 PATH 中,
同时提供菜单项。请使用你的包管理器,从下载所在的文件夹中安装:
sudo apt install ./ALEAPP-<version>-linux-x64.deb
sudo dnf install ./ALEAPP-<version>-linux-x64.rpm
GUI:按常规方式打开 ALEAPP:在 Windows 上双击 zip 中的 aleapp.exe,在 macOS 上从“应用程序”中打开 ALEAPP,或在 Linux 上运行 AppImage。不带参数启动时,它会打开窗口。
CLI:在终端中为 aleapp 提供参数,它便会以命令行方式运行。输出文件夹必须已存在。在 Windows 上,请使用 zip 中的 aleapp.exe。
aleapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\
在 Linux 上,使用相同的参数运行 AppImage,或者在安装 .deb 或 .rpm 后直接运行 aleapp。在 macOS 上,它位于应用内部;若要在终端中直接输入 aleapp,请先将其链接到你的 PATH 中:
sudo ln -s /Applications/ALEAPP.app/Contents/MacOS/aleapp /usr/local/bin/aleapp
Python 3.11 或更高版本
你的 Python 环境所需的依赖项列在 requirements.txt 中。使用以下命令安装它们。请确保
py 部分与你的环境相符,例如 py、python 或 python3 等。
py -m pip install -r requirements.txt
或
pip3 install -r requirements.txt
如需使用发布版本构建时所采用的精确 mister_skinnylegs 依赖链,请改用以下
方式。它会先安装不含 mister_skinnylegs 行的 requirements.txt,再安装
不含依赖项的 requirements-msl-lock.txt,并在 Brotli 版本低于 1.2.1 时停止。
即使某个 ccl 读取器的默认分支当天无法安装,它也能正常工作:
python3 admin/scripts/install_requirements.py
要在 Linux 上运行,你还需要单独安装 tkinter,如下所示:
sudo apt-get install python3-tk
packaging/build.py 会在其运行的机器上,从同一个虚拟环境使用 PyInstaller 构建 aleapp。
它会先安装固定版本的构建工具,然后通过 admin/scripts/install_requirements.py 安装 requirements.txt 和
requirements-msl-lock.txt。
python packaging/build.py exe # dist/ALEAPP/, and dist/ALEAPP.app on macOS
python packaging/build.py smoke # run what it built, without opening a window
python packaging/build.py installer # Windows: Inno Setup installer; macOS: .dmg; Linux: AppImage
python packaging/build.py linux-packages # Linux: .deb and .rpm around dist/ALEAPP/ (dpkg-deb, rpmbuild)
exe --onefile 会将 dist/aleapp(在 Windows 上为 dist\aleapp.exe)打包为单个文件。Windows 安装程序需要 Inno Setup;在 Linux 上,smoke 需要显示环境,由 xvfb-run 提供。python packaging/build.py --help 包含其余内容。
$ python aleapp.py -t <zip | tar | fs | gz | raw> -i <path_to_extraction> -o <path_for_report_output>
raw 直接读取磁盘镜像(.img、.dd、.bin,或分卷集合中任意编号的 .001 分段),或读取一个采集文件及其旁边的分段或文件(EnCase/EWF .E01、SMART .s01、EWF2 .Ex01、AFF .aff、AFM .afm、AFD 文件夹中的任意 .aff、AFF4 .aff4、Apple .dmg 及其旁边的任意 .dmgpart 文件、.sparseimage 或 .sparsebundle 文件夹,或虚拟机磁盘 .vhd、.vhdx、.vmdk 或 .qcow2),就地读取:无需挂载,也无需管理员权限。其 NTFS、FAT32、FAT16、FAT12、exFAT、ext2/3/4、F2FS、HFS+、APFS、QNX6、QNX4、ETFS、EFS、SquashFS、JFFS2、UBI/UBIFS、YAFFS 和 QNX IFS 卷会被直接搜索(U-Boot 环境或 Belkin NVRM 存储则作为单个文件读取),并且只从镜像中读出工件所需的文件。逻辑证据(EnCase .L01 或 FTK Imager .ad1)按其包含的文件读取。GUI 会针对这些扩展名自动选择 raw,对于通过文件夹按钮选择的 sparse bundle 或 AFD 文件夹也是如此。参见 admin/docs/raw_image_input.md。
加密镜像可通过其密码(--image_password_file 或 --image_password_env)打开,或者当镜像以证书封装时,使用该证书的 RSA 私钥(--image_private_key)打开。镜像中的 BitLocker 卷可通过其密码或恢复密码(以相同方式提供)或启动密钥(--bitlocker_key,可重复)打开;macOS 以软件方式加密的 APFS 卷可通过其密码或个人恢复密钥打开;LUKS 容器可通过其口令打开,均以相同方式提供。在终端中,缺失的内容会被询问;GUI 则通过对话框询问;无法打开的 BitLocker、APFS 或 LUKS 卷会被报告且不会被搜索。
Linux 软件 RAID 集合(md,或跨磁盘的 LVM2)的磁盘镜像会被一起读取:将它们全部通过 -i 配合 -t raw 提供,或在 GUI 的文件对话框中一起选择。若只提供一个包含某个成员的镜像,其他成员会在其所在文件夹中根据每个文件自身记录的信息(而非文件名)进行查找;命令行会在读取集合之前列出找到的内容、遗漏的内容及原因(--no-find-members 仅读取给定的镜像),GUI 会在读取找到的文件之前进行询问。报告会列出读取的每个镜像,并标记自动找到的镜像。包含 md 成员的单个镜像也会连同其阵列一起读取:具有元数据 1.1 或 1.2 的孤立 RAID1 成员现在会通过阵列读取其文件系统,其卷名前面会加上镜像或阵列的名称。同一磁盘提供两次只会读取一次。未找到 RAID 元数据的镜像按原样读取;关于 qnxprobe 1.71 如何处理单独读取的 DDF、IMSM 和 md 成员镜像,请参见 admin/docs/raw_image_input.md。
tar 也可读取 xz 压缩的 tar(.tar.xz),GUI 会针对该扩展名选择 tar。压缩的 tar(包括 .tar.gz)会在读取任何文件之前解压一次到报告文件夹中,因此运行需要在该处有足够的空闲空间来存放未压缩的 tar。运行结束时副本会被删除,运行日志会记录该步骤耗时。
$ python aleappGUI.py
$ python aleapp.py --help
Artifact 模块位于 scripts/artifacts/ 中,每次 ALEAPP 运行时都会加载。
新模块: 请从 How to Write an iLEAPP Module 开始。该文档以 iLEAPP 作为参考,而 ALEAPP 模块使用相同的 __artifacts_v2__ 块和 @artifact_processor 装饰器。各工具之间的辅助函数并不完全相同,因此在导入某个辅助函数之前,请先确认它存在于 ALEAPP 的 scripts/ilapfuncs.py 中。
模块用于查找文件、读取 SQLite、检查媒体文件以及转换时间戳所调用的辅助函数,在 Helper Functions for Artifact Modules 中有详细说明。
一个模块包含两部分:文件顶部的 __artifacts_v2__ 字典,以及每个 artifact 对应一个使用 @artifact_processor 装饰的函数。例如:
__artifacts_v2__ = {
"get_cool_messages": {
"name": "Cool App Messages",
"description": "Messages from the Cool App database",
"author": "@username",
"creation_date": "2026-10-14",
"last_update_date": "2026-10-14",
"requirements": "none",
"category": "Cool App",
"notes": "",
"paths": ('*/CoolApp/cool.db*',),
"output_types": "standard",
"artifact_icon": "message",
}
}
from scripts.ilapfuncs import (
artifact_processor, convert_unix_ts_to_utc, get_file_path, get_sqlite_db_records)
@artifact_processor
def get_cool_messages(context):
source_path = get_file_path(context.get_files_found(), 'cool.db')
if not source_path:
return (), [], ''
query = 'SELECT sent_at, sender, body FROM messages'
data_list = []
for row in get_sqlite_db_records(source_path, query):
data_list.append((convert_unix_ts_to_utc(row[0]), row[1], row[2]))
data_headers = (('Sent', 'datetime'), 'Sender', 'Message')
return data_headers, data_list, source_path
每个条目的键(上面的 get_cool_messages)必须与其被装饰函数的名称一致。加载器和装饰器正是通过这种方式找到彼此的。该条目包含:
name:报告中显示的工件名称。它在 ALEAPP 内必须唯一;加载器遇到重复项会停止。description、author、notes:关于该工件的文本。notes 可以为空。creation_date、last_update_date:YYYY-MM-DD 格式的日期。两者都会写入 LAVA 输出。修改模块时请更新 last_update_date。requirements:关于该工件所需任何内容的说明,或 "none"。category:在报告中对工件进行分组。paths:该工件所读取文件的模式元组。它们使用 Python 的 fnmatch 进行匹配,因此 * 可以跨越 /。output_types:"standard"(除 KML 外的所有输出)、"all",或取自 html、tsv、timeline、lava 和 kml 的列表。artifact_icon:出现在 scripts/_elements/tabler-icons.css 中的 Tabler 图标名称。可选键:
html_columns:写入 HTML 报告时不进行转义的列。任何来自证据的值都要通过 scripts/html_safe.py 中的辅助函数处理。data_views:备用的 LAVA 视图,例如用于消息工件的对话视图。这些视图的列顺序见 Conversation Column Order。sample_data:测试语料库名称到该语料库所产生内容的简短说明的映射。工件处理器会忽略它。参见 Test data and sample_data for your PR。该函数接受一个参数 context,它提供其 paths 所匹配到的文件(context.get_files_found())以及本次运行的其余内容。它返回三样东西:列标题、行元组列表,以及这些行来源文件的路径。装饰器根据 output_types 的要求,用它们写出 HTML、TSV、时间线、KML 和 LAVA 输出。空列表不会写出任何表格。
标题可以是一个元组,用于指定列类型:('Sent', 'datetime')、('Day', 'date')、('Number', 'phonenumber') 或 ('Photo', 'media')。普通字符串则是文本列。