 macSubstrate - macOS 的 Substrate

macSubstrate 是一个用于 macOS 上进程间代码注入的平台工具，功能类似于 iOS 上的 Cydia Substrate。使用 macSubstrate，你可以将你的插件（.bundle 或 .framework）注入到 Mac 应用（包括沙盒应用）中，以便在运行时对其进行修改。

• 你只需要获取或为你的目标应用创建插件。

• 无需对原始目标应用进行修改和代码签名。

• 目标应用更新后无需额外操作。

• 安装或卸载插件非常简便。

• 目标应用重新启动时，插件会自动加载。

• 提供 GUI 应用，使注入更加简单。

---

准备工作

• 禁用 SIP

• 为什么要禁用 SIP

  系统完整性保护是一项新的安全策略，适用于每个正在运行的进程，包括特权代码和运行在沙盒之外的代码。该策略对磁盘上和运行时的组件提供了额外的保护，只允许系统安装程序和软件更新修改系统二进制文件。系统二进制文件不再允许代码注入和运行时附加。

---

使用说明

1. 下载 macSubstrate.app，放入 /Applications 并启动它。

   

2. 如果需要，授予授权。

3. 通过导入或拖拽到 macSubstrate 来安装插件。

   

4. 启动目标应用。

   步骤 3 和步骤 4 可以互换

   一旦插件通过 macSubstrate 安装，它将立即生效。但如果你希望它在目标应用重新启动或 macOS 重启后仍然生效，你需要保持 macSubstrate 运行，并允许它在登录时自动启动。

5. 当不再需要插件时卸载它。

   

---

插件

macSubstrate 支持 .bundle 或 .framework 格式的插件，因此你只需要创建一个有效的 .bundle 或 .framework 文件即可。最重要的是在 info.plist 中添加一个键 macSubstratePlugin，其值为字典：

请查看演示插件 demo.bundle 和 demo.framework 了解详情。

Xcode 模板

macSubstrate 还提供了 Xcode 模板 来方便你创建插件：

1. ln -fhs ./macSubstratePluginTemplate ~/Library/Developer/Xcode/Templates/macSubstrate\ Plugin

2. 启动 Xcode，你将看到 2 个新的插件模板。

我的插件

我还制作了一个 微信插件：

• 当你收到 红包 消息时发送通知。

• 当你收到包含自定义关键词的消息时发送通知。

• 防撤回消息并发送通知。

欢迎提交你自己的插件到 Plugins :)

---

安全性

1. SIP 是 macOS 上的一项新安全策略，有助于防止潜在的安全风险。禁用它意味着你将失去 SIP 的保护。
2. 如果你安装了来自开发者的插件，你应该对插件的安全性负责。如果你不信任它，请不要安装。macSubstrate 会帮助验证插件的代码签名，我建议你使用 VirusTotal 扫描它。无论如何，macSubstrate 只是一个工具，由你决定安装什么插件。

---

许可证

macSubstrate 以 MIT 许可证发布。详情请参见 LICENSE。

---

致谢

macSubstrate 的灵感来源于以下项目，并在其帮助下创建：

• Cydia Substrate
• mach_inject