Shadowrocket · Full FAQ

Frequently asked questions,
the long version.

The home-page FAQ only covers the most common items. Here the list is grouped into download & account, subscriptions & nodes, connection & routing, and rules & pricing, so you can search and jump.

Questions18
TopicsDownload · subscriptions · routing · rules & price
How to readTap a title to expand the answer

Note: Answers follow official descriptions and hands-on tests. On-screen copy can change with app versions. This site is not affiliated with official Shadowrocket and does not sell nodes or subscriptions.

01Download & account

Questions about
download and install.

These questions sit before you install: whether your App Store lists the app, what to do if it does not, and whether switching storefronts touches iCloud. Once that is settled you rarely see them again.

Use a listed-region Apple ID in the App Store if your storefront does not carry Shadowrocket
Q1Why can’t I find Shadowrocket in my App Store?+

The app is listed only in some countries. If a search with your everyday Apple ID finds nothing, sign into the App Store (not iCloud) with an Apple ID from a listed region. Full steps: download guide.

Q2If I switch Apple ID region, do I need a credit card or overseas address?+

Often no. If a billing address is required, choose None when you can. You do not need a real overseas address or a second card for that skip path. Buying in a store that already lists the app is simpler.

Q3Can I switch back to my usual Apple ID after download?+

Yes. Switch back anytime. The installed app keeps working. In-app data (nodes, configs) is not lost when you change Apple ID.

Q4Which systems and devices does Shadowrocket support?+

iOS / iPadOS only, iOS 13.0 or later. Android needs another client that speaks the same protocols. The config logic is similar; the UI is not.

Q5Is it safe when first launch asks to add a VPN configuration?+

This is an iOS security prompt. Every proxy app that forwards traffic has to go through it. It does not mean private data is uploaded. Config stays on the device.

02Subscriptions & nodes

Questions about
subscriptions and nodes.

Shadowrocket does not provide nodes. Every node comes from a subscription you add. This section is about using that subscription: empty lists, how many devices, auto-update, and multi-device sync.

A subscription is the node source. Shadowrocket does not provide nodes
Q6Does Shadowrocket itself provide nodes or subscriptions?+

No. Shadowrocket is a client: import, display, test, and connect. The node source (your own server or a paid subscription) is something you bring.

Q7I added a subscription but the node list is empty. Why?+

Saving a subscription only stores the URL. It has not fetched nodes yet. Open that subscription entry and tap Update so the app can request the URL and fill the list.

Q8How many devices can one subscription be used on?+

That limit comes from the subscription you bought (often 3–5 devices), not from Shadowrocket. The same URL can be added on multiple iOS devices.

Q9How do I auto-update a subscription?+

Go to Settings → Subscribe, turn on Update On Open and Auto Update in Background. The latter also needs Settings → General → Background App Refresh allowed for Shadowrocket, or it will not run in the background.

Q10How do I sync nodes and config across devices?+

Turn on Data → iCloud → Auto Sync, and allow Shadowrocket to use iCloud Drive in system iCloud settings. Note: Scenes and Groups are not included in auto sync.

03Connection & routing

Questions about
connection and routing.

"Connected" and "traffic actually went through the proxy" are different. Routing mode and the rules file sit in between. This section is about the concepts that get mixed up there.

Global routing decides how traffic is split
Q11What do Configuration / Proxy / Direct / Scene mean in global routing?+

Configuration splits traffic with the current rules file (recommended day to day). Proxy sends all traffic through the node. Direct sends all traffic without a proxy — a temporary off switch. Scene switches mode and config by the current network (a specific Wi-Fi or cellular); you must set each scene first.

Q12The connect switch is on but the icon keeps blinking. Is it broken?+

No. Usually the current node timed out. Go back to the node list, pick one with a normal delay, and try again.

Q13It says connected, but sites still will not open?+

"Connected" only means the VPN interface came up. It does not mean traffic went through the proxy. Check global routing, the policy for that site in the rules file, and whether Proxy traffic on the Data page is increasing.

Q14Can I proxy or bypass a single app only?+

iOS has no native "proxy this app only" API. Shadowrocket approximates it by matching domains and IP ranges those apps or sites usually hit — it does not see which app made the request. Accuracy depends on the rule set.

04Rules & pricing

Questions about
rules and pricing.

The rules file decides who uses the proxy and who goes direct. The syntax looks unfamiliar; the logic is simple: match top to bottom, stop on the first hit. This section also covers what the app itself actually costs.

Rules match top to bottom; first hit wins
Q15I broke the rules file. How do I restore it?+

On the Config page, tap Restore Default Configuration to go back to the built-in default.conf, then add custom rules on top again.

Q16What do DOMAIN-SUFFIX, GEOIP, and FINAL mean?+

DOMAIN-SUFFIX matches a domain suffix. GEOIP matches the IP’s region (US is the United States; CN is mainland China). FINAL is the fallback when nothing else hit, usually the last line. Rules match top to bottom; first hit wins.

Q17Does Shadowrocket itself cost money?+

The app is a one-time App Store purchase (often about $2.99; the price on the product page wins). No in-app purchase and no app subscription. Nodes or a provider subscription are separate, if you use them.

Q18Why is the delay test inaccurate compared with real use?+

The default delay test can be inaccurate on some networks. In Settings, switch the delay test method to CONNECT, which is closer to a real handshake. Also, if global routing is Configuration, test traffic may be classified as DIRECT and the number will lie. Temporarily switch to Proxy before testing.

Didn't find your question? See the troubleshooting guide or the subscription guide, or go back to the full tutorial.