Node HandbookNODE HANDBOOK中文
Shadowrocket · iOS

Shadowrocket: importing a subscription on iPhone or iPad

The app is a rules-based client for Apple platforms. Buying it gives you the software, not a line — the subscription comes from your provider, and the format has to match what the app accepts.

Node Handbook editorial team ·

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

PathAcceptsFails when
Subscription URLA remote configuration or list the client can parseThe address returns HTML, a login page or an unsupported format
QR codeWhatever the code encodesThe code encodes a single node but you expected a subscription
Share linkOne nodeYou expected a list; one link produces one entry
File importA configuration file from Files or iCloud DriveThe 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

  1. Entries exist. If the list is empty, go back to what the address returned before touching any setting.
  2. One is selected. A list without a selection produces no traffic.
  3. 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

SymptomFirst check
Node list emptyWhat the address returned; whether the format matches the client
Connected but no pagesDirect baseline, another node, another network, one app — four contrasts
One app fails, others workThat app's own networking and the rule that matched
Certificate or DNS errorMultiple 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.