This article explains how to import a subscription into Shadowrocket, from getting the subscription URL and adding it to the app to updating nodes, connecting, and troubleshooting websites that won’t load. Follow the steps in order. It also explains how subscriptions relate to IP addresses, DNS, and your browser environment, so you don’t mistake a successful import for a successful connection.
1. What to prepare before importing
“Shadowrocket” usually refers to the app for iPhone and iPad. Get it through the official App Store and check the app name and developer information to avoid installing unknown configuration profiles or counterfeit software.
Have a subscription URL compatible with Shadowrocket from your provider ready. It is usually a complete URL beginning with HTTPS. A subscription URL is used to retrieve multiple nodes; it is not the provider’s homepage or a purchase link. It may contain an access token, so don’t share screenshots of it, forward it, or paste it into unfamiliar testing websites.
2. Steps to import a subscription into Shadowrocket
- Copy the complete subscription URL. Make sure there are no spaces or line breaks at either end and that no characters are missing.
- Open Shadowrocket and tap “+” in the upper-right corner of the home screen to open the add page.
- Under “Type,” select “Subscribe.” The wording may vary slightly between versions.
- Paste the URL into the “URL” field and enter a recognizable name in the remarks field. Leave other options at their defaults unless instructed otherwise, then tap Save.
- Return to the home screen and wait for the subscription to download and populate the node list. If it doesn’t refresh, use the menu for that subscription to update it.
- Select a node and turn on the connection switch at the top. The first time you connect, follow the iOS prompt to add a VPN configuration and complete system verification.
A node list means only that the subscription was parsed successfully. The node must also connect and the routing settings must be correct for app traffic to be routed as expected. For initial testing, use the client’s default configuration and routing settings, and avoid changing multiple options at once.
3. How subscriptions, IP addresses, DNS, and browsers are related
A subscription distributes node information; it does not change your IP address by itself. After you connect to a node, proxied requests usually use the node’s exit IP, while direct requests continue to use your current network’s exit IP. So if an IP lookup shows your local address, this may be due to your routing rules and doesn’t necessarily mean the subscription failed to import.
DNS translates domain names into IP addresses. If the node connects but some websites report that the server can’t be found, check whether DNS resolution and routing are configured appropriately. First restore the client’s default DNS settings, then temporarily disable other DNS, VPN, or network-filtering tools to reduce potential conflicts.
Browser cookies, account region, location permissions, and cached data can also affect a page’s language and how it determines your region. Changing your exit IP does not clear your browser environment. You can cross-check in a private browsing window, but this does not guarantee that a website will identify your region differently.
4. Troubleshooting import or connection problems
- Subscription download fails: Check that the URL is valid and hasn’t expired, then try again over Wi-Fi or cellular data. If the URL is accessible only on certain networks, ask your provider how to retrieve it.
- No nodes appear after updating: Check that you copied a subscription URL rather than a webpage URL, and confirm that the subscription format is compatible with Shadowrocket. Don’t repeatedly import the same invalid link.
- Node times out: Update the subscription and try another node. Latency tests can help with troubleshooting, but actual access is the best measure.
- Connected, but webpages won’t load: Check your device’s network first, then check your routing and DNS settings and look for conflicts with other VPN configurations. Change only one setting at a time.
Update your subscription as needed. Free nodes may become unavailable. If you have connection problems, first check the URL and node status. Never give strangers your subscription token, Apple ID, or device verification code, and follow local laws and service rules.