Shadowrocket Backup & Transfer Guide: iCloud Sync, Config Export, and Restore

Before upgrading your iPhone, protect your Shadowrocket setup: sync or export your Config, restore it on the new device, then verify subscriptions and rules.

At a glance

When moving to a new device, check Shadowrocket’s Home for servers and subscriptions, Config for rule files, and Settings for device preferences. This guide is for users who already have their own provider and subscription. First, understand the difference between iCloud file sync and a full backup; then save a separate copy you can restore, and verify the Config, subscription updates, and automatic connection on the new device. Seeing a file in the cloud does not mean all connection details and system permissions have transferred.

1. Decide what to back up: a Config file is not a complete backup

Home, Config, and Settings serve different purposes in Shadowrocket. Home manages servers, subscriptions, and the current selection; Config manages configuration files and their rules; Settings contains app preferences. Exporting a rule Config does not guarantee that it includes Home subscription credentials, manually added servers, or every setting.

Before migrating, check which Config is active on the old device, note its filename and the Global Routing setting, and record the selected server or policy in Home. If you have multiple Configs with the same name, open and inspect their contents rather than relying on the filename. This guide does not provide, sell, or recommend nodes, subscriptions, or connection services. Keep your own service details safe.

3 areas
Check Home, Config, and Settings separately
4 items
Global Routing:Proxy / Direct / Config / Scene
2 copies
Keep a cloud copy and a separate export

2. Set up iCloud and verify the files reach your new device

iCloud Drive file sync, iCloud features provided by the app, and a full-device iCloud Backup are separate mechanisms. iCloud Drive primarily syncs files; whether app data syncs, and which data is included, depends on the options the app actually provides and what appears on the new device. Turning on iCloud Backup does not guarantee that a Config file will be available to open immediately on another device.

On your iPhone, check the account under Settings → Apple Account → iCloud, then open Drive and turn on Sync this iPhone. Depending on your system version, this may appear as iCloud Drive. If Shadowrocket appears in the iCloud app list, check its toggle too. If it does not, do not assume Home data will sync automatically; you can save exported files to iCloud Drive using Files.

Two restore options: choose what works for your setup

iCloud file sync
  • Useful for transferring Config files between devices on the same iCloud account.
  • In Files, go to Browse → iCloud Drive and check that the file opens.
  • If the app offers an iCloud sync option, verify what it syncs, item by item.
Restore from a separate file
  • Useful when changing iCloud accounts or keeping an archive copy.
  • Export the file and save a separate copy instead of relying only on a folder that stays in sync.
  • Save subscription sources and manual server details separately.

Sync transfers the current state; a separate copy lets you roll back. Use both, and verify an actual restore rather than relying on sync being turned on.

After the old device finishes uploading, open Files on the new device and go to Browse → iCloud Drive. Download and open the target file, then check its name and contents. The cloud download icon disappearing only means the file has downloaded; confirm it is the copy you just exported. If it is missing, check the account, available iCloud storage, network, and upload status first. Do not keep creating blank Configs with the same name.

3. Export Config and subscription details in five steps

Save a verified working state before changing rules or updating a subscription. The file actions in Config may look different depending on the interface. Open the target file’s action menu and look for Share or an export option; do not mistake “Copy filename” for “Export file.” After exporting, check in Files that you have a real, readable file.

  1. Confirm the active Config

    Open Config, identify the file in use, and note the Home → Global Routing setting. If you use Scene, record its conditions and the corresponding selection too.

  2. Export the file

    In Config, open the target file’s action menu and choose Share or an export option. Then select Save to Files in the system share sheet. Note the destination folder so you do not overwrite your only usable copy.

  3. Save the subscription source

    In Home, check the details for existing Subscribe items and save your original subscription URL separately. A group name alone is not enough to retrieve servers on a new device.

  4. Record manual entries

    Save the protocol, address, port, and authentication fields for each manually added server. If TLS is involved, check the related parameters too. Different protocols cannot be substituted for one another using only an address and port.

  5. Open and verify the copy

    Open the saved Config in Files and confirm that it contains rules and is not blank. Keep the file distinct from subscription credentials, and note what you will need to set up again on the new device.

A subscription URL usually grants access to an account and should not be shared like an ordinary web address. The example below shows only the format; it is not a working service. To restore, use the original URL you saved yourself. Do not copy text from chat history if it has been truncated or had characters replaced.

https://example.com/sub?token=xxxx

If your Config references remote rules or other external resources, exporting the main file does not package those resources for offline use. Record their sources and any access requirements, then check that they load after restoring. Before asking someone else for help, make a sanitized copy and remove subscription tokens, passwords, UUIDs, private keys, and other credentials instead of sending the original.

4. Restore on the new device: Config first, subscriptions next, then connect

