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

> Easily set up Shadowrocket on iOS for Fanqiang proxy in 2024. Follow this guide to install, configure your subscription, and route all your iOS traffic through secure proxy nodes.

- Repository: [如何翻墙/fanqiang](https://github.com/bannedbook/fanqiang)
- Tags: how-to-guide
- Published: 2026-09-06

---

**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`](https://github.com/bannedbook/fanqiang/blob/main/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

```text
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`](https://github.com/bannedbook/fanqiang/blob/main/ios/Shadowrocket.md) lines 85-95, the guide references importing [`Shadowrocket.conf`](https://github.com/bannedbook/fanqiang/blob/main/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`](https://github.com/bannedbook/fanqiang/blob/main/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.