---

name: re-frida-script-author type: atomic description: > Frida 脚本生成方法论：目标特征 → 模板选择 → 改写 → 验证。独立于执行插桩（re-frida）。 触发词：生成Frida脚本、写hook脚本、frida脚本怎么写、写个hook、脚本生成。 capabilities: [frida-instrumentation]

Frida 脚本生成

何时使用 / 何时不用

• 用：需要新脚本时——拦截（加密/网络/文件）、绕过（检测/固定）、追踪（JNI/方法调用）
• 用：现成模板没有的变体——按 [[re-frida/frida-scripts]] 模板改写出目标专用脚本
• 不用：执行现成脚本 → 转 [[re-frida]]（本技能只产出脚本，运行与进程管理在 re-frida）
• 不用：反检测对抗面整体分析 → [[re-analyze/anti-dynamic-workflow]]
• 不用：纯静态可解的问题——先走 [[re-apk]] / [[re-ghidra]] 静态路径，动态是最后手段
• 不用：目标不可达（无设备/无 root/无越狱、加固拦注入）——先解决环境（[[re-frida]] 工具准备），不硬写脚本

工具准备

frida-tools（脚本编写与运行验证）

• 推荐（upstream 路径）: python -m pip install -U frida-tools，建议用 venv 或 pipx 隔离环境
• 第三方渠道: brew install frida 等非 upstream 渠道，安装前核验版本与维护状态，不与 pip 路径等同看待
• 验证: frida --version、frida-ps -U（连设备后）
• 注意: frida（运行时）与 frida-tools（CLI）版本需配套；跨大版本升级（16 → 17）有 API 移除，写法差异见 [[gotchas]] 版本组

python3（配合脚本调试）

• 各平台同 [[re-python]] 工具准备

反编译辅助（侦察用）

• jadx（[[re-apk]]）静态出类/方法清单；Ghidra/IDA（[[re-ghidra]] / [[re-ida]]）native 侧符号与调用点定位
• 验证: 能按包名列出目标类与方法签名

目标设备/模拟器

• Android 真机/模拟器 + frida-server（至少与主机 frida 同 major，安装见 [[re-frida]] 工具准备）；桌面目标直接本机
• iOS 越狱环境 frida-server 见 [[re-ios-jb]]

操作步骤

按「探 → 选 → 改 → 验」四步，先探后写，不猜。每步产物（特征清单/脚本/验证输出）记录路径 + sha256（见 [[re-triage]]），供报告引用。

1. 目标侦察：

   • 静态：目标包名/类名/关键 API（[[re-apk]] jadx 输出）、加固商特征（[[re-mobile-pack]]）、Flutter/RN 混合结构（[[re-hybrid-app]]）
   • 动态基线：原样跑一次抓崩溃与日志（崩溃特征 → 保护机制对照，见 [[re-analyze/anti-dynamic-workflow]]）
   • 产出：目标特征清单——检测点/目标 API 全限定名/输入输出形态/方法 overload 数
   • 不确定的类名/方法名先小脚本枚举（Java.enumerateLoadedClasses / Java.use(...).overloads），不猜名字
   • 侦察结论记入 [[re-analyze/analysis-contract]] 契约字段（包名/类名/API 清单），供脚本与报告复用

2. 模板选择：按特征清单对照 [[re-frida/frida-scripts]] 模板表：

目标特征	模板
HTTPS 抓包被 TLS 加密（BoringSSL）	TLS 密钥日志（SSLKEYLOGFILE）
证书固定挡抓包	SSL 固定绕过（TrustManager/CertificatePinner）
加密算法/密钥要提取	加密拦截（Cipher/SecretKeySpec 全 overload）
加固/运行时解密	DEX dump（类加载点）/ SO dump
双向 TLS 客户端证书	keystore p12 导出
JNI 动态注册要还原	RegisterNatives + 汇聚点双 hook
反调试/检测拦截	检测绕过表（root/属性/文件/命令）

• 特征不匹配任何模板 → 组合改写（多个模板拼装）而非从零写
• 选完模板先读模板内已知边界注释（[[re-frida/frida-scripts]]），避免重复踩坑

