iOS-NOIR README

项目的 README,来自 github.com/arnold117/iOS-NOIR。合并为一个 markdown 文件:README.md。

iOS-NOIR Banner

iOS-NOIR

English · 简体中文

License: MIT Platform: macOS (Tested) No Jailbreak Required

Turn "What is my iPhone silently leaking?" into a reproducible, evidence-graded forensic report — without jailbreaking.
把「这台未越狱的 iPhone 到底在暗中泄露什么」变成一份带三级证据标注的可复现底层取证报告。

📊 Sample Standalone Interactive Report (7-Tab HTML, synthetic data): report/ios-noir-sample-report.html (fictional com.example.* apps; download & open in any browser)

💡 Acknowledgements / 致敬


⚖️ Three-Tier Evidence Grading (证据分级标准)

Following the forensic rigor of RootSir/claude-ios-privacy-analysis, iOS-NOIR explicitly distinguishes between static configuration evidence, kernel capability entitlements, and behavioral inference:


🔍 Core Findings & The 5-Layer Persistent Identity Chain

Why does turning off Allow Apps to Request to Track (IDFA), connecting to a VPN, and reinstalling an app still fail to prevent cross-app device tracking on stock iOS? iOS-NOIR audits 10+ blind spots and maps the 5-Layer Persistent Device Identity Chain:

🧬 5-Layer Persistent Identity & VPN-Bypass Chain

  1. Layer 1 — Uninstall- & New-iPhone-Proof iCloud KVS (ubiquity-kvstore-identifier) 【实锤】: Writes tracking tokens into your private iCloud key-value store that automatically restore even after app uninstallation or migrating to a brand-new iPhone.
  2. Layer 2 — Uninstall-Proof Shared Keychain (keychain-access-groups) 【实锤】: iOS Keychain items persist across app uninstalls and are shared across apps signed by the same developer Team ID.
  3. Layer 3 — Cross-App Collusion Pools (com.apple.security.application-groups) 【实锤】: Shared local storage containers (group.*) survive uninstallation as long as any single sister app from the same corporate family remains installed.
  4. Layer 4 — Hardcoded Carrier Phone-Number Gateways (cmpassport.com, wostore.cn, id6.me, 189.cn) 【实锤】: Apps that hardcode carrier one-tap-login gateways in their ATS configuration. This kind of authentication runs over cellular data, even while you're on Wi-Fi, so the carrier can identify your phone number (MDN) straight from the SIM.
  5. Layer 5 — GPS-Free Physical BSSID Hooks (HotspotHelper + its network-authentication background mode, & multicast) 【机制实锤】: System-level hooks that wake food-delivery/payment apps whenever iOS scans Wi-Fi networks, feeding them nearby router MAC addresses (BSSID).

🚨 Additional Hidden Backdoors Exposed

📝 Updates (2026-11-06)


🚀 Quick Start / 快速上手

