Skip to content

SKILL.md

Latest commit

 

History

History
166 lines (111 loc) · 12.1 KB

SKILL.md

File metadata and controls

166 lines (111 loc) · 12.1 KB
Raw
name frida-ios-dump
description 自动安装和配置 AloneMonkey/frida-ios-dump，连接 USB 越狱 iPhone，枚举应用并导出解密 IPA。适用于用户要求搭建 iOS 砸壳环境、使用 SSH 别名或密钥连接设备、拉取指定应用的场景。

frida-ios-dump 自动化工作流

你负责实际执行仓库获取、依赖安装、连接检查和指定应用导出，直到交付经过验证的 IPA，或说明具体阻碍。用户只要求安装时，完成安装和连接验证即可。此文件可独立通过链接读取，无需预先安装本仓库或其他 skill。

仓库：https://github.com/AloneMonkey/frida-ios-dump

1. 确定环境与任务

  • 优先复用用户已提供的工作目录、设备、SSH 别名、账号、密钥和应用名称。只询问仍缺少的信息；可以先获取仓库、检查运行时和 SSH 配置，不要为可自动发现的信息中断工作。
  • 主机需要 Python 3.10+、Node.js/npm（或 pnpm）和 Git。打包使用 Python 标准库，不需要外部 zip、chmod 或 tar。优先使用现有运行时和项目虚拟环境；缺少工具时用适合当前系统的包管理器补齐，不执行来历不明的远程安装脚本。
  • 设备需要已越狱、运行 frida-server 和 SSH 服务，通过 USB 连接并信任主机。解锁、确认信任等物理操作需要用户完成；本工作流不负责越狱。
  • 默认仍用 USB。用户指定远程设备时使用 --remote HOST[:PORT]，前提是设备的 Frida 和 SSH 服务均可从主机访问；不为此自动修改设备服务监听配置。
  • 导出前明确目标应用，优先使用枚举得到的 Bundle ID。未指定目标时先列出应用供用户选择。

2. 获取仓库

新目录中执行（目录可按用户需求调整）：

git clone https://github.com/AloneMonkey/frida-ios-dump.git
cd frida-ios-dump

用户提供了分支、标签或提交时使用该版本。通过某个分支或提交的链接读取本文件时，优先获取同一版本的仓库。没有 Git 时可下载对应版本的 GitHub 源码 ZIP 并用 Python zipfile 解压，不必增加 tar 依赖。

已有仓库时先检查 remote、当前分支和 git status --short。复用本地修改；仅在适合更新且工作区干净时快进拉取，不执行 reset --hard、clean 或覆盖用户文件。

确认该版本同时包含 SKILL.md、requirements.txt、package.json、dump.py、dump.js；package.json 应包含 frida-objc-bridge。缺少新版本文件时报告版本不符，不用旧版脚本冒充完成安装。

3. 安装依赖

以下命令在仓库根目录执行。先确认 python3 版本满足要求；如不满足，选择已有的新版 Python 创建 .venv，已有可用虚拟环境则复用：

python3 -m venv .venv
./.venv/bin/python -m pip install -r requirements.txt
npm install
./.venv/bin/python dump.py --help

Windows PowerShell 使用 python -m venv .venv 创建环境；将本文件后续命令中的 ./.venv/bin/python 替换为 .\.venv\Scripts\python.exe，不要执行 Unix 的激活脚本或直接运行 ./dump.py。符号链接和 iOS 文件权限会记录后直接写入 IPA，不需要在 Windows 本地创建链接或设置只读权限。该路径已完成模拟测试，完整 Windows 真机流程尚未实测。

已安装 pnpm 时可用 pnpm install --frozen-lockfile 替代 npm install。仓库没有 npm 的 lockfile，不使用 npm ci。后续命令均使用虚拟环境中的 Python，无需依赖跨工具调用保留 shell 激活状态。

Frida 17 的 Objective-C bridge 由 npm/pnpm 安装，dump.py 会自动编译 agent，不需要手动运行 frida-compile。

安装后直接枚举应用，无需提前查询或对齐设备 Frida 版本，也无需 SSH 凭据：

./.venv/bin/python dump.py -l

