Setting up Shadowrocket on an iPhone involves more than installing an app. You need a valid subscription from a compatible service, a configuration that Shadowrocket can read, permission for iOS to create a VPN connection, and a suitable server selection. Once these parts are in place, you can refresh the available options and test your connection without changing settings at random. The steps below use the usual subscription-import workflow; labels and button placement can vary slightly between Shadowrocket versions.
Check app availability and your subscription
First, confirm that Shadowrocket is available to you through the App Store in your current region. App availability and purchase requirements can differ by storefront, so check the listing shown on your own iPhone rather than relying on an old screenshot or a third-party download page. Avoid installing configuration profiles or modified apps from unfamiliar sites. A profile is not a substitute for a legitimate app or a valid subscription, and installing one can change device settings in ways that are difficult to audit.
Next, make sure your service account has an active plan and that the provider offers subscription details compatible with Shadowrocket. The app is a client: it reads configuration information and uses it to connect. Installing Shadowrocket alone does not provide server access. Similarly, paying for a service does not automatically add its servers to the iPhone; you still need to import the provider’s subscription or configuration using the method the provider supports.
Look in the service dashboard or its setup instructions for an iOS-compatible subscription link, QR code, or individual configuration. The available protocols and import formats depend on the service. Do not assume that every subscription supports every client or protocol. If the instructions name a particular client, check whether they also provide a general subscription format for Shadowrocket before proceeding.
Prepare the iPhone before importing
Use a stable internet connection while adding the subscription. If you are currently on a network that blocks the provider’s subscription endpoint, the link may fail to update even though it is correct. You can try again on another trusted network, such as a mobile connection or a different Wi-Fi network. Avoid changing several iPhone network settings at once; keeping the setup simple makes any error easier to identify.
Check that the iPhone’s date and time are set automatically. Incorrect device time can interfere with secure connections and certificate checks. Also close another proxy or VPN client before starting. iOS generally allows only one active system-level VPN connection at a time, so leaving a different client connected can prevent Shadowrocket from establishing its own tunnel or can make the result confusing.
Open Shadowrocket and allow it to display the normal iOS permission prompt when you start a connection. iOS may ask whether the app can add VPN configurations or use a VPN connection. Review the request and approve it if you intend to use Shadowrocket. This permission enables the app to create a local VPN interface; it does not mean the subscription itself is a conventional VPN protocol. Proxy clients can use different protocols while still relying on iOS VPN permission to route selected traffic.
3
Setup stages: import, connect, verify
1
Proxy client to use at a time
iOS
VPN permission managed by the system
If you are still comparing services, check whether the provider documents a subscription format for your intended client and explains how to retrieve it securely. For an overview of the service, see VPN for China; then follow the setup instructions for the account and client you choose.
Import the subscription into Shadowrocket
Copy the subscription URL from the provider’s account page or setup guide. Make sure you copy the complete link, without adding spaces or removing characters. Some dashboards offer a copy button or a QR code instead of displaying the URL in full. Use the provider’s documented method, and do not share the copied link with anyone who does not need access to the account.
In Shadowrocket, open the configuration or server list and use the add control, commonly shown as a plus sign. Choose the subscription option if the app presents a choice between adding an individual server and adding a subscription. Paste the URL into the appropriate field, review any optional name or remark, and save the entry. The exact field names can change between versions, so match the purpose of the control rather than relying on a particular screen layout.
If the provider supplies a QR code specifically for Shadowrocket, use the app’s scan or import function and confirm the details before saving. A QR code may contain the same private subscription information as a link. Do not scan a code from an unverified message or public post. If the app asks you to choose a format or protocol, use the value given by the provider; guessing can create an entry that appears in the list but cannot connect.
After saving, look for the subscription entry in the app’s configuration or server list. An entry may appear before its server options have been downloaded. Select the subscription and use the app’s update, refresh, or download action if it does not fetch the list automatically. Wait for the operation to finish and read any status message. A successful import normally means that the app can read the subscription and display its configurations; it does not yet prove that a selected server is reachable.
If the app does not offer a subscription field
Check that you are adding a subscription rather than an individual server. A single-server form expects server-specific fields and is not the right place for a subscription URL. If the provider provides only a file or a client-specific link, return to its iOS instructions and confirm whether that format is supported in your version of Shadowrocket. Do not manually convert or edit the link unless the provider’s instructions explicitly require it.
Refresh the list and choose a server
Subscriptions can change over time: entries may be added, removed, renamed, or updated by the provider. Refresh the subscription in Shadowrocket when the provider says the configuration has changed, when the list appears empty, or when an older entry stops working. Use the refresh control on the subscription itself, not an unrelated app-wide setting. Keep the app open while it downloads, and check whether iOS shows a network error or whether the provider returns an authentication or subscription message.
When the server list loads, start with an option that matches your immediate goal and the provider’s guidance. A country or city label describes the intended exit location, but it is not a guarantee that a particular website or streaming service will accept that connection. If the service distinguishes between route types or client configurations, follow its explanation rather than assuming a label such as “direct,” “relay,” or a protocol name indicates better performance in every situation.
For a first test, choose one server and leave other configuration settings at their imported defaults. Avoid repeatedly switching protocols, DNS modes, and routing rules before establishing whether the basic connection works. If the list includes many similar entries, test them one at a time and note which one you selected and what result you observed. This makes it easier to return to a known configuration if a later change introduces a problem.
Shadowrocket may offer different traffic-handling modes, such as rules-based routing or sending more traffic through the selected proxy. The names and behavior depend on the configuration. Rules-based routing can leave some destinations on the normal connection, while a broader proxy mode may route more traffic through the selected server. Use the provider’s recommended mode first. If only some apps appear to use the connection, check the active mode and rules before deciding that the subscription is broken.
Connect and verify the result
Tap the selected server or connection control to start. If iOS asks for permission to add a VPN configuration, approve it for Shadowrocket. The app should show a connected state, and iOS may display a VPN indicator. These signs confirm that a local connection has been established; they do not by themselves prove that every app is using the proxy or that a destination recognizes the intended exit location.
Test with a simple website or service that you are authorized to access. If you need to check a region-specific service, first confirm its current availability rules and account requirements. Sign-in status, account region, payment eligibility, and the service’s own policies can affect access independently of the network route. A connection test and a content-availability test are different checks.
Compare behavior with Shadowrocket connected and disconnected, while keeping the same app and destination. If a page loads in one state but not the other, note the time, selected configuration, network type, and exact error message. Avoid treating a single loading delay as proof of a server failure: the website itself, DNS resolution, the iPhone’s local network, or an account restriction may be involved.
- ✅ Confirm that Shadowrocket shows a connected state and iOS has granted VPN permission.
- ✅ Test one known destination before changing other settings.
- ✅ Check whether the selected routing mode includes the app or destination you are testing.
- ❌ Do not run two proxy clients at the same time while diagnosing a connection.
- ❌ Do not post your subscription URL, QR code, or full configuration in a public support request.
Fix common setup and subscription problems
The subscription cannot be added: Check for a missing character, an accidental space, or a partially copied URL. Confirm that you selected the subscription import option rather than the individual-server form. If the URL was copied from an account page, sign in again and make sure the account still displays a current subscription. If the provider offers a QR method, you can try it as an alternative, but scan only a code obtained from the provider’s authenticated instructions.
The subscription is added but the server list is empty: Trigger a refresh and wait for the result. Confirm that the iPhone has internet access outside Shadowrocket and that the subscription has not expired or been revoked. A service may also restrict how a subscription is retrieved or require a specific client format. If the provider’s instructions indicate a compatibility limitation, use a supported method rather than trying to modify the URL.
Refresh reports an authorization or network error: First check the message carefully. An authorization-related message can point to an expired, changed, or incorrectly copied link. A network error can mean the current Wi-Fi or mobile network cannot reach the subscription endpoint. Recopy the link from the account dashboard and retry over another trusted connection. Do not send the full link to support unless the provider explicitly requires it through a secure channel.
The app says connected, but a website does not work: Confirm that the selected server is active and that the app’s routing mode includes the destination. Try another configuration supplied by the same subscription, one at a time. If only one website fails, check that site’s status, regional rules, login state, and account eligibility. If all destinations fail, disconnect and reconnect once, then check whether another VPN client or iOS network profile is interfering.
Some apps work while others do not: Review the active rules and whether the affected app or destination is set to use the proxy. A rules-based setup intentionally treats destinations differently, so a connected indicator does not mean all traffic follows the same route. Restore the provider’s recommended configuration if you have changed rules and can no longer identify the cause.
The connection stops after changing networks: Wi-Fi and mobile data can have different reachability and DNS behavior. Disconnect and reconnect after moving to another network, then test again. If the problem appears only on one network, record that distinction for troubleshooting. Avoid resetting all iPhone network settings as a first step; doing so can remove saved Wi-Fi details without addressing a subscription or compatibility issue.
Keep the setup secure and easy to maintain
Keep Shadowrocket and iOS updated through their normal update channels, and check the provider’s instructions when its subscription format or recommended settings change. Refresh configurations using the app’s built-in subscription update function. If you suspect that a link has been exposed, use the provider’s account controls or support instructions to replace or revoke it where available; deleting an entry from the iPhone alone may not invalidate the underlying credential.
When asking for help, provide the app version, iOS version, the type of network you were using, the non-sensitive configuration name, and the exact error text. Redact subscription URLs, passwords, QR codes, server credentials, and account identifiers from screenshots. A useful report distinguishes between failure to import, failure to refresh, failure to connect, and failure to reach one particular destination, because each points to a different part of the setup.
Once the subscription imports and a test destination responds as expected, leave the imported settings unchanged unless you have a specific reason to adjust them. That gives you a reliable baseline and makes future troubleshooting more straightforward.