Skip to content

iPhone VPN Setup Guide: Import a Shadowrocket Subscription

Set up Shadowrocket on your iPhone or iPad with clear steps for adding a subscription URL, refreshing server profiles, choosing a connection, and checking that it works. This beginner guide also covers common import issues and the connection indicators to look for.

Setting up a VPN client on an iPhone or iPad involves more than pasting a link. You need a compatible copy of Shadowrocket, a valid subscription URL, and a quick way to check that the imported profile can connect. This guide walks through those steps in order, explains what the connection indicators mean, and shows how to narrow down common import problems without repeatedly changing settings at random.

A subscription link is sensitive: anyone who obtains it may be able to access the profiles it provides. Copy it only from a trusted account page or provider, avoid posting it in messages or screenshots, and do not treat the URL as an ordinary public website address. If you are using a different iOS proxy client, its labels may differ, but the basic process—add a subscription, refresh profiles, choose a profile, and authorize the VPN connection—is similar.

Check the app and subscription first

Before importing anything, confirm that Shadowrocket is installed from an App Store listing you trust and that it opens normally on your device. Availability can vary by App Store region and account settings. If you cannot find the app, check the store region and the app’s current listing rather than installing an unfamiliar configuration profile or a copy from an unofficial download page. A VPN subscription does not itself install the client, and a client install does not include a subscription.

Next, sign in to the account that provides your service and locate its iOS setup instructions or subscription link. Providers may offer a dedicated iOS link, a general subscription URL, or separate links for different client types. Use the one explicitly intended for Shadowrocket or compatible subscription clients. A link for a different format may open in a browser but still fail to create usable server profiles.

It also helps to distinguish the subscription URL from an individual server profile. The URL is usually a source that Shadowrocket can revisit to retrieve or update a group of profiles. An individual profile is one connection entry in the client. Importing the source successfully does not necessarily mean that a connection has already been selected or started.

  • ✅ Get the subscription URL from the provider’s authenticated account page or setup instructions.
  • ✅ Confirm that the link is intended for Shadowrocket or a compatible client.
  • ✅ Keep the URL private; avoid sending it to public chats or saving it in an exposed note.
  • ❌ Do not assume that a link opening in Safari proves the subscription format is valid.
  • ❌ Do not import a configuration profile from an unknown website just to make the client connect.

What a subscription import does—and does not do

When a subscription is added, the client uses the URL to retrieve configuration data and display available profiles. Depending on the provider and client version, you may see a subscription entry, a group, or a list of server profiles. The entries can include connection parameters and routing information that the client needs to establish a tunnel. You generally do not need to type those technical values by hand when using a supported subscription link.

Importing is separate from connecting. After the profile list appears, you still need to choose an available profile and turn on the client’s connection control. The first time the client requests a VPN connection, iOS may show a system permission prompt to add a VPN configuration. Read that prompt and approve it only if you intentionally started the connection in Shadowrocket. iOS manages the system-level VPN permission; it is not an error message from the subscription.

Profiles can also become outdated. A provider may change server details or publish new entries, so a successful import from an earlier date does not guarantee that the list remains current forever. Refreshing the subscription asks the client to retrieve the latest data. It does not necessarily select a different profile, reset every app setting, or fix a problem caused by the local network.

Key distinction: the subscription supplies profiles; you choose a profile and start the connection separately.

Add the subscription on iPhone or iPad

Have the subscription URL available before opening Shadowrocket. If the provider offers a copy button, use it and check that the copied text is complete. Avoid copying surrounding spaces, punctuation, or explanatory text. If you received the URL in a message, verify that it came from the provider and that the full link has not been split across lines.

  1. Open Shadowrocket and allow it to finish loading its main screen. If it asks you to review an existing profile or connection, note what is already there before making changes.
  2. Open the client’s profile or configuration controls and use the add action, commonly shown with a plus icon. Interface wording can change between versions, so look for the option that adds a subscription or remote configuration rather than an option for manually entering one server.
  3. Choose the subscription option if the client presents several import types. Paste the provider’s subscription URL into the URL field. If there is a label or remark field, enter a short name that helps you identify the source; this label is for your own organization and does not change the service.
  4. Save or confirm the entry. If the client prompts for a name, use a neutral label rather than placing the subscription URL in the label, which could expose it in screenshots or screen recordings.
  5. Return to the profile list and use the client’s update or refresh action for that subscription. Wait for the request to finish, then check whether profiles or a successful update status appear.
  6. Select a profile from the refreshed list. Start the connection using the client’s main connection control. If iOS asks to add a VPN configuration, confirm only when the request follows your action in Shadowrocket.
  7. Wait for the client and iOS status area to show that a connection is active. Then test an ordinary website or app that you recognize. If the client shows an error, note its exact wording before changing the subscription or deleting profiles.

If you are comparing providers or setup instructions, focus on whether the service explains its supported client format, how to refresh the subscription, and what to do when a profile is unavailable. A clear VPN for China setup should make those practical steps understandable without asking you to expose your subscription URL or install unrelated software.