多台 USB 设备时，先用 frida-ls-devices 找到用户指定设备的 ID，并在枚举和导出命令中都加 --device-id DEVICE_ID；虚拟环境工具可用 ./.venv/bin/frida-ls-devices（Windows 为 .\.venv\Scripts\frida-ls-devices.exe）。用户指定远程连接时，枚举改为 ./.venv/bin/python dump.py --remote HOST:27042 -l，后续导出也保留同一 --remote。这两个选项互斥，连接失败不得改用其他设备。

如果设备 Frida 仅监听回环地址，可通过指向设备网络地址的 SSH 别名建立隧道：ssh -N -L 127.0.0.1:27043:127.0.0.1:27042 iphone-network，随后使用 --remote 127.0.0.1:27043 -H iphone-network；任务结束后关闭隧道。远程模式省略 agent source map 以减小上传体积，USB 模式保留。

如果实际运行出现兼容性错误，再根据具体报错处理，不预先创建版本约束文件或调整设备服务。

4. 配置 SSH

直接通过 USB

默认连接设备 SSH 22 端口，账号密码为 root / alpine。不需要 iproxy 或本机 2222 转发。

./.venv/bin/python dump.py 'BUNDLE_ID'

账号不同时使用 -u，密钥使用 -K；密码使用 -P。不需要用户提供凭据时不要索取密码。确需密码时避免将其写入仓库、示例文档或最终报告；命令行 -P 会使密码可能出现在进程参数中，优先复用已有密钥。

复用 SSH 别名

先读取用户指定别名的配置。-H 支持 ~/.ssh/config 中的 HostName、Port、User、IdentityFile；命令行选项覆盖配置。不能假定支持系统 OpenSSH 的全部选项，例如跳板机或任意 ProxyCommand。

下面是 USB 别名示例，仅在用户需要创建别名时合并到已有配置；用户名和密钥路径按实际情况选择，密钥不存在时省略 IdentityFile：

Host iphone
    HostName 127.0.0.1
    Port 22
    User mobile
    IdentityFile ~/.ssh/frida_ios_dump_ed25519
./.venv/bin/python dump.py -H iphone 'BUNDLE_ID'

默认自动模式下，localhost/127.0.0.1/::1 主机或别名均使用 USB，端口表示设备 SSH 端口，不限于 22。例如设备服务监听 44 时，设置别名 Port 44 或传入 -p 44。显式远程主机名/IP 使用 TCP。可用 --ssh-transport usb 或 --ssh-transport tcp 显式选择；连接已有本机 TCP 转发服务时使用后者。USB 通道由 dump.py 提供，上面的别名本身不能让系统 ssh iphone 或 ssh-copy-id iphone 自动走 USB。密钥认证失败时仍可回退到默认密码或显式 -P。

使用 --remote 时，SSH 默认通过 TCP 连接该 Frida 端点的主机、22 端口；-H 可单独指定 SSH 主机或别名，-p 仍只设置 SSH 端口，不设置 Frida 端口。远程模式即使 -H 指向 localhost 也使用 TCP，不与 --ssh-transport usb 组合。IPv6 Frida 端点使用 [IPv6]:PORT。

可选：用户要求免密登录时

复用已有密钥，或创建专用于该设备的密钥。通过已经认证的 SSH/SFTP 连接，将公钥去重追加到对应远端用户的 ~/.ssh/authorized_keys，保留已有内容，目录权限 700、文件权限 600。私钥留在主机，不能上传。

USB 场景可读取本仓库 dump.py 的 resolve_ssh_options 和 connect_ssh，复用已选定的设备对象建立 connect_ssh(..., use_usb=True) 连接，再执行配置或使用 SFTP。需要重新获取设备时，用户指定过 ID 就调用 get_frida_device(device_id=DEVICE_ID)；仅在未指定设备时使用默认 USB 选择。配置公钥、独立登录验证、枚举和导出必须沿用同一设备或 ID，获取失败不得回退到默认设备。按当前函数签名调用，结束时关闭 SSH 客户端和返回的 USB forwarder。不为配置密钥引入本机端口转发依赖。

配置后用 password=None、allow_agent=False、look_for_keys=False 和指定私钥建立一次独立连接，确认成功来自该密钥，再报告免密可用。不要关闭设备密码登录或替换其他公钥。

5. 导出应用

从枚举结果确认 Bundle ID，确认设备保持解锁，并选择输出路径。脚本创建全新 IPA、通过 ZIP 完整性校验后才替换同名文件；打包或校验失败会保留原 IPA。例如：

