Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

Rule sets and client modules that route Apple Intelligence, PCC, and Chinese Siri traffic without HTTPS decryption.

103
7
Python
MIT
4 days old

What it does

AppleFlow is a rule-set and module collection for proxy clients such as Surge, Loon, Shadowrocket, Stash, Mihomo/Clash Meta, Sing-box and Quantumult X. It routes Apple service traffic so that Chinese Mandarin Siri stays on a direct connection, while Apple Intelligence features, Private Cloud Compute (PCC) endpoints and third-party AI extensions go to a US node. The approach avoids HTTPS decryption entirely: no MitM, no scripts, no certificate rewrites (project README).

The README argues that older Apple split tutorials break on iOS/macOS 26–27 for three reasons: certificate pinning on location and Siri endpoints, Chinese Siri being misrouted through overseas nodes or Fake-IP, and generic Apple_All rules catching PCC domains before the dedicated rules do. The project addresses these with separated rule sets for Siri direct, PCC/cleanup, and AI extensions.

Quick start

  1. Prepare a compatible proxy client on an iPhone, iPad or Mac running iOS/iPadOS/macOS 26–27 (foreign-region device, or an unlocked China-region device).
  2. Open the online workbench to trigger client installation, detect configuration conflicts, and check the actual egress region.
  3. Add the module for your client. For Surge 5/6, use the full Surge module or the slimmer core module; other clients have their own files, e.g. the Mihomo override template.
  4. For manual rule setups, place the rule sets before Apple_All / GEOSITE,apple / GEOIP,CN. The Siri direct list is available for Surge; PCC and AI-extension lists have per-client variants such as Surge PCC and Surge AI extensions.
  5. Add guzzoni.apple.com, *.guzzoni.apple.com and *.siri.apple.com to Surge's always-real-ip, or to Mihomo/Clash's dns.fake-ip-filter.
  6. Select a low-latency US node that forwards UDP/QUIC, then refresh external resources in the proxy client.

For the full “golden coexistence” flow (device eligibility, language/region settings, dual-region Apple accounts, module cleanup), see the four-step section in the README.

Constraints

  • Chinese Siri routing relies on DNS handling: without the Real-IP / Fake-IP exclusions, Siri may fail with the generic “something went wrong” message.
  • PCC and photo cleanup need UDP 443 (QUIC) forwarding; a node with QUIC-BLOCK will break the handshake and surface PrivateCloudComputeError Code=32033.
  • The recommended region is Taiwan for language/region settings — setting the region to the US loses Mandarin incoming-call screening, and staying in mainland China blocks Visual Intelligence and AI translation.
  • China-region (CH/A) devices are only supported on iOS 27.0–27.2.1 via the separate Erosion-CN tool; iOS 27.3 beta 1 adds a local hardware/region check that blocks the flow.
  • Existing MitM rewrite modules for gspe1-ssl.ls.apple.com or *.smoot.apple.com must be disabled to avoid breaking regional access and Spotlight.
  • Licensed under MIT (license).

HotRepo's take

AppleFlow entered HotRepo's new-project list on 2026-11-17 with 103 stars and 7 forks, adding 3 stars in the roughly one-hour growth window captured that day. The collection is small and very recent, so these numbers say little about adoption; what stands out is the project's split into three cooperating tools — Erosion-CN for device eligibility, AppleFlow for routing, and AppleLens for observation — which gives the rule sets a concrete diagnostic path rather than a standalone config dump. The README's emphasis on certificate pinning, Fake-IP and QUIC forwarding matches problems that show up in real Apple-service proxy setups, making the rule sets useful even to users who only want the Siri-direct list.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. mihomo-party-org/clash-partyAn Electron GUI for the Mihomo proxy core, aimed at users who manage Clash subscriptions and rules on desktop.TypeScript27,136
  2. clash-verge-rev/clash-verge-revA cross-platform desktop GUI for the mihomo/Clash proxy core, aimed at users who manage their own proxy subscriptions and rules.Rust153,585
  3. vernesong/OpenClashRuns and manages a Mihomo proxy client on OpenWrt routers with rule-based transparent routing.JavaScript28,018
  4. throneproj/ThroneA cross-platform Qt desktop proxy client built on sing-box for managing profiles, subscriptions, and traffic routing.C++7,789
  5. idy/tailsplitRoute selected traffic through a Tailscale exit node while keeping other traffic direct, using sing-box rules.Go108