3. 改写：

   • 替换占位符：包名/类名/方法名（精确匹配，Java 全限定名）
   • overload 精确匹配：先 overloads 枚举再逐个定义或按参数类型选（见坑 1）
   • 结构规范：Java 操作包在 Java.perform；保存 original 引用、带原 this 调用；Interceptor.attach 里 onEnter 用 this.context 读寄存器，改返回值只能在 onLeave 用参数 retval.replace(...)——this 上只有 returnAddress/context/errno/lastError/threadId/depth，没有 this.returnValue；且 retval 跨调用复用，需留存时先 ptr(retval.toString()) 复制
   • 输出统一 JSON（可打印 ASCII + hex 双格式）经 send() 传出；每个 hook 主体 try/catch，错误发消息不静默
   • 同一类多 hook 合并进一个 .implementation（缓存静默覆盖，见坑 2）
   • 骨架参考（Java + native 双面最小结构，按目标裁剪）：

     Java.perform(function () {
       var Cls = Java.use("com.target.Cls");
       Cls.method.overload("java.lang.String").implementation = function (s) {
         try { send({ type: "call", arg: s ? s.toString() : null }); }
         catch (e) { send({ type: "error", msg: String(e) }); }
         return this.method(s);          // 调原实现（保留原 this）
       };
     });
     Interceptor.attach(
       Process.getModuleByName("libtarget.so").getExportByName("func"),
       { onEnter: function (args) { send({ type: "native", arg0: args[0].toInt32() }); } }
     );
     

   • native 侧：导出符号优先（Process.getModuleByName(...).getExportByName；旧写法 Module.getExportByName 见 [[gotchas]] 版本组）；非导出函数用调用点 hook 或内存特征定位

4. 验证：

   frida -U -f <pkg> -l script.js --pause   # spawn + 停在早期代码前
   frida -U -f <pkg> -l script.js -o out.json  # 输出存文件（大流量/批量时）
   

   • 验证清单：hook 挂载成功（无报错输出）→ 触发目标路径（操作 app 或复现调用）→ 输出与静态分析一致 → 重复触发输出稳定
   • 输出 JSON 可解析、目标行为符合预期（拦截到目标调用/绕过生效）
   • 失败 → 回步骤 2 重选模板或细化特征；崩溃 → 按 [[re-analyze/anti-dynamic-workflow]] 崩溃对照表定位；输出为空 → 见 [[decision-tree]] 排查分支

跨域联合

• [[re-frida]]：脚本执行（本技能产出 → re-frida 运行）
• [[re-mobile]] / [[re-android-native]]：移动目标场景衔接
• [[re-analyze/anti-dynamic-workflow]]：检测面与崩溃迭代法
• [[re-frida/frida-scripts]]：模板素材库（re-frida references）
• [[re-analyze/analysis-contract]]：脚本输出按数据契约消费（证据存档）
• [[re-ios-jb]]：iOS 越狱环境执行侧

常见坑与陷阱

• overload 不匹配静默失效：现象——hook 无输出；原因——目标方法 overload 签名与定义不符；对策——先 Java.use(...).<method>.overloads 列出全部重载再选
• Java.use 缓存覆盖：现象——多个 hook 只生效最后一个；原因——同类多次 .implementation 赋值静默覆盖；对策——合并进一个 hook
• 参数索引版本相关：现象——native 参数读错；原因——目标版本字段/参数位次变化；对策——对照目标符号核实，不照搬经验值
• 不侦察就写脚本：现象——脚本对不上目标；原因——跳过步骤 1；对策——先探后写
• 绕过类脚本只观察不持久化：现象——测试后目标状态被改；原因——脚本含写操作；对策——脚本只做读取/日志，绕过仅用于观察（红线）
• 类未加载时 hook 不生效：现象——类存在但无输出；原因——懒加载/加固延迟加载；对策——Java.choose 或对类加载点下 hook（[[re-analyze/anti-dynamic-workflow]]）
• 版本相关 API 报错：现象——Module.getExportByName is not a function；原因——Frida 17 移除静态 Module 查找 API；对策——按 [[gotchas]] 版本组迁移写法
• 模板选择分支与验证排查树见 [[decision-tree]]；版本差异与边界见 [[gotchas]]；全部在沙箱内执行（[[re-analyze/platform-tips]] 最高原则），脚本输出按 [[re-analyze/analysis-contract]] 契约存档