This article explains how to import a subscription into Shadowrocket, guiding you through adding a subscription on your iPhone, updating nodes, and testing the connection. It also describes what your IP, DNS, and browser environment each affect. All you need is the client installed and a subscription link from a trusted source. Menu names may vary slightly between versions, so follow the labels in your app.
1. First, distinguish between a subscription link and a single node
“Xiao Huo Jian” usually refers to the iOS client Shadowrocket. Check the app name and developer information in the App Store to avoid installing configuration profiles from unknown sources or counterfeit apps. A subscription link is usually a URL beginning with https:// that can be used to retrieve and update a group of nodes. Links beginning with ss://, vmess://, vless://, and similar prefixes are usually single-node share links, which are imported differently.
A subscription link is an access credential. Don’t share screenshots of it or forward it to others. When copying it from a webpage, copy the link address itself and make sure you don’t include any explanatory text, spaces, or line breaks. If you’re using free nodes from this site or another source, confirm whether you’ve been given a subscription URL or a single-node link.
2. How to import a subscription into Shadowrocket
- Open Shadowrocket, tap “+” in the upper-right corner of the home screen, and go to the Add Server page.
- Tap “Type” and select “Subscribe” or “Subscription.” If the option is in a different place in your version, look for the subscription add feature.
- Paste the full subscription link into the “URL” field. You can enter a recognizable name in “Remarks,” such as “Daily Subscription.” Don’t change the link’s parameters.
- Tap Save in the upper-right corner, then return to the home screen and wait for the subscription to download. If no nodes appear, open the subscription’s action menu and select “Update Subscription.”
- Expand the subscription group and select a node, then turn on the connection switch on the home screen. The first time you connect, follow the system prompts to allow the VPN configuration and complete device verification.
- Open a browser and visit a website that normally works to check whether it loads. To verify your exit IP, check your current public IP.
Successfully importing nodes doesn’t mean you’re connected. Seeing a node list only means that the subscription content was retrieved. You still need to select an available node and enable the connection. For everyday use, start with rule mode. To troubleshoot routing issues, you can temporarily switch to global proxy mode for testing, then switch back afterward.
3. What to do if the subscription fails or websites won’t load after connecting
- Download failed: First check that your Wi-Fi or cellular connection is working, then make sure the link is complete, hasn’t expired, and doesn’t require you to sign in. You can also try switching networks.
- The subscription is empty or fails to parse: Make sure you have a subscription that the client supports, rather than a webpage URL, a login page, or a configuration file intended only for another client.
- Nodes appear, but the connection times out: Update the subscription manually and try another node. Latency tests are only a guide and don’t guarantee that a particular website will be accessible.
- No websites work after you connect: Check whether another VPN, proxy, or network filtering tool is running. Temporarily disable any conflicting tools, then reconnect.
4. How IP, DNS, and your browser environment are related
Your IP is the network exit that websites see; DNS translates domain names into addresses; and your browser stores cookies, login sessions, and site permissions. These can affect your browsing experience after you connect, but they don’t determine whether the subscription imports correctly.
If your IP has changed but a website still shows your previous region, the cause may be your account region, cookies, or location permissions. Try comparing the result in a private browsing window. If you get a domain resolution error, check the client’s DNS and routing settings first rather than entering an unfamiliar DNS server. If the subscription still doesn’t work after updating, report the error message to the provider, making sure to hide any keys in the subscription link.