Scope: iPhone, iPad and the macOS build of Shadowrocket. Menu names differ slightly between versions. This page starts from a subscription that has already been added and is failing, empty, or refusing to update. If you have not imported anything yet, read the import walkthrough first. Boundary: this page does not provide private subscriptions and does not promise that free nodes stay available. A full subscription URL usually contains a token, so mask it before you screenshot anything.
Group the symptom before you touch a setting
Write down the exact error text, but never publish the full subscription address. The usual cases fall into four groups: the URL is rejected the moment you add it; the update times out or returns an HTTP error; the update reports success but the node list is empty; nodes appear but pages still do not load. Those are four stages — do not mix their fixes.
| Symptom | Check | What it tells you |
|---|---|---|
| Same-domain page will not open in Safari | The domain itself, DNS, current network | The problem is upstream or local, not Shadowrocket |
| Update returns 401 / 403 / 404 / 429 / 5xx | Token, path, request rate, server state | Four different causes, four different actions |
| Update succeeds, node count is zero | Response body, format, filters, maximum node limit | Body is empty or not a format the app parses |
| Nodes exist, connectivity test fails for all | Node reachability, route, DNS, VPN capture | The problem has moved past import entirely |
The link will not open, or the URL is rejected
- Confirm the copied text starts with
https://and has no leading space, curly quote, or chat-app decoration around it. - Open the link in Safari only to see whether the server responds. Do not paste it into an unfamiliar online converter.
401or403usually means token, authorisation or referrer restriction;404means the path no longer exists;429means you are requesting too often — stop refreshing and wait.- If the provider's homepage also fails on ordinary networking, fix the local network first. If only the subscription address fails, ask the provider to verify the link.
The link opens, but Shadowrocket does not recognise it
HTTP 200 does not mean the body is correct. The address may return a login page, a Cloudflare challenge, a JSON error, blank text, or a configuration meant for another client. The App Store description of Shadowrocket describes it as a standalone network tool: it ships no proxy service and no servers, and you supply the configuration.
When a provider offers "universal subscription", "Clash YAML" and "sing-box JSON" side by side, choose the one explicitly marked as supporting Shadowrocket or universal URIs. Renaming a YAML file does not make it a universal subscription.
Import succeeded, but the node list is empty
- Confirm the subscription you just added is actually selected, rather than an old group still being displayed.
- Trigger one manual update and wait for it to finish. Do not tap repeatedly.
- Check the provider's announcement feed for a format change or an end of maintenance.
- If the same link also parses to zero nodes in another compatible client, the body is the more likely problem.
- If only Shadowrocket is empty, record the version, the returned format and the exact message, then compare against what the provider says it supports.
Nodes appeared, but pages do not load
At this point import is finished. Switch to one other node from the same subscription as a limited comparison, then test a plain HTTPS page and the egress address. If every node fails, the import stage is no longer the question. If latency shows a number but pages fail, continue with DNS, routing rules and VPN capture.
Check the iOS VPN handover
On first connection iOS may ask you to allow a VPN configuration. Only approve it after you have confirmed the app and the source of the configuration. If the status stays stuck, disconnect inside Shadowrocket, quit the app completely, and open it again. Do not run a second VPN-type app at the same time.
Apple documents that installed configuration profiles can be reviewed under Settings → General → VPN & Device Management. Removing a profile also removes the settings that profile introduced, so on a managed device ask the administrator before you delete anything.
Safe recovery after a failure
- Disconnect inside Shadowrocket and turn off the global switch.
- Disable or delete the failing subscription you just added, keeping the error record with the token masked.
- Confirm in iOS Settings that no VPN connection is still established; remove an unknown profile only after checking Apple's instructions.
- Open an ordinary page over Wi-Fi and over cellular separately, to confirm direct networking is back.
- Do not treat "Reset All Settings" as step one — it changes far more network and system preferences than the problem requires.
What none of this can fix
If the server is switched off, the port is blocked, the certificate expired, the traffic quota is exhausted, or the provider revoked the token, no client setting restores the node. Free resources carry no obligation of continued service. Once the upstream is confirmed dead, stop high-frequency refreshing and move to a source you can trace.
Three minutes to locate the layer
| Action | Observation | Meaning |
|---|---|---|
| Open a masked same-domain page in Safari | The domain itself is unreachable | Check the network, DNS or provider status; do not reinstall the client |
| Update the subscription and keep the full error text | 401 / 403 / 404 / 429 / 5xx | Authorisation, path, rate or server — each is handled differently |
| After a successful update, look at the list | Subscription present, nodes zero | Empty body, incompatible format, hidden filter, or a zero maximum |
| Test connectivity on existing nodes | All time out | The question moved from import to reachability |
Do not mix subscription, single URI and Clash YAML
- Subscription URL — added through the Subscribe entry; a successful update should produce a group of servers.
- Single URI —
vmess://,vless://,trojan://orss://, added via clipboard detection, QR scan or the matching protocol form. - Clash YAML — contains
proxies,proxy-groupsandrules. Being downloadable does not mean the Subscribe entry can parse it.
If you need to see what a link actually contains before importing it, paste it into the subscription converter — parsing happens in the browser, and the link is never uploaded.
Sources
- Apple App Store — Shadowrocket listing (standalone network tool, no bundled service).
- Apple Support — installing or removing configuration profiles.
- Site verification date: 2026-10-17 for the Chinese original; this English page restates the same scope and boundaries.
Common questions
The link opens in Safari. Why does Shadowrocket still fail?
A browser opening it only proves the server returned content, not that the content is a subscription format the app parses. Check whether the body is node URIs, Base64, a configuration file, or a login or error page.
Can I import a Clash YAML as a Shadowrocket subscription?
Do not assume so. It may contain fields, rules and groups the app does not recognise. Prefer a Shadowrocket-specific subscription or a supported single URI from the provider.
Should I delete the old subscription first?
No. Keep it and its working nodes, validate the new link in a temporary profile, and delete the old one only after the new content loads and networking still works.
Related
Error string index · Empty subscription after update · Subscription converter