Kianuni/AppleFlow
Networking & CommunicationRule sets and client modules that route Apple Intelligence, PCC, and Chinese Siri traffic without HTTPS decryption.
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
- 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).
- Open the online workbench to trigger client installation, detect configuration conflicts, and check the actual egress region.
- 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.
- 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. - Add
guzzoni.apple.com,*.guzzoni.apple.comand*.siri.apple.comto Surge'salways-real-ip, or to Mihomo/Clash'sdns.fake-ip-filter. - 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-BLOCKwill break the handshake and surfacePrivateCloudComputeError 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.comor*.smoot.apple.commust 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
- mihomo-party-org/clash-partyAn Electron GUI for the Mihomo proxy core, aimed at users who manage Clash subscriptions and rules on desktop.
- 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.
- vernesong/OpenClashRuns and manages a Mihomo proxy client on OpenWrt routers with rule-based transparent routing.
- throneproj/ThroneA cross-platform Qt desktop proxy client built on sing-box for managing profiles, subscriptions, and traffic routing.
- idy/tailsplitRoute selected traffic through a Tailscale exit node while keeping other traffic direct, using sing-box rules.