How to Import a Subscription to Shadowrocket: Setup Steps and Connection Troubleshooting

This guide explains how to import a subscription into Shadowrocket: copy the subscription URL, add it to the app, update nodes, and test the connection. It also covers how IP addresses, DNS, and browser settings affect what you see. The instructions apply to the official version of Shadowrocket on iPhone and iPad; button names may vary slightly between versions.

1. Before you begin: make sure you have a subscription URL

Install and open Shadowrocket, commonly known as “小火箭” (“Little Rocket”). Get the app through the official App Store to avoid modified versions from unknown sources. Then obtain a subscription URL compatible with Shadowrocket from your service provider or from this site’s free nodes page.

A subscription URL is different from a link to a single node: subscriptions are usually HTTPS URLs that the client uses to retrieve a list of nodes. Content starting with vless://, vmess://, or trojan:// is usually a share link for a single node and should be imported using the corresponding node import option. You can’t determine compatibility from a link’s appearance alone; follow the provider’s instructions.

2. How to import a subscription into Shadowrocket

  1. Copy the entire subscription URL. Make sure it doesn’t include spaces, line breaks, Chinese punctuation, or explanatory text from a webpage.
  2. Go to the Shadowrocket home screen, tap “+” in the upper-right corner, and select “Subscribe” or “订阅” as the type.
  3. Paste the URL into the URL field. You can enter a recognizable name in the remark field. Leave other settings at their defaults unless instructed otherwise, then save.
  4. Return to the home screen and wait for the app to fetch the subscription. If no nodes appear, find the update option for the subscription entry and refresh it manually.
  5. Expand the subscription, select a node, and turn on the connection switch on the home screen. The first time you connect, follow the system prompts to allow adding a VPN configuration and verify your device.
  6. Open a browser and visit a website you want to access. You can also run the app’s connectivity test to check whether the node is working.

A successful import doesn’t guarantee that the node can connect. Results depend on whether the node is online, the subscription has expired, and any restrictions on your current network. A subscription URL may also contain an access token, so don’t post it in public group chats or submit the full link to an unfamiliar online conversion site.

3. If the update fails or you can’t connect, check the following in order

  • No nodes appear: Check that the URL is complete, hasn’t expired, and is supported by Shadowrocket. If it opens a login page or a regular webpage, the client usually can’t parse it as a subscription.
  • Subscription download fails: Switch between Wi-Fi and cellular data, then try again. Updating a subscription and connecting to a node are separate processes, so a failed update doesn’t necessarily mean all your existing nodes are unusable.
  • Unable to connect to a node: Update the subscription, then try another node. Temporarily turn off other VPNs to avoid conflicts from running multiple VPNs at once.
  • It shows as connected, but webpages won’t open: Check the current routing mode. You can temporarily switch to global proxy mode for comparison, then switch back to rule mode for everyday use.

4. How are IP, DNS, and browser settings related?

Your IP address indicates the network egress location that websites see. In rule mode, different websites may take different routes, so some IP lookup pages may still show your local egress IP. DNS translates domain names into addresses. DNS issues may prevent domains from opening even when the node is connected, but don’t change your DNS settings as soon as something goes wrong—first rule out node and routing issues.

Your browser’s cache, cookies, login status, and location permissions can also affect the region or language shown on a webpage; these aren’t always determined by your egress IP. You can compare results in a private browsing window, but this won’t change your IP address. Change just one setting at a time and test the subscription, node, routing, and browser state in turn to make it easier to pinpoint the problem.

Leave a Comment

Your email address will not be published. Required fields are marked *

中文 EN
🚀

RedGate VPN

免费节点太挤太慢?
升级高速稳定专线

立即体验 →
⚡

告别卡顿

RedGate VPN
全球高速节点

免费下载 →
Scroll to Top