InnoUnpack.NET 1.0.0

InnoUnpack.NET

跨平台、纯C#的 Inno Setup 安装包解压库（.NET 10， 零 NuGet 依赖）。

功能

• 支持 Inno Setup 4.0 – 7.x（ANSI 与 Unicode，含 6.5.0+ 新版偏移表布局）
• 压缩算法全覆盖：stored / zlib / bzip2 / LZMA1 / LZMA2（bzip2 自定义实现，LZMA1/LZMA2 移植自 LZMA SDK（Public Domain），zlib 使用 .NET 内置，零第三方依赖）
• 加密安装包解密：
  • ARC4 + MD5（4.2.2 – 5.3.8）
  • ARC4 + SHA1（5.3.9 – 6.3.x）
  • XChaCha20（6.4.0+，含 6.5.0+ 独立加密头）
• 可执行文件调用指令优化还原（Call Instruction Optimizer，4.1.8+ 默认启用）
• 文件校验和验证（MD5 / SHA1 / SHA256 / CRC32 / Adler32）
• 异步 API（OpenAsync / ExtractToDirectoryAsync / IAsyncDisposable）
• 基于 文件数与 字节数的进度报告（绝对进度，百分比由调用方计算）
• 路径安全防护（拒绝路径穿越与绝对路径）
• 多磁盘安装包（数据在 setup-N.bin 切片中）
• 卸载程序提取（4.x 包内嵌的卸载程序数据）

安装

dotnet add package InnoUnpack.NET

快速开始

using InnoUnpack.NET;

using var archive = InnoSetupArchive.Open("setup.exe");

Console.WriteLine($"文件数：{archive.FileCount}，总大小：{archive.TotalFileSize} 字节");

foreach (var file in archive.EnumerateFiles())
{
    Console.WriteLine($"{file.Path} ({file.Size} bytes)");
}

archive.ExtractToDirectory("output");

异步提取与进度

using var archive = await InnoSetupArchive.OpenAsync("setup.exe");

var totalFiles = archive.FileCount;
var totalBytes = archive.TotalFileSize;

var options = new ExtractionOptions();
options.ProgressChanged += p =>
{
    double filePercent = totalFiles == 0 ? 100 : (double)p.FilesExtracted / totalFiles * 100;
    double bytePercent  = totalBytes == 0 ? 100 : (double)p.BytesExtracted / totalBytes * 100;
    Console.WriteLine($"{p.FilesExtracted}/{totalFiles} 文件（{filePercent:F1}%），{bytePercent:F1}%");
};

await archive.ExtractToDirectoryAsync("output", options);

加密安装包

var options = new InnoOpenOptions { Password = "your-password" };
using var archive = InnoSetupArchive.Open("encrypted-setup.exe", options);
archive.ExtractToDirectory("output");

• 密码错误时 Open 抛出 InnoFormatException（"密码不正确"）
• 未提供密码时仍可打开与枚举文件，提取加密文件时抛出 InnoUnsupportedException

多磁盘安装包

数据位于 setup-N.bin 切片中的安装包 无需特殊处理，直接打开：

// setup.exe 的元数据内嵌，数据在同目录的 setup-1.bin / setup-2.bin ... 中
using var archive = InnoSetupArchive.Open("setup.exe");
archive.ExtractToDirectory("output");

注意：从 Stream 打开（Open(Stream, ...)）不支持多磁盘安装包，必须使用文件路径重载。

其他 API

支持范围

• 平台：.NET 10（跨平台，Windows / Linux）
• 依赖：零（无 NuGet 依赖；bzip2 与加密算法自定义实现，LZMA1/LZMA2 移植自 LZMA SDK，zlib 使用 .NET 内置）
• NativeAOT 兼容（无反射，可 PublishAot=true 发布为原生二进制）
• 已知限制：
  • 5.x+ 安装包的卸载程序（UninstExe）数据由安装器运行时生成，不包含在包内（不提取）
  • 加密安装包的 6.5.0+ 解密支持经过算法级验证，但尚未经真实加密样本端到端验证

性能

与 innoextract 对比（同等条件）

同一文件集（排除 innoextract 默认跳过的卸载程序）、关闭校验和与时间戳、相同输出目录、 best-of-7。测试机：i5-9300H，Linux，测试夹具为 Inno Setup 官方安装器（innoextract 1.9 仅支持到 Inno Setup 6.0.5，故可对比 3 个）：

• 热路径（库场景，进程内预热）：与 innoextract 差距约 1.2–2.1x，剩余差距来自 纯托管 LZMA 位解码器 vs liblzma 的原生标量代码（LZMA range coder 为串行位依赖，双方均无 SIMD）
• 冷进程（CLI 场景）：AOT 消除了 JIT 编译开销（约 40–50 ms），AOT-Speed 冷启动与 JIT 热路径基本持平

AOT（NativeAOT）三种 OptimizationPreference

dotnet publish tools/bench -c Release -r linux-x64 -p:PublishAot=true -p:OptimizationPreference=<模式>， 冷进程单次提取（同等条件，best-of-7）：

OptimizationPreference=Speed 耗时为 Default/Size 的 0.74–0.76 倍（快约 32–35%）； 热路径下 AOT-Speed 与 JIT 持平，Default/Size 约慢 30% 左右（JIT 分层编译对热点循环生成更好的代码）。 原生二进制约 3 MB，无运行时依赖。

本库全量提取（公共 API 默认选项，含 SHA256 校验，best-of-3）

内存

• 解码器字典/概率表/输入输出缓冲全部经 ArrayPool 租用并在流销毁时归还： 大缓冲零分配、 提取全程 GC 零收集（gc0/gc1/gc2 均为 0 次）；池预热后单次提取仅约 0.6 MiB 小对象分配
• 文件写出使用 RandomAccess 直接 OS 写入，无 FileStream 内部缓冲分配

复现

# 工具与脚本位于 tools/bench
bash tools/bench/compare.sh <fixtures-dir>   # 自动发布 AOT×3 并输出全部对比表

Windows 对应版本（PowerShell 5.1+/7 均可）：

tools\bench\compare.cmd [fixtures-dir]      # 快捷入口（自动选择 pwsh / powershell）
powershell -ExecutionPolicy Bypass -File tools\bench\compare.ps1 [-FixturesDir <dir>]

测试样本下载（Windows 下运行 dotnet test 前需要）：

powershell -ExecutionPolicy Bypass -File tools\download-fixtures.ps1

许可证

MIT

致谢

• InnoUnpacker-Windows-GUI（MIT）—— 加密、指令优化与 bzip2 的格式/算法参考
• LZMA SDK（Public Domain）—— LZMA1 解码器移植来源
• innoextract —— 二进制格式文档参考