Before you begin: prepare the app and subscription
Setting up Shadowrocket on an iPhone involves three separate tasks: obtaining the app, importing a subscription, and choosing a route to connect through. Keeping those steps distinct makes troubleshooting much easier. An imported subscription can appear in the app even when the selected server is unavailable, and an iPhone can show a VPN connection indicator even when a particular website or app still cannot reach its destination. Treat import, connection, and verification as separate checks rather than assuming that completing one proves the others.
First, confirm that Shadowrocket is available to you through the App Store for your Apple Account region. App availability and app features can change, so check the current App Store listing and the app’s own instructions. Install the official app from the store; avoid unofficial installation files or profiles from unfamiliar sources. If you already have a compatible client installed, you can use it instead, but this guide describes the Shadowrocket workflow.
You will also need a valid subscription URL from your VPN provider. This is a private configuration link, not a normal web address intended for sharing. Copy it from the provider’s account page or setup instructions, and do not post it in a public chat, screenshot, issue report, or support forum. Anyone who obtains a working subscription URL may be able to use or alter access associated with it, depending on the provider’s setup.
Before importing, check whether your subscription is intended for Shadowrocket and whether the service supports the configuration formats it contains. Shadowrocket’s available options can depend on the app version and the subscription itself. A provider may offer configurations using protocols such as Shadowsocks, VMess, or Trojan, but seeing a protocol name in a guide does not mean every profile or client version supports it. Use the provider’s current iOS instructions when they differ from general steps in this article.
3
Checks: import, connect, verify
1
Private subscription URL
iPhone
Device used in this guide
Shadowrocket
Client covered here
Import the subscription URL into Shadowrocket
Open Shadowrocket and look for its configuration or subscription management controls. Labels and screen layouts may vary between app versions, so follow the action that adds a subscription or remote configuration rather than relying on an exact button position. If the provider offers a dedicated import link that opens Shadowrocket, you can use it; otherwise, copy the URL and add it from inside the app.
- Copy the full subscription URL from the provider’s account page or setup guide. Make sure you copy the entire address, including any long token after the question mark if one is present.
- In Shadowrocket, open the area for adding a subscription or remote configuration. Choose the option that accepts a URL; do not paste the subscription into a field meant for a single server unless the provider specifically instructs you to do that.
- Paste the link into the URL field. If the app offers a name or remark field, enter a label that helps you identify the provider or profile later. Avoid putting sensitive account details in a label that could appear in screenshots.
- Save or confirm the entry, then use the app’s update, download, or refresh action to retrieve the configuration. Wait for the list to finish loading before selecting a server.
- Check that the subscription has produced server entries. If the list is empty, do not repeatedly refresh without checking the URL and provider instructions first.
A subscription URL and a single-node configuration are not interchangeable. A subscription normally points to a provider-managed set of entries that the app retrieves and refreshes. A single configuration may describe only one server. If the provider gives you a file or a one-off configuration rather than a subscription URL, use the import method specified for that item instead of trying to force it into the subscription field.
Some links may be opened by tapping them in Safari or another app. iOS can ask whether to open Shadowrocket or display a confirmation prompt. Confirm only when you recognize the source and intended destination. If tapping the link merely opens a webpage or shows text, return to Shadowrocket and use its URL import option. Do not change unrelated iPhone network settings to compensate for a link that was not imported.
Refresh the profile and check its contents
After adding a subscription, use the profile’s update or refresh command when available. This asks the provider’s server for the latest configuration. A successful refresh should normally leave you with selectable entries, but the exact result depends on the subscription and how it is formatted. If the app reports an error, read the message and compare it with the provider’s instructions before editing individual settings.
Check the profile name and the available server names. Names are labels, not proof of a server’s location, route quality, or compatibility with a particular website. If the provider documents how to distinguish regions or route types, use that naming guide. Do not infer technical properties from a country abbreviation alone, and do not assume that a recently updated list guarantees every entry is currently reachable from your network.
Subscription refreshes can replace, add, or remove entries. If you rename a profile or customize settings, note that a later update may affect those changes depending on how Shadowrocket and the provider handle the profile. Keep a record of any setting you deliberately changed, but avoid exporting or sharing configuration files that contain credentials or tokens.
For a quick setup reference beyond this app-specific walkthrough, the VPN for China Travel homepage provides the broader service context. For the task at hand, however, continue to use the provider’s current subscription instructions and the settings displayed in Shadowrocket rather than copying an unrelated profile from another device.
Choose a server and connect on iPhone
Once the subscription entries are visible, select one server to test. Start with an entry the provider recommends for your location or intended use. If the provider gives no recommendation, choose a clearly labelled, compatible entry and use it as a baseline. Changing several settings or switching among many entries at once makes it harder to identify what caused a connection problem.
Tap the chosen entry or use Shadowrocket’s connection control, depending on the app version. The first time the app creates a VPN connection, iOS may show a system permission prompt asking to add a VPN configuration. Review the prompt and approve it only if you intended to connect through Shadowrocket. You may need to authenticate with your device passcode, Face ID, or Touch ID. This permission allows the app to establish a local VPN configuration; it does not mean the connection has been verified for every app or destination.
After approval, return to Shadowrocket and wait for the connection state to update. iOS may also display a VPN indicator in the system interface. If the app shows an error, note its wording before trying again. A login or authentication error points to a different problem from a timeout, a rejected configuration, or a connection that starts but drops. Preserve the exact error text for troubleshooting, while hiding subscription URLs and account tokens from any screenshot.
Keep other VPN or proxy apps disconnected while testing. Two apps attempting to manage the same device-level VPN connection can cause confusing status changes or routing behavior. If you use an iPhone feature, security app, or work profile that also configures a VPN, check its status and instructions before changing it. Do not remove a profile you do not recognize unless you understand which app or organization installed it.
If the first server does not connect, disconnect cleanly and test another compatible entry from the same subscription. Avoid changing protocol fields, ports, or advanced routing rules unless the provider has supplied the correct values. Those fields are interdependent; copying a value from a different service can make an otherwise valid profile unusable.
Verify that traffic is using the intended route
A connected status is a useful first signal, not the final test. Check the iPhone’s VPN indicator and Shadowrocket’s connection state, then open a few ordinary websites or apps you normally use. Confirm that pages load fully, sign-in pages behave as expected, and the connection remains available while you move between apps. A site that opens once may still fail on a later request, so allow each test to complete instead of judging by a loading spinner alone.
You can also compare your public IP information before and after connecting by using a reputable IP-checking page. If the reported address or region does not change as expected, first confirm that Shadowrocket is connected and that the selected configuration is the one you intended to test. Browser privacy features, cached pages, split routing, and the IP-checking service itself may affect what you see. An IP lookup is one diagnostic signal; it does not prove that every app uses the same route or that a service will accept the connection.
Shadowrocket may provide rule-based routing, global proxy behavior, or other routing modes, depending on the profile and app version. In rule-based mode, some destinations may connect directly while others use the selected proxy. That can be useful when you want local services to remain direct, but it means that an IP check in one app cannot necessarily describe traffic from every other app. Read the active rules and provider instructions before concluding that a destination is bypassing the VPN.
For a controlled check, keep the selected server and routing mode unchanged while you test. Record whether the connection indicator stays on, whether the page loads, and whether the result is repeatable. Then disconnect and compare the same destination if doing so is appropriate for your network and use case. Avoid interpreting a single temporary failure as proof that the subscription is broken: the destination, local network, DNS behavior, or server availability may each be involved.
Some services restrict access based on their own policies, account eligibility, location signals, or risk checks. A VPN connection does not change those rules or guarantee that a third-party app will work. If one service fails while ordinary browsing works, check that service’s current requirements and distinguish an account or policy issue from a general network problem.
Troubleshoot common import and connection problems
When a subscription does not appear, start with the simplest checks. Confirm that the URL was copied completely, that there is no accidental space at the beginning or end, and that you used the subscription import option rather than a single-server field. Check whether the provider requires an account sign-in before a URL is issued, whether the subscription is still active, and whether its instructions name a specific client format. If the URL was copied from a message, try copying it again from the provider’s account page.
If the profile is present but the server list is empty or cannot refresh, check your ordinary internet connection first. Temporarily disconnect Shadowrocket, confirm that Safari can reach a normal website, then reconnect and refresh the profile. If the provider has a status notice or an updated iOS guide, compare it with the configuration you imported. A subscription can be valid yet temporarily unavailable, and changing local protocol values will not fix a provider-side issue.
If the connection starts but websites do not load, disconnect and reconnect once, then test a different compatible server. Check whether the current mode uses rules that send the tested destination directly. If a different entry works, the issue may be specific to the original route rather than the whole subscription. If none work, record the app’s error, the time of the attempt, the selected entry name, and whether other apps have installed VPN profiles. Share only the information needed for support; redact your subscription URL, authentication details, and private configuration values.
If iOS refuses to approve or retain the VPN configuration, check the system prompt carefully and review whether another VPN or device-management profile controls the phone. A managed work or school device may limit network changes. Do not delete management settings or profiles simply to make a test pass. Follow the device administrator’s instructions or ask the provider for an alternative supported setup.
- ✅ Confirm that the subscription URL is complete, private, and intended for Shadowrocket.
- ✅ Refresh the profile and select a server documented as compatible by the provider.
- ✅ Approve the iOS VPN prompt only when you initiated the connection.
- ✅ Test the connection and destination separately before changing advanced settings.
- ❌ Do not publish a subscription URL, token, or unredacted configuration screenshot.
- ❌ Do not run multiple VPN clients at the same time while diagnosing a connection.
- ❌ Do not treat a VPN indicator or one successful page load as proof that every app is routed.
When contacting support, provide the iPhone model only if relevant, the Shadowrocket version, the provider’s documented setup method, the selected entry label, and the exact error text. Include whether the subscription refresh completed and whether the connection indicator appeared. Never send a password or full subscription URL in an ordinary support message unless the provider has a secure, explicitly designated method for handling it.
Once the connection works, keep the profile updated according to the provider’s guidance and repeat the basic checks after a major app or iOS update. If you no longer need the configuration, disconnect first and remove only the profile you recognize as belonging to Shadowrocket. A careful import, a single-server test, and a separate verification of actual traffic give you a clearer diagnosis than repeatedly reinstalling the app or changing unrelated iPhone settings.