On the new device, check the download page for platform options. iPhone and iPad: $2.99 one-time purchase on the App Store. Mac (Apple silicon and Intel), Windows, Android, and Linux: free. For iPhone and iPad, see the App Store listing for system requirements. Installing the app and restoring your Config are separate steps; seeing the app on your Home Screen does not mean your old data has transferred.

  1. Retrieve the file: Find the backup in Files on the new device and download it. Share it with Shadowrocket or use the file import option in Config. Open and inspect the imported file, then select it as the active Config.
  2. Restore subscriptions: First check Home for the relevant Subscribe item to avoid adding a duplicate. If it is missing, tap “+” in the upper-right corner of Home → Type → Subscribe, enter your original subscription URL, and save it. Then update the subscription.
  3. Check manual servers: Restore each separately saved entry and verify its protocol, port, and authentication fields. There is no need to re-enter servers already provided by an updated subscription.
  4. Set routing: If you want to use rules, set Home → Global Routing to Config. A successful test in Proxy does not confirm that every rule in Config has been restored correctly.
  5. Allow system configuration: The first time you connect, follow the system prompts to allow a VPN configuration and complete device verification. Authorization on the old device does not grant permission on the new one.

While restoring, leave Settings → On Demand off or disable automatic connection. Manually connect and disconnect once. After confirming that the rules and server selection are correct, restore only the conditions you need. Do not enable every automatic connection condition at once just to reproduce the old device’s setup.

5. Check rules and On Demand: the same file can behave differently

Proxy, Direct, Config, and Scene in Global Routing are different operating modes. Proxy and Direct can help troubleshoot, but they do not replace testing rules in Config. With Scene, check the scene conditions too. If you can connect after migrating but traffic is routed differently, first check the active mode and selected Config, then inspect the rule order.

Config checks

DOMAIN-SUFFIX
example.com,DIRECT
IP-CIDR
192.168.0.0/16,DIRECT,no-resolve
GEOIP
CN,DIRECT
FINAL
DIRECT

These examples show matching syntax only; they are not a complete routing setup. Preserve the policy references and rule order from your existing Config.

Device settings checks

Routing mode
Home → Global Routing
Rule-based mode
Config
Automatic connection
Settings → On Demand
Test in this order
Manual connection → access check → automatic conditions

Test a manual connection first, then restore automatic conditions one at a time. Also check the corresponding VPN configuration status in the system settings.

Rules are checked in order, with FINAL at the end as the fallback. DOMAIN-SUFFIX matches a domain and its subdomains. IP-CIDR matches an address range; no-resolve in the example means the rule does not actively trigger a DNS lookup. GEOIP relies on geographic data for the destination IP. Changing the order, losing remote rules, or modifying DNS during migration can change the results.

Pay special attention to policy references. If the old Config refers to a policy named PROXY or a custom group, the new device must have a matching definition or an available selection. Keeping the name in the file does not mean it points to the right server. If a policy is unavailable after import, check its name and definition; do not try to hide the issue by arbitrarily rewriting FINAL.

6. Common migration issues and how to roll back

Why is Home still empty when the file is in iCloud?

First check whether the synced item is a Config file or an app backup. Rules in Config do not mean Home’s Subscribe items have been restored. Check the item list in Home. If an item is missing, tap “+” → Type → Subscribe, enter the address you saved, and update it.

My old phone works, but subscription updates fail on the new one. What should I do?

First check that the URL is complete, includes the current token, and that the network can reach the subscription source. If you already have a working connection, try updating while connected to help identify a network-path issue. If it still fails, check the subscription status with your provider. Do not delete the only working record on your old device.

The file imported successfully. Why aren’t rules routing traffic as expected?

Check, in order, which Config is selected, whether Home → Global Routing is set to Config, whether the policy references exist, and whether FINAL is at the end. Then use the connection log to inspect how the destination actually matches, rather than checking only whether the connection is on.

My new phone keeps connecting automatically. Can I stop it first?

First check Settings → On Demand and disable the relevant automatic conditions. Then go to system Settings → General → VPN & Device Management → VPN and check Connect On Demand for the corresponding configuration. Once disabled, disconnect manually and check the connection status.

Something isn’t working after the restore. Can I go back to my previous Config?

Keep a copy of the current state, then import the separate Config you saved before migrating and explicitly select it. Restore the recorded Global Routing mode and server selection, then test manually. Do not try to roll back by editing the same cloud file on both devices at once.

A restore is complete when subscriptions update, rules match as expected, manual connections work, and On Demand conditions suit the current device and network. Keep the old device until all these checks are done. If your provider limits the number of concurrent devices, follow your service terms when testing both devices.

7. Migration checklist

Use the same process for future maintenance: save an identifiable copy before changing important rules, subscription sources, or automatic connection conditions. If something goes wrong, restore one area at a time to distinguish file content, service details, and device settings. Avoid changing several things at once, which makes the cause harder to find.

Download Shadowrocket for all platforms