Shadowrocket iOS Setup Guide 2026: Complete Tutorial for iPhone & iPad
Shadowrocket (commonly called "Little Rocket" among Chinese users) is a rule-based network utility for Apple platforms, developed by Shadow Launch Technology Limited. It supports iPhone, iPad, Mac, and Apple TV, and works with all major proxy protocols including Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard, HTTP, and SOCKS5.
At a one-time purchase price of just $2.99, Shadowrocket is widely considered the best value proxy client on the App Store. Unlike subscription wrappers, it offers rule-based routing, ad blocking, MITM, JavaScript scripting, and per-app proxy control β all in a lightweight mobile interface.
Looking for a reliable, high-speed subscription to use with Shadowrocket? Wraith VPN offers global high-speed nodes, unlimited traffic plans, and anonymous USDT payment β no real-name registration required. View Wraith VPN Packages β
Table of Contents
- What Is Shadowrocket?
- System Requirements
- Step 1: Download Shadowrocket (US Apple ID Required)
- Step 2: Initial Setup & VPN Permission
- Step 3: Import a Subscription
- Step 4: Test Node Latency & Select the Best Node
- Step 5: Configure Routing Rules
- Step 6: Connect
- Troubleshooting Common Issues
- Frequently Asked Questions
- Conclusion: Is Shadowrocket Right for You?
What Is Shadowrocket?
Shadowrocket is not just a subscription importer β it is a full network tool in a small mobile UI. Here is what it offers:
| Feature | Details |
|---|---|
| Price | $2.99 one-time purchase |
| Developer | Shadow Launch Technology Limited |
| Platforms | iPhone, iPad, Mac, Apple TV |
| Protocols | SS, SSR, VMess, VLESS, Trojan, Hysteria2, WireGuard, HTTP, SOCKS5 |
| Key Features | Rule-based routing, MITM, JavaScript scripts, ad blocking, per-app proxy |
| App Store Rating | Approximately 4.8 stars |
Important: Shadowrocket does not provide any server resources. You need to configure your own nodes or import a subscription from a service provider.
System Requirements
| Requirement | Details |
|---|---|
| iOS Version | iOS 12.0 or higher |
| Device | iPhone, iPad, or iPod touch |
| Storage | Approximately 30 MB |
| Apple ID Region | Non-China App Store required |
Step 1: Download Shadowrocket (US Apple ID Required)
Shadowrocket is not available in the China App Store. You need a non-China Apple ID (US, Hong Kong, or Japan) to download it.
Option A: Create a US Apple ID
- Open Settings on your iPhone and tap your Apple ID at the top.
- Sign out of your current account.
- Create a new Apple ID with US (or HK / JP) as the region.
- Log in to that account and redeem an Apple gift card (easiest payment method) or bind PayPal / an international credit card.
- Open the App Store, search for Shadowrocket, and confirm the developer is Shadow Launch Technology Limited.
- Pay the $2.99 purchase price and download the app.
Tip: If you already purchased Shadowrocket once, you do not need to pay again. Just sign back into the same Apple ID and restore it from your purchased apps list.
Option B: Use a Shared US Apple ID
Many subscription providers offer shared US Apple IDs for App Store downloads only. These accounts are intended only for signing in to the App Store to download region-limited apps β never use them for iCloud or personal data.
Official App Store link: https://apps.apple.com/app/shadowrocket/id932747118
Security warning: Never download Shadowrocket IPA files from third-party websites. Unverified packages may contain malicious code that steals your proxy passwords and network traffic. The only safe download channel is the App Store.
Step 2: Initial Setup & VPN Permission
- Open Shadowrocket from your home screen.
- On first launch, iOS will prompt you to add a VPN configuration. Tap Allow.
- Authenticate with Face ID, Touch ID, or your device passcode.
- You will see the main screen with tabs: Home, Config, Data, and Settings.
Step 3: Import a Subscription
Most users should start with a subscription URL for easy updates.
- Open Shadowrocket and tap the + (plus) icon in the top-right corner.
- Under Type, select Subscribe.
- Paste your subscription URL into the URL field.
- Optionally give it a name like "Primary" or "Backup".
- Tap Save in the top-right corner.
- Return to the Home screen and pull down to refresh β your nodes will appear.
Tip: If your subscription uses a Clash format URL, Shadowrocket may not parse it correctly. Use the V2Ray/SS format instead. Need a subscription? Browse Wraith VPN plans β
Alternative: Add a Single Node
If you have a single server URI (ss://, vmess://, vless://, trojan://), copy it and Shadowrocket will detect it automatically.
Step 4: Test Node Latency & Select the Best Node
Before connecting, test which nodes are fastest for your network.
- On the Home screen, tap the three-dot menu or Connectivity Test.
- Shadowrocket will test all nodes and display latency in milliseconds.
- Nodes with green numbers are fast; red means slow or unreachable.
- Tap the node with the lowest latency to select it.
Pro tip: Go to Settings β Latency Test Method and select CONNECT instead of ICMP (Ping). CONNECT gives more accurate proxy performance results.
Shadowrocket also supports one-tap optimization: it batches speed tests, sorts by latency, removes dead nodes, and recommends the fastest route automatically.
Step 5: Configure Routing Rules
Routing rules determine which traffic goes through the proxy and which connects directly. A good rule set keeps domestic services direct while proxying international traffic.
Quick Setup with a Rule Configuration
- Go to the Config tab and tap +.
- Paste a rule configuration URL (see below) and tap Download.
- Tap the downloaded configuration to set it as Active (βοΈ).
- Return to Home and refresh your subscription.
Recommended rule configuration:
https://raw.githubusercontent.com/LingJingMaster/Shadowrocket-Rules/refs/heads/main/Shadowrocket.conf
This configuration includes pre-set rules for Google services (Japan nodes), AI services like ChatGPT (US nodes), YouTube, Telegram, GitHub, banking apps (direct), and domestic Chinese services (direct).
Manual Rule Examples
If you prefer custom rules, go to Settings β Rules and add:
DOMAIN-SUFFIX,google.com,PROXY
DOMAIN-KEYWORD,youtube,PROXY
IP-CIDR,91.108.4.0/22,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
Rule order matters: specific rules first, broad rules later, FINAL at the bottom.
Step 6: Connect
- On the Home screen, select your preferred node.
- Toggle the connection switch at the top to ON.
- iOS will show a VPN icon in the status bar when connected.
- Open Safari and visit any website to confirm the connection works.
To disconnect, simply toggle the switch back to OFF.
Troubleshooting Common Issues
Shadowrocket cannot find any nodes after importing subscription
- Pull down on the Home screen to refresh.
- Check that the subscription URL is correct and accessible.
- Try tapping the subscription name and selecting Update.
"VPN Configuration" error when connecting
This means another VPN app is already active. Disconnect any other VPN and try again. Also verify that you granted VPN permission during first launch.
Slow speeds
- Run a latency test and select the node with the lowest ping.
- Try switching to a different protocol (e.g., from Shadowsocks to Trojan or VLESS).
- Avoid peak hours when free or shared servers are overloaded.
- If you need consistent high-speed access, consider a premium subscription. Browse Wraith VPN plans β
App crashes on launch
- Update Shadowrocket to the latest version from the App Store.
- Restart your iPhone and try again.
- If the problem persists, delete and reinstall the app. Your subscription URLs are saved in your provider's dashboard.
Need more help? Visit our FAQ page β we reply within one hour.
Frequently Asked Questions
Is Shadowrocket free?
No. Shadowrocket costs $2.99 as a one-time purchase on the App Store. There are no recurring fees, and you get lifetime updates.
Do I need a US Apple ID to download Shadowrocket?
Yes. Shadowrocket is not available in the China App Store. You need a US, Hong Kong, or Japan Apple ID to download it.
Can I use Shadowrocket with my Wraith VPN subscription?
Yes. Copy your subscription link from the Wraith VPN dashboard and import it into Shadowrocket using the steps above.
Does Shadowrocket work on Mac?
Yes. Shadowrocket is a universal app that runs on iPhone, iPad, Mac (Apple Silicon), and Apple TV.
What is the difference between Shadowrocket and Quantumult X?
Shadowrocket is simpler and cheaper ($2.99 vs $7.99), with a lower learning curve. Quantumult X offers more advanced automation and scripting capabilities but requires more technical knowledge. For 95% of users, Shadowrocket is the better choice.
Conclusion: Is Shadowrocket Right for You?
Shadowrocket is the most approachable and cost-effective proxy client for iOS. At just $2.99 with lifetime updates, it offers a powerful rule engine, support for all major protocols, and a clean, beginner-friendly interface. Whether you need to access ChatGPT, stream Netflix, or simply browse securely on public Wi-Fi, Shadowrocket delivers.
To get the most out of it, pair Shadowrocket with a reliable, high-speed subscription. Browse Wraith VPN plans β β plans start at just $19/year, with global high-speed nodes, unlimited traffic options, and anonymous USDT payment.
Where to Go Next
Once your iOS setup is stable, the same subscription link usually works on every other device you own.
- Android: the Android VPN tutorial category covers Clash for Android, V2freeGo, and more.
- Desktop: dedicated walkthroughs for Windows, macOS, and Linux.
- Other iOS clients: the iOS help category covers Streisand, Surge, Quantumult X, and more.
- New to all of this? Start with the VPN beginner's guide.
- Full index: the posts page lists every article.