Client and service are separate
Shadowrocket is a client. It reads a configuration and forwards traffic; it does not supply nodes. When you obtain the app, verify the listing, the developer and the app identifier, and treat same-named apps or shared accounts as what they are.
Import paths and what each accepts
| Path | Accepts | Fails when |
|---|---|---|
| Subscription URL | A remote configuration or list the client can parse | The address returns HTML, a login page or an unsupported format |
| QR code | Whatever the code encodes | The code encodes a single node but you expected a subscription |
| Share link | One node | You expected a list; one link produces one entry |
| File import | A configuration file from Files or iCloud Drive | The file is an HTML page saved with a .conf or .yaml name |
A browser opening an address proves reachability only. What matters is whether the body is something the client can parse.
After import: three checks
- Entries exist. If the list is empty, go back to what the address returned before touching any setting.
- One is selected. A list without a selection produces no traffic.
- The connection is on. Confirm the system VPN indicator appears; if another VPN or filter is also active, the two may conflict.
Rule mode and global mode
Rule mode evaluates each connection against the rule set and decides whether to proxy, reject or go direct. Global mode sends captured traffic through the selected proxy. Neither mode can capture an application that does not enter the tunnel at all — that is a platform behaviour, not a rule outcome.
When it fails
| Symptom | First check |
|---|---|
| Node list empty | What the address returned; whether the format matches the client |
| Connected but no pages | Direct baseline, another node, another network, one app — four contrasts |
| One app fails, others work | That app's own networking and the rule that matched |
| Certificate or DNS error | Multiple domains, correct system clock, then the client's DNS settings |
Cleaning up
- Turn the connection off and confirm plain networking returns.
- If a VPN profile remains, check for another VPN, filter or managed profile before deleting anything.
- Deleting a configuration profile on iOS also deletes the settings attached to it — that is why it is not a first step.
- On a managed device, ask the administrator rather than removing profiles.
Scope
This page describes import and verification. Menu names and supported formats follow the installed version and the App Store listing. Nothing here evaluates a provider or claims that a particular subscription imports cleanly.