blacktop/ipsw

ipsw：iOS/macOS研究瑞士军刀

概述

ipsw是一款专为iOS/macOS系统研究设计的综合性工具，被誉为“研究瑞士军刀”。它集成了IPSW（iOS固件文件）和OTA（空中下载更新包）的下载与解析、macho二进制文件分析、Objective-C/Swift类提取、动态链接器共享缓存（dyld_shared_cache）解析、内核缓存（kernelcache）分析、设备树（DeviceTree）解析等多种功能，为开发者、安全研究员和***工程师提供一站式的iOS/macOS系统分析解决方案。

核心功能与特性

• IPSW/OTA处理：支持IPSW和OTA文件的下载、解析与提取
• 二进制文件分析：集成macho解析器，支持Objective-C类提取（class-dump）及Swift类提取（开发中）
• 系统组件解析：包含dyld_shared_cache解析器、内核缓存（kernelcache）解析器、设备树（DeviceTree）解析器
• 固件与镜像处理：支持img4格式文件解析与解密、iboot固件提取
• 硬件与调试支持：提供ARM v9-a架构反汇编器、远程调试设备准备（debugserver）、USB连接设备命令（idev）等功能
• 信息检索：可显示IPSW/OTA文件信息、搜索带指定权限的MachO文件、列出IPSW中的移动设备信息

使用场景与适用范围

ipsw适用于以下场景及用户群体：

• iOS/macOS系统研究：分析系统固件结构、组件交互及底层实现
• 安全漏洞挖掘：解析内核缓存、二进制文件以发现潜在安全漏洞
• ***工程：提取并分析应用与系统组件的类结构、函数调用
• 学术研究：用于移动操作系统底层机制的教学与研究

主要用户包括：iOS/macOS开发者、安全研究员、***工程师、学术研究人员等。

安装方法

macOS

bash
brew install blacktop/tap/ipsw

Linux

bash
sudo snap install ipsw

Windows

bash
scoop bucket add blacktop https://github.com/blacktop/scoop-bucket.git 
scoop install blacktop/ipsw

快速开始

安装完成后，可通过以下命令查看基本用法：

bash
ipsw

输出示例：

Download and Parse IPSWs (and SO much more)

Usage:
  ipsw [command]

Available Commands:
  debugserver     准备设备以进行远程调试
  device-list     列出所有iOS设备
  download        下载Apple固件文件（及更多）
  dtree           解析设备树（DeviceTree）
  dyld            解析dyld_shared_cache
  ent             搜索IPSW文件系统DMG中带有指定权限的MachO文件
  extract         从IPSW/OTA中提取kernelcache、dyld_shared_cache或DeviceTree
  help            查看任意命令的帮助信息
  iboot           提取固件
  idev            USB连接设备命令
  img4            解析Img4
  info            显示IPSW/OTA信息
  kernel          解析kernelcache
  macho           解析MachO
  mdevs           列出IPSW中的所有移动设备
  mount           挂载IPSW中的DMG文件
  ota             解析OTA文件
  pongo           PongoOS终端
  sepfw           提取MachO文件
  shsh            从设备获取shsh blobs
  symbolicate     符号化ARM 64位崩溃日志（类似Apple的symbolicatecrash）
  update          下载ipsw更新（如果存在）
  version         打印ipsw版本号

Flags:
      --color           彩色输出
      --config string   配置文件（默认是 $HOME/.ipsw/config.yaml）
  -h, --help            帮助信息
  -V, --verbose         详细输出

使用 "ipsw [command] --help" 获取具体命令的详细帮助信息

常用命令示例

下载IPSW文件

bash
ipsw download --device iPhone13,2 --version 16.5

解析内核缓存

bash
ipsw kernel parse /path/to/kernelcache

提取IPSW中的设备树

bash
ipsw extract dtree /path/to/ipsw.ipsw

文档与社区

官方文档

完整文档请访问：https://blacktop.github.io/ipsw

社区支持

• *****：加入*服务器
• *******：@blacktop__
• ****：@
• GitHub Discussions：https://github.com/blacktop/ipsw/discussions

许可证

本项目采用MIT许可证，详情参见LICENSE。