Shadowrocket Backup and Transfer Guide: Sync with iCloud or Export Config to a New Device

Move Shadowrocket to a new device with iCloud sync or by exporting and importing a Config file. After setup, check that subscriptions, rules, and Global Routing are restored.

At a glance

This guide is for users who already have their own connection details and subscriptions and are switching devices or reinstalling Shadowrocket. First, distinguish connection details in Home, configuration files in Config, and runtime settings on the device. Then choose iCloud sync or file transfer. Verify each item afterward—seeing a file does not mean everything has been restored.

1. Identify the Three Types of Data Before You Transfer

Transferring Shadowrocket is more than copying a file. Servers, subscription sources, and the currently selected connection in Home; rules and DNS settings in Config; and runtime preferences in Settings are separate items to check. Exporting one Config file does not mean all Home data has been saved.

iCloud sync works for Apple devices signed in to the same iCloud account. Exporting files gives you a separate copy you can retrieve independently and can also transfer compatible configuration content to other platforms. For transfers between Mac, Windows, Android, and Linux, check what the destination platform can import. iCloud is not a general-purpose cross-platform transfer method.

Connection Details and Configuration Files

Home
Record subscription sources, groups, manually added connections, and the currently selected connection.
Config
Record the file currently in use, including local changes, rules, and DNS settings.
External Dependencies
Note remote rule URLs and any other referenced files, and make sure they can be retrieved on the new device.

A Config file may not include all connection credentials and subscription sources.

Device Runtime State

Global Routing
Record the Config, Proxy, Direct, or Scene currently in use on the old device.
On Demand
In Settings → On Demand, note whether it is enabled and what triggers it.
System Permissions
Confirm system VPN permission again when connecting for the first time on the new device.

Restoring configuration content does not restore the selected options or device permissions automatically; check those separately.

Keep the old device in a working state before you start. Don’t reorganize rules, update subscriptions, and start syncing all at once; if something changes, it will be hard to tell which step caused it. This guide does not provide, sell, or recommend connection services or subscriptions. The steps assume you already have your own connection details.

2. Back Up in Order and Keep a Recoverable Copy

Sync and backup serve different purposes. Sync propagates changes and may also propagate deletions; an independent export preserves a snapshot from a particular point in time. Before switching devices, use both: export a local copy first, sync next, then verify everything on the new device.

Review your data Export a separate copy Sync data Import on the new device Verify each item
  1. On the old device, open Home and note subscription group names, the number of manually added connections, and the currently selected connection. Don’t share screens containing passwords in public chats.
  2. Open Config and check which file is actually in use. If the list contains several similarly named files, distinguish local copies from remote sources.
  3. Save any changes to the file before exporting it. You can use migration-before.conf as a backup filename you create yourself to avoid overwriting the original.
  4. Note the current Global Routing and Settings → On Demand settings. This record helps you restore behavior; it doesn’t mean the old and new devices must use identical network conditions.
  5. Keep the old device until subscriptions, rules, and an actual connection test have been verified on the new one. A successful first launch is not a reason to erase the old device.

3. Sync with iCloud to a New iPhone or iPad

First, confirm that both devices are signed in to the same Apple account for iCloud. Your App Store purchase account can differ from your iCloud account, so a restored purchase does not prove that the iCloud accounts match. Installing the app and syncing its configuration are separate steps.

  1. On the old device, go to the system’s Settings → Apple Account → iCloud and make sure iCloud Drive is on. Check that you have enough available storage. The names of system menus may vary slightly by OS version.
  2. In the iCloud app list, check that Shadowrocket is allowed to use iCloud. If the list is collapsed in your current system version, expand it to see all apps.
  3. Open Shadowrocket → Settings and check which iCloud sync or backup options are available in your version. Follow the data scope shown in the app; an iCloud device backup is not the same as in-app sync.
  4. After the old device has saved and uploaded its data, enable the same iCloud settings on the new device. If the app offers upload, download, or restore options, make sure the source is the valid copy from the old device.
  5. Check Home and Config separately on the new device. Seeing a configuration file only confirms that the file arrived; it does not prove that subscription sources and all runtime preferences were restored.

If the interface has no sync option for a particular type of data, don’t assume it will move automatically with other data. Verify manually added connections, subscription URLs, and local Config files separately. Keep the network available during sync and use the app’s completion status to confirm success—don’t rely on a fixed wait of a few seconds.