Keep the first test simple. Do not change DNS, routing mode, and several profile settings at the same time. If the initial connection fails, one controlled check at a time makes it easier to tell whether the problem is a copied URL, an unsupported format, an iOS permission, or a network interruption.

Choose a profile and check the connection

After the subscription refresh, select an available profile that matches your intended use and the provider’s guidance. Do not assume that the first entry is always the best choice, or that a country label alone tells you how a route will perform from your current network. If the provider groups profiles by region or purpose, use those descriptions as a starting point and compare results with the apps and sites you actually use.

Check the client’s connection state, not just whether a profile is highlighted. A selected profile may be ready but not connected. Once the connection is active, iOS may display its VPN indicator, while Shadowrocket may show a connected state or traffic information. The exact appearance depends on the app version and iOS release. These indicators show that the device has established a VPN connection; they do not prove that every app is routed as expected or that a particular website is available.

Interpret the client state before deciding what to troubleshoot
What you observe What it usually tells you What to check next
Profiles appear after refresh The subscription was retrieved well enough to provide entries Select a profile and start the connection; importing alone is not a connection
A profile is selected, but no active connection is shown The profile may be selected without the tunnel being started Use the connection control and watch for the iOS permission prompt or an error
The client reports connected and iOS shows a VPN indicator The device reports an active VPN connection Test a known site or app and check whether its traffic follows the intended route
The client reports an error or repeatedly disconnects The selected profile or current network may not be completing the connection Record the message, try a refresh, and compare another provider-listed profile or network
The VPN indicator is present, but one app still fails The tunnel can be active while that app, route, DNS request, or service has a separate issue Test another app and review the client’s routing behavior before re-importing everything

For a basic verification, open a familiar website, then try the specific app or service you plan to use. If those behave differently, the client may be connected while that app has its own network, account, or service issue. A single successful page load is useful evidence, but it cannot establish that every destination uses the same route. Avoid relying on a profile name or an indicator alone as a complete test.

Troubleshoot import and connection problems

If no profiles appear, start with the subscription entry rather than changing connection settings. Compare the URL in Shadowrocket with the one in the provider’s account page. Check for a missing character, an accidental space, or a truncated link. Some subscription URLs contain characters that are easy to misread when copied from a screenshot, so copy from the original text whenever possible.

If the URL appears correct but refresh fails, check whether the iPhone or iPad can access the internet on its current network. Try loading an ordinary site with the VPN disconnected. Then check the provider’s setup instructions for a client-specific link or supported format. Do not paste the URL into a public link-checking service: the subscription itself may function like a credential, and sharing it can put the account’s profiles at risk.

If profiles do appear but the connection will not start, read the exact error and confirm that you selected an available profile. A failed connection can involve the profile, the network you are currently using, or an iOS permission decision. If you denied the system prompt, return to Shadowrocket and start the connection again so iOS can present the appropriate request. Do not approve a VPN configuration prompt that you did not initiate or do not recognize.

If it connects but a particular site does not work, disconnect and reconnect only after recording what you observed. Check another site or app to see whether the problem is limited to one destination. If the subscription includes other suitable profiles, try one and compare. Avoid deleting all profiles as a first response: doing so can remove useful information about whether the import worked and may require repeating the setup.

When the problem began after changing Wi-Fi networks, moving between Wi-Fi and mobile data, or updating the app, test one change at a time. A network transition can interrupt an existing tunnel, and a profile that worked on one network may behave differently on another. Closing and reopening the client or disconnecting and reconnecting can be a reasonable first check; repeatedly switching several settings at once makes the cause harder to identify.

Refresh safely and protect your subscription

Refresh the subscription when the provider says profiles have changed, when the list appears incomplete, or when the client reports that its configuration is out of date. Use the refresh action associated with the subscription entry, then allow it to complete before selecting a profile. If the client displays a refresh timestamp or status, use it to distinguish a completed update from an entry that is merely saved.

Refreshing does not mean you should keep replacing the URL. If the same link worked before, first check the network connection, the refresh result, and the provider’s instructions. Ask the provider for a replacement only when its account page or support guidance indicates that the existing link has expired or needs to be renewed. If you do receive a replacement, remove or update the old entry only after confirming which link is current.

Treat the URL like account access information. Do not publish it in a review, send it to someone who does not need it, or include it in a diagnostic screenshot. If you accidentally share it, follow the provider’s account guidance for changing or regenerating the subscription. A profile list may also reveal locations or account details, so review screenshots before sharing them with support.

When contacting support, provide the client and iOS versions if you know them, the stage where the process fails, and the exact error text. You can describe whether the subscription refreshes, whether profiles appear, and whether iOS shows an active VPN indicator without sending the subscription URL itself. This separates an import problem from a connection problem and gives support useful context while keeping the credential private.

Bottom line: import the correct subscription, refresh it, select a profile, authorize the iOS VPN prompt, and verify the result with the apps you intend to use.
Get Started Free