How to Set Up Shadowrocket on iOS: Complete 2024 Guide for Fanqiang Proxy

Install Shadowrocket from the US App Store, enable "Open when updating" in Server Subscription settings, and paste your V2Ray or SS subscription URL to route iOS traffic through Fanqiang nodes.

Setting up Shadowrocket (小火箭) on iPhone or iPad requires navigating regional App Store restrictions and understanding how subscription-based proxy configuration works. The bannedbook/fanqiang repository provides a self-contained, step-by-step guide in ios/Shadowrocket.md that covers installation, node import, and advanced traffic-splitting rules. This article distills those instructions into a practical workflow you can follow today.

Installing Shadowrocket on iOS

Shadowrocket was removed from the China mainland App Store, so you must use an international Apple ID to purchase and download it (lines 7-9 of the guide).

Purchase Options

• US App Store: Switch your Apple ID region or create a new US account
• Gift card method: Purchase a US App Store gift card to fund the ~$2.99 app price
• Family sharing: Have someone with a US account purchase and share the app

Once installed, keep the app updated through the same international Apple ID to maintain access to new proxy protocols and security patches.

Configuring Server Subscriptions in Shadowrocket

The subscription method is the fastest way to import multiple nodes. According to the fanqiang source code, this workflow automates node fetching without manual URL entry for each server.

Step-by-Step Subscription Setup

1. Open Shadowrocket → Settings → Server Subscription
2. Toggle "Open when updating" to ON
3. Tap + → Type → Subscribe
4. Paste your subscription URL (e.g., from the V2ray airport entry in the fanqiang guide)
5. Tap Save — Shadowrocket automatically parses and imports all nodes

Settings → Server Subscription → + → Subscribe

Manual URL Method

For individual nodes, simply tap a V2Ray or Shadowsocks URL from Safari or copy it to your clipboard. Shadowrocket detects the protocol and prompts you to add the configuration directly.

Advanced: Importing Remote Rule Files

Power users can enable traffic-splitting by importing a remote configuration file. This routes domestic Chinese sites through direct connection while proxying blocked services — improving speed and reducing node load.

In ios/Shadowrocket.md lines 85-95, the guide references importing Shadowrocket.conf:

1. Go to Settings → Configuration → + → Remote File
2. Enter URL: https://raw.githubusercontent.com/Hackl0us/Surge-Rule-Snippets/master/LAZY_RULES/Shadowrocket.conf
3. Tap Download
4. Select "Use Configuration"

This rule-based approach replaces global VPN mode with intelligent routing based on domain and IP categories.

Testing and Activating Your Proxy

After node import or subscription update:

1. Return to the Home tab
2. Tap Connectivity Test to measure latency across all nodes
3. Select the fastest server (green checkmark)
4. Toggle the top switch to enable VPN

The iOS status bar will show "VPN" when active.

Troubleshooting Common Connection Issues

The fanqiang guide documents specific recovery steps for iOS connectivity problems (lines 22-24):

Symptom	Solution
App shows "connection failed"	Go to iOS Settings → VPN, toggle off then on
Persistent disconnections	Restart iPhone and retry Shadowrocket activation
Subscription won't update	Verify URL is accessible in Safari; check for extra spaces
Slow speeds on all nodes	Run Connectivity Test and switch to lowest-latency server

If Shadowrocket crashes after iOS updates, reinstall from the same international Apple ID used for original purchase.

Protocol Support and Node Compatibility

Shadowrocket on iOS supports the full protocol stack referenced in the fanqiang repository:

• Shadowsocks (SS): Legacy but widely available nodes
• ShadowsocksR (SSR): Enhanced obfuscation variant
• VMess: V2Ray protocol with advanced traffic masking

The ss_v2ray.md file in the repository confirms Shadowrocket as a recommended iOS client for these protocols. Node subscription URLs typically encode protocol type, server address, port, UUID, and obfuscation settings — all parsed automatically by Shadowrocket's subscription engine.

Summary

• Installation requires US/international Apple ID — Shadowrocket is unavailable in China App Store
• Server Subscription with "Open when updating" enables automatic node synchronization
• Remote rule files (.conf) unlock split-tunneling for optimal performance
• Connectivity Test identifies fastest nodes before activation
• iOS VPN toggle restart resolves most connection failures without app reconfiguration

Frequently Asked Questions

Why can't I find Shadowrocket in my App Store?

Shadowrocket was removed from the China mainland App Store. You need a US or other international Apple ID to purchase it. The fanqiang guide in iphone翻墙.md includes Apple ID creation tips for iOS users.

What's the difference between subscription URL and manual node entry?

Subscription URLs contain multiple encoded nodes that Shadowrocket refreshes automatically. Manual entry adds single nodes one at a time. Subscriptions are preferred for staying current with server changes.

Does Shadowrocket work on iPad and M-series Macs?

Yes. Shadowrocket is a universal iOS app that runs on iPad natively and on Apple Silicon Macs through macOS compatibility mode, though Mac-specific alternatives like Clash Verge are often preferred on desktop.

Is Shadowrocket safe to use for bypassing firewalls?

Shadowrocket itself is a standard VPN/proxy client listed on Apple's official App Store. Security depends on your node provider's trustworthiness. The fanqiang repository curates public nodes; evaluate each source's privacy policy before routing sensitive traffic.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}