This article addresses the practical question, “How do I import a subscription into Shadowrocket?” It shows you how to add a subscription link, update nodes, and choose a server in Shadowrocket on iPhone or iPad. It also explains why the same subscription may fail to load or update, or may not provide access after connecting, depending on your IP, DNS, or browser environment.
1. Basic steps for importing a subscription into Shadowrocket
Before you begin, make sure Shadowrocket is installed and that you have a valid subscription link. A subscription is usually a URL beginning with https://, and may also be provided on this site’s free nodes page. We recommend turning off other proxy apps first to avoid connection failures caused by running multiple proxies.
- Open Shadowrocket and tap the “+” in the upper-right corner of the home screen.
- Select “Subscribe” or “Subscription” as the type.
- Paste the subscription link into the URL field. For the remark, enter “freevpn” or a name of your choice.
- Tap “Done” in the upper-right corner to return to the home screen.
- Pull down on the list or open the subscription entry, then select “Update.”
- Select a node and turn on Shadowrocket’s main switch. The first time you connect, follow the prompts to allow it to add a VPN configuration.
If the subscription contains multiple protocols, such as VLESS, VMess, Trojan, or Shadowsocks, Shadowrocket will usually recognize them automatically. Most users don’t need to change protocol settings manually unless the subscription provider specifically instructs them to.
2. How to check whether the import was successful
A successful import doesn’t necessarily mean you can access the internet. Check in this order: first, make sure the nodes appear in the list. Then tap the info icon next to a node to see whether it has a server address, port, encryption method, and other details. Next, connect and check whether the VPN indicator appears at the top of the screen. Finally, open a browser and visit a familiar test site.
We recommend testing with Safari first, since some third-party browsers have built-in acceleration, private DNS, or proxy extensions that can interfere with troubleshooting. If Safari works but another browser doesn’t, the issue is probably with that browser’s settings rather than the subscription.
3. How your IP, DNS, and browser environment affect access
Many people assume that turning on Shadowrocket is all it takes after importing a subscription. In fact, access can also be affected by your IP, DNS, and browser environment.
- IP environment: Your current Wi-Fi, cellular network, campus network, or workplace network may restrict proxy connections. If Wi-Fi doesn’t work, try switching to 4G/5G.
- DNS resolution: DNS translates domain names into IP addresses. If DNS is interfered with or returns an abnormal response, you may be able to connect to a node but unable to open webpages. Try enabling a suitable remote DNS in Shadowrocket’s configuration, or switch networks and try again.
- Browser cache: Your browser may have cached outdated DNS results, cookies, or site policies. Try private browsing, clearing the cache, or comparing the results in Safari.
- System proxy conflicts: Other active VPNs, enterprise certificates, or ad blockers may cause routing issues. Turn off unrelated tools while testing.
4. How to troubleshoot subscription update failures
If you see “Unable to update,” “Request timed out,” or an empty list, first check that the subscription link wasn’t copied with missing characters, spaces, or line breaks. You can paste it into Notes and check that it begins with http or https. You can also press and hold the subscription in Shadowrocket to delete it, then add it again.
The subscription link itself may also be temporarily unavailable, especially if it’s from a free node source, where links may expire, be undergoing maintenance, or experience heavy traffic. If this happens, don’t keep changing settings. Try refreshing later or testing another subscription.
If the subscription only fails to update on a particular network, that network is probably blocking the subscription URL. Try updating over cellular data, then switch back to the original network to connect to a node.
5. What to do if you still can’t access sites after connecting
First, try other nodes in the same subscription, prioritizing ones with lower latency that complete the handshake successfully. Then open Shadowrocket’s global routing settings. Most users can start by testing “Config” or “Proxy” mode; if you only want international websites to use the proxy, you can switch to rule-based mode afterward.
Don’t change the node’s UUID, path, SNI, or transport settings at random—incorrect values will cause the connection to fail. Use the settings imported automatically from the subscription. If multiple nodes fail, check that your system time is correct, VPN access is allowed, and no other proxy app is in use.
In summary, importing a subscription into Shadowrocket comes down to four steps: “Add the subscription URL—update—select a node—turn on the VPN.” If importing or accessing sites fails, check your IP network, DNS, browser cache, and subscription availability. This will usually help you pinpoint the problem.