In short: Confirm the old device uploaded its data before restoring on the new device

If the new device has no data yet, check the sync direction and any conflict warnings first. Don’t repeatedly overwrite data before you can see a valid copy. If in doubt, pause sync and continue with the independently exported file.

4. Export Config and Import It on the New Device

The key to file transfer is knowing exactly what you exported. A Config file mainly contains configuration text; connections and subscription sources stored separately in Home must be restored using their own export options or original details. If you only have a rules file, missing connections do not mean the file is corrupted.

  1. On the old device, open Config, find the file to transfer, and check its name and contents. Open the file’s action menu and use the share or export option available in the current interface.
  2. Use the system share sheet to save the file in your own folder in the Files app, or send it to a destination device you control. Keep the original file extension. Don’t copy configuration content into a rich-text note and then import it.
  3. Reopen the file from its saved location and make sure it isn’t empty. Check that the rules section is present and that the key lines you edited are intact.
  4. On the new device, use the import option in Config or share the file with Shadowrocket from the system Files app. Available options depend on the destination platform’s interface.
  5. After importing, select that Config file, then return to Home and check Global Routing. Importing a file into the list and enabling it are separate steps.
  6. Restore subscription sources or manually added connections in Home. If the old device had no relevant export option, add them again using the original connection details you saved.

When transferring across platforms, import a copy first. If the destination reports an unsupported field, keep the original file and investigate the warning item by item. Don’t delete an entire DNS or rules section just to clear an error. Remote rules, certificate references, and local file paths may depend on the old device and need separate attention.

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

This is a rule snippet for checking syntax, not a complete migration file. DOMAIN-SUFFIX matches a specified domain suffix; the IP-CIDR example matches a private address range; GEOIP matches by geographic location; and FINAL provides a fallback. Rules are evaluated in order, so when transferring them, check their position as well as the number of lines and the target policy.

5. Verify Subscriptions, Rules, and Routing Mode

After restoring, check the saved data first, then verify runtime behavior. If the system asks for VPN permission on the first connection, approve it on the new device; permission on the old device does not carry over. During testing, disable any On Demand conditions that could trigger an automatic connection, to avoid unexpected state changes.

Test at least two cases: a destination that should use PROXY according to your rules, and one that should use DIRECT. Send a new request, then check its destination, matched rule, and outbound result in the connection log. A webpage loading doesn’t prove that the rules were restored correctly; Direct or an existing connection can produce the same result.

6. Common Transfer Issues and How to Resolve Them

Why can’t I see my configuration after signing in on a new phone?

First, check the signed-in account in the system’s Settings → Apple Account → iCloud, then check iCloud Drive and Shadowrocket permissions. Check the in-app sync status on the old device. Reinstalling the app from the App Store alone does not restore its configuration; you must restore it separately.

Why is Home still empty after importing Config?

First, check what the exported file actually contains. Rules and connection details may be stored separately. Re-import using your saved subscription source or transfer your manual connection details, then select the connection you want to use in Home.

My subscription is restored, but updates keep timing out. What should I do?

Check that the URL is complete, especially any token parameters after the question mark. Make sure the device has a working network, then check whether the subscription URL requires an existing working connection. Don’t keep switching Global Routing without a working connection. If the URL is no longer valid, check with the provider of your own subscription details.

The rules are the same, but everything goes direct on my new phone. What’s missing?

Return to Home and check whether Global Routing is set to Direct, then confirm that the intended file is enabled in Config. Select Config and send a new request; check the match in the connection log. If you use a Scene, check whether it selects a different routing mode.

The connection works, but its status changes when I switch Wi-Fi. Is that normal?

Go to Settings → On Demand and check the network triggers, then check the VPN status in the system settings. Turn off automatic triggers and reproduce the issue with a manual connection. Once it’s stable, restore the conditions one at a time to avoid changing several settings at once.

7. Clean Up the Old Device After Verification

Keep the old device until the new one has completed at least one subscription update, one rule-match check, and one test switching between Wi-Fi and cellular data. If the device has no cellular connection, test with another known working network. Record the actual result of each step, not just “imported.”

After confirming the transfer is complete, clean up the old device according to your own device-management plan. Keep the independent backup in a controlled location; don’t treat it as the only copy in your everyday sync folder. For more detailed network troubleshooting, see Troubleshooting. To review the basics, see the User Guide.

Download Shadowrocket