./.venv/bin/python dump.py -H iphone -o './exported-app.ipa' 'BUNDLE_ID'

排查卡住时加 -v 查看连接、spawn/attach、agent 编译/加载、下载和打包阶段。慢设备可按实际错误调整 --agent-timeout SECONDS（等待下一条 agent 消息，默认 120）或 --transfer-timeout SECONDS（SCP/SFTP 的 I/O 等待，默认 60，包含 SFTP 通道建立与初始化、扫描、下载和临时文件清理）。这些参数不是总导出时限，也不控制 Frida 的 spawn/attach 或 agent 编译/加载超时，不应将延长等待当作这些问题的修复。诊断输出不要附加密码或密钥内容。

没有别名时省略 -H iphone，其他 SSH 参数按已验证的配置添加。

主机每次导出使用独立临时目录；设备端使用任务 UUID 和模块序号生成 .fid，避免同名模块覆盖。脚本内部已经并行下载二进制和资源，单次导出无需额外启动多个进程。临时文件隔离不代表同一应用的多次注入或生命周期操作已经过并发验证。

start dump 表示设备正在生成解密文件；随后才是传输。已下载的二进制按精确相对路径从资源传输中跳过，只传一次。资源目录边扫描边提交下载，扫描期间显示字节和条目数，总量确定后显示百分比，不额外运行一次全目录扫描或 tar 打包。

运行期间观察输出和进程状态，持续向用户说明当前阶段。需要中断时发送 Ctrl+C，等待进程退出后再重试，避免遗留并行传输。

6. 验证与交付

退出码为 0 后，确认输出文件存在且非空。用 Python 标准库检查 ZIP 完整性，并读取主应用信息，例如（替换路径）：

./.venv/bin/python - './exported-app.ipa' <<'PY'
import plistlib
import sys
import zipfile

with zipfile.ZipFile(sys.argv[1]) as archive:
    bad = archive.testzip()
    if bad is not None:
        raise RuntimeError(f'Corrupt ZIP entry: {bad}')
    infos = [name for name in archive.namelist()
             if name.startswith('Payload/') and name.endswith('.app/Info.plist')
             and name.count('/') == 2]
    if len(infos) != 1:
        raise RuntimeError(f'Expected one main app, found {len(infos)}')
    info = plistlib.loads(archive.read(infos[0]))
    executable = infos[0].rsplit('/', 1)[0] + '/' + info['CFBundleExecutable']
    if archive.getinfo(executable).file_size == 0:
        raise RuntimeError('Empty executable')
    print(info.get('CFBundleIdentifier'), executable)
PY

需要确认砸壳结果时，解析主程序 Mach-O 的 LC_ENCRYPTION_INFO / LC_ENCRYPTION_INFO_64，检查 cryptid=0。原本无加密标志的文件不能仅凭此证明发生了解密；严格验证可与设备原文件的加密区域比较。将 ZIP 完整性和解密验证的结论分别说明，不把“命令成功”当作全部验证完成。

交付仓库路径、目标 Bundle ID、IPA 绝对路径、大小和完成的验证。仅安装任务则报告环境和连接验证结果。不要自动重签名或安装导出的 IPA。

常见阻碍

现象 处理
找不到 USB 设备 检查线缆、USB 连接、信任状态及设备 Frida 服务；需要用户确认信任时说明具体操作。
设备锁定或无法启动应用 请用户解锁并手动打开目标应用，保持亮屏后再试。
SSH 认证失败 检查实际账号、别名和密钥；默认 root/alpine 并非所有越狱环境通用。请求缺少的认证信息，不反复猜密码。
缺少 ObjC / bridge 在仓库根目录安装 npm 依赖，确认使用本版本 dump.py 和虚拟环境。
协议或版本不匹配 根据具体报错处理兼容性问题，不自动升级设备端服务。
长时间 0 B 或异常脱离 记录最后日志与进程状态，排查设备锁定、SSH、应用退出及具体错误；处理原因后重试，避免无限重试或默认重启设备。

如果必须修改下载代码，保持 Frida 消息回调只入队，传输在回调之外执行，否则会阻塞 USB 事件循环。修改后运行 ./.venv/bin/python -m unittest discover -s tests -v，再按用户任务验证真机。