Before you begin: app, account, and subscription link
Shadowrocket can use compatible proxy configurations on iPhone and iPad, but installing the app is only the first part of setup. You also need an active service account and a subscription URL that provides configuration the app understands. The URL is not a normal website address: it may contain credentials that allow access to your routes, so treat it like a password.
First, check whether Shadowrocket is available to download in the App Store region associated with your Apple Account. App availability and purchase requirements can vary by region and may change. Use the official App Store listing, and avoid installing configuration tools from unknown download sites. If you already have Shadowrocket, update it through the App Store when an update is available.
Next, sign in to your VPN provider’s account page and find the subscription or configuration section. Copy the subscription URL using the provider’s copy control when possible. A user name and password for the account are not necessarily the same thing as a subscription URL; do not paste account credentials into the URL field unless the provider specifically instructs you to do so.
Keep the link private. Anyone who obtains an active subscription URL may be able to retrieve configuration or use account resources, depending on how the service handles access. Do not post it in screenshots, public support threads, or online conversion tools. If you need help, provide the client name and a description of the error, and hide the full URL, QR code, and account details.
90+
Countries covered
230+
Routes listed
iOS
Supported platform
Unlimited
Concurrent devices
Add the subscription URL in Shadowrocket
Open Shadowrocket and look for the add control, commonly shown as a plus sign near the top of the main screen. The exact position and wording can differ between app versions. In the add menu, choose the option for a subscription or remote configuration rather than manually entering an individual server. A subscription entry is designed to retrieve and refresh a group of configurations from the provider’s URL.
Paste the copied URL into the URL field. If the app offers a remarks, name, or label field, enter a short description that helps you recognize the subscription later, such as the provider name or the device it is for. The label is for your own reference and does not change the route settings. Avoid adding the full secret URL to the label, since labels may appear in screenshots or backups.
Save the entry, then return to the main list. Shadowrocket should request the configuration and display the available server or route entries if the link is valid and the response is compatible. The first retrieval requires an internet connection. If the list remains empty, do not repeatedly add the same URL as separate entries; check the existing entry and its refresh status first.
When you are looking for the official client and service starting point, China VPN Download provides the site’s main navigation. Return to the provider’s account page for the subscription URL itself, because a general download or homepage address cannot replace a personal configuration link.
Use the refresh control associated with the subscription entry when you need to retrieve an updated server list. Depending on the app version, this may be available from the entry’s detail view, a menu, or a refresh gesture. Wait for the operation to finish before troubleshooting. A successful refresh means the app received configuration; it does not by itself mean a route is connected or that traffic is passing through it.
- ✅ Paste the complete URL, including its scheme and any required path or query text.
- ✅ Use the subscription or remote-configuration option, not a manual server form.
- ✅ Save one clearly named entry and refresh it after adding it.
- ❌ Do not share the URL, turn it into a public QR code, or send it to an unknown conversion website.
- ❌ Do not assume that an empty list means the iPhone itself has a VPN connection problem; the link or its format may be the issue.
Choose a route and connect on iPhone or iPad
After a successful update, review the routes Shadowrocket lists. Names may indicate a country, region, protocol, or service purpose, but a name is not a performance guarantee. Select a route that suits the app or website you intend to use, and begin with a single candidate so you can tell which configuration is active. If the provider groups routes by region or label, use those descriptions as a starting point rather than assuming that the geographically closest option will always work best.
Tap the route you want to use, then use Shadowrocket’s main connection control. The first time the app creates a VPN configuration, iOS may show a system permission prompt asking to add VPN configurations. Review the prompt and approve it only if you initiated the connection in the app and trust the software and service. iOS may request your device passcode or authentication to authorize the system configuration. This is a system permission step, not a request to disclose your passcode to the provider.
Once connected, check Shadowrocket’s connection state and the iOS status indicators available on your device. An iOS VPN indicator shows that a VPN configuration is active at the system level; it does not prove that every app is using the route you selected, that a particular website is reachable, or that the subscription remains current. Open the app or site you actually need and verify its behavior separately.
Routing mode matters. A rule-based mode may send only traffic matching configured rules through a proxy while other traffic connects directly. A global mode generally attempts to route a broader range of traffic through the selected proxy, subject to the app’s configuration and system behavior. The precise modes and labels can vary by version and configuration. Start with the provider’s guidance, and avoid changing several routing, DNS, and rule settings at once; otherwise it becomes difficult to identify which change affected the result.
For a simple first test, connect to one route and visit a trusted IP or DNS checking service, then open the app or website you care about. Compare the displayed network location where relevant, while remembering that location databases can be outdated or approximate. If the checking page changes but the target service still fails, the issue may involve that service’s account, content availability, app settings, or route-specific restrictions rather than a failure to import the subscription.
| What you see | What it usually tells you | What to check next |
|---|---|---|
| Subscription entry exists, but no routes appear | The entry was saved, but configuration may not have been retrieved or parsed. | Check the URL, account status, network access, and refresh result. |
| Routes appear, but connection fails | The app received configuration, but the selected route may not be reachable or compatible in the current network. | Try another listed route and review the app’s error details. |
| The app reports connected, but a target does not load | A connection state alone does not confirm that the target app’s traffic uses the route. | Check routing mode, rules, DNS behavior, and the target service’s own restrictions. |
| Some apps work and others do not | Traffic may be handled differently by rules, app behavior, or destination-side controls. | Test with the intended app and review relevant routing rules before changing unrelated settings. |
Troubleshoot, refresh, and protect your setup
If Shadowrocket cannot retrieve the subscription, start with the simplest checks. Confirm that the iPhone or iPad has internet access without relying on the route you are trying to add. Reopen the provider’s account page and copy the URL again, taking care not to include spaces or omit any characters. Check that the subscription is active and that you copied the subscription URL rather than a login page address, a single-server share link, or an account password.
Then inspect the app’s displayed error, if one is available. A network timeout can point to temporary connectivity trouble; an authorization or response error can indicate an inactive subscription, an incorrect URL, or a format the app cannot parse. Error wording differs across versions, so use the message as a clue rather than a definitive diagnosis. If the provider offers a client-specific import guide, follow its instructions for Shadowrocket instead of selecting protocol fields by guesswork.
If routes are listed but none connect, check whether the selected route is still present after a refresh, confirm that the device has a working internet connection, and try another route supplied in the same subscription. Also make sure another VPN or proxy app is not simultaneously controlling the iOS network configuration. Multiple network tools can conflict, and switching between them without disconnecting can make the symptoms confusing. Disconnect the current session before testing another client or route.
If the connection appears active but a particular app behaves as if no proxy is present, review the routing mode and rules. Some configurations intentionally bypass local or selected traffic. Check whether the destination app has its own proxy, private relay, DNS, or content-region settings that could affect the test. Change one setting at a time, note the original value, and restore it if the result becomes worse. Do not import rule sets or configuration files from unknown sources to “fix” a problem; they may redirect traffic or expose information.
Refresh the subscription when the provider says configuration has changed or when the current route list appears outdated. A refresh retrieves updated configuration but does not necessarily disconnect and reconnect the active session automatically. After updating, check which route is selected and reconnect if necessary. If the subscription URL has been exposed, ask the provider whether it can be renewed or revoked, and replace the saved entry with the new URL rather than continuing to use a compromised link.
When asking support for help, describe the iOS version, Shadowrocket version, whether the subscription entry was added, whether routes appear, the selected route label, and the exact non-sensitive error text. Do not include a complete subscription URL, password, QR code, or unredacted account screenshot. This information usually helps distinguish a retrieval problem from a route or traffic-handling problem without revealing the credentials that protect the subscription.
- ✅ Refresh the saved subscription entry when configuration changes or the route list needs updating.
- ✅ Disconnect one network client before testing another to avoid conflicting VPN configurations.
- ✅ Test both the connection state and the specific app or website you need to use.
- ✅ Keep the subscription URL private and redact it from diagnostic screenshots.
- ❌ Do not assume that an iOS VPN indicator guarantees that every app’s traffic follows the selected route.
- ❌ Do not change several DNS, routing, and protocol settings simultaneously when troubleshooting.