⚠️ Platform Note: Currently tested and verified on macOS (where Apple's usbmuxd runs natively). Windows and Linux have not been tested yet (and may require additional iTunes / usbmuxd driver setup).

1. Install Dependencies

git clone https://github.com/arnold117/iOS-NOIR.git
cd iOS-NOIR
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Connect Your iPhone via USB

Plug in your iPhone, unlock the screen, and tap "Trust This Computer".

3. Run Full Audit (Terminal + Standalone 6-Tab HTML Report)

# Run full audit (outputs JSON, domains, and interactive bilingual HTML report to noir-out/)
python ios_noir.py scan

# Run in English terminal mode + redacted mode for safe sharing on X/Twitter/HN
python ios_noir.py scan --lang en --redact

# Open the generated interactive HTML report (includes top-right 🇨🇳 中文 / 🇺🇸 English switch)
open noir-out/ios-noir-report.html

4. Run Live Privacy Radar (Real-Time TCC / Sensor / IDFA Sniffer)

# Monitor real-time permission preflights, camera/mic probes, and IDFA requests for 30s
python ios_noir.py radar --duration 30

🛡️ Built-In Countermeasures (shields/)

  1. VPN-Free Kernel Encrypted DNS Shield (shields/iOS-NOIR-System-Shield.mobileconfig)
    Uses Apple's native com.apple.dnsSettings.managed payload. AirDrop it to your iPhone to block trackers and encrypt DNS over HTTPS at the OS kernel level 24/7 without keeping a VPN connected or draining battery. Automatically yields when you turn on Shadowrocket/Clash and resumes the moment VPN disconnects.
  2. 1-Click Shadowrocket / Surge Overlay Module (shields/ios_noir_shield.module & shields/ios_noir_shield.conf)
    Non-destructive overlay module for Shadowrocket / Surge / Loon / Clash (won't overwrite your main proxy config). Import directly in Shadowrocket (Config -> Modules -> +) via URL:
    https://raw.githubusercontent.com/arnold117/iOS-NOIR/main/shields/ios_noir_shield.module
    
    Blocks carrier silent-auth gateways (cmpassport.com, wostore.cn, id6.me), cross-app DNA fingerprinting (shuzilm.cn), hot-patch backdoors (jspatch.com), behavioral biometrics (online-metrix.net), and major ad-tech telemetry.

🔬 Methodology & Limitations (方法论与局限性声明)

  1. FairPlay DRM Boundary on Stock iOS: Binaries on non-jailbroken iPhones are FairPlay-encrypted. iOS-NOIR performs whole-device entitlement/plist/sandbox/syslog forensics without decrypting IPA Mach-O code sections. For function-level Ghidra decompilation of decrypted IPAs, combine iOS-NOIR with RootSir/claude-ios-privacy-analysis.
  2. Capability (【机制实锤】) ≠ Continuous Runtime Trigger (【实锤】): Holding an Apple-signed entitlement proves the kernel capability is unlocked, whereas actual trigger frequency is governed by server-side policies.
  3. Static ATS Domains ≠ Active Packet Capture: Domains listed in NSExceptionDomains are developer-declared exceptions in Info.plist; some may be legacy or conditional endpoints.

📜 Credits & License

iOS-NOIR (arnold117/iOS-NOIR)

正在搜索数据库…

这是什么?一款无需越狱的 iPhone 取证审计工具。它通过 USB 读取权限声明、Info.plist、沙盒和 syslog 数据,生成报告,列出哪些应用可能在泄露信息,并按证据强度为每项发现评级。
它是我要装到手机上的应用,还是别的东西?两者都不完全是。它是一个 Python 命令行工具,在电脑上运行,通过 USB 与 iPhone 通信,因此无需越狱。
我该怎样让它运行起来?安装 Quick Start 部分中的依赖,连接已解锁的 iPhone,在手机上点击「信任此电脑」,然后运行完整审计,即可获得终端摘要和独立的 HTML 报告。
除了 iPhone,我还需要什么?一台装有 Python 的 Mac 和一根 USB 线。该工具基于 pymobiledevice3 访问设备,并使用 rich 输出终端内容。
它会反编译应用代码来显示应用的功能吗?不会。App Store 上的应用都经过 FairPlay 加密,因此它只审计权限声明、plist 文件、沙盒和 syslog,不反编译代码。如需函数级分析,README 建议搭配 RootSir 的 claude-ios-privacy-analysis 使用。
它在 Windows 或 Linux 上也能用吗?尚未验证。目前只在 macOS 上测试过,那里 Apple 的 usbmuxd 可以原生运行。Windows 和 Linux 可能需要额外安装 iTunes 或 usbmuxd 驱动。
5 层持久身份链是什么?README 列出了五层机制,即使在未越狱的原版 iOS 上,应用也可能借此在重新安装和使用 VPN 后持续追踪你。这些层包括 iCloud 键值存储、共享钥匙串、App Group 容器、运营商手机号网关和 Wi-Fi BSSID 钩子。
它能从 iOS 崩溃日志中了解到什么?它解析内核 .ips 日志,找出超过 24 小时磁盘写入上限的应用,并按超出幅度排序。它还会标记与 CPU 相关的强制终止,以及内嵌的二进制 SDK,且全程无需越狱。
它能发现应用在探测我的 VPN 或加密钱包吗?能。它能发现应用在 LSApplicationQueriesSchemes 中硬编码了 280 多个 URL Scheme,用来检查 VPN 客户端、加密钱包或车载应用是否已安装。
它自带屏蔽追踪器的功能吗?有。shields 文件夹中有一个 .mobileconfig 文件,可在系统层面设置加密 DNS;另有一个 Shadowrocket/Surge 覆盖模块,用于屏蔽运营商静默认证网关、DNA 指纹识别和广告技术域名。
作者
arnold117
大小
4 MB
星标
323
更新
提交Nov 06
时长
12天
提交 · 90 天