Shadowrocket Config Backup and Device Transfer: iCloud Sync, Config Export, and Restore

Learn three ways to back up and transfer Shadowrocket: iCloud sync, manual Config export, and importing on a new device. See which settings to check after switching devices.

At a glance

When moving Shadowrocket to a new device, keep the Config file, the service details shown in Home, and a record of device settings separately. A synced file does not mean everything has been restored. This guide focuses on transfers between iPhone and iPad: back up the file separately, check its iCloud copy, then select the Config on the new device and test the connection. For transfers to other platforms, check each item against that platform’s supported import options.

1. Understand what Config includes—and what a device transfer covers

Config contains settings such as rules and DNS. Server and subscription details shown in Home, the current Global Routing selection, and system-granted VPN permissions should not automatically be assumed to be part of a Config file. A file may contain server definitions, or only rules that refer to external resources. Check the actual file contents to determine whether it is sufficient for a restore.

This guide assumes you already have your own service provider details and subscription. This site does not provide, sell, or recommend nodes or subscriptions. You do not need to send those details to this site during backup. Keep subscription URLs containing tokens, connection passwords, and protocol keys only in storage you control.

3 categories
Transfer items: Config, Home service details, and device settings
2 copies
Keep both: the original on the old device and a separate export
4 checks
Restore checks: file, service, routing mode, and system permissions
ItemWhat to keep before transferringWhat to check after restoring
ConfigThe file currently in use and any local editsRule order, DNS, external resource references, and the selected file
HomeThe original URL for each existing subscription, or the complete details for manually added servicesGroups, service entries, update results, and current selection
Global RoutingThe mode currently in use on the old deviceWhether the new device has the expected Config, Proxy, Direct, or Scene selected
On Demand and VPN permissionsA written record of trigger conditions and network exceptionsAuthorization on the new device, auto-connect conditions, and the actual network environment

2. Prepare the old device: pause edits and make a separate copy

During the transfer, pause Config edits on both devices. Cloud sync can transfer files, but edits or deletions in a synced folder may also propagate to other devices. It is not a substitute for keeping a separate historical copy. Export the file first, especially if you changed rule order, DNS, or external rule references.

  1. Open Config on the old device and note the name of the currently selected file. If several files have similar names, inspect them one by one to identify the one with your latest edits. Do not rely on sort order alone.
  2. In Home, record the current service group and selected entry. For manually added services, keep the address, port, protocol, authentication details, and the TLS or transport settings in use. A display name alone is not enough to recreate the connection.
  3. Record the current selection under Home → Global Routing. If you use Scene, note its conditions too; do not assume replacing it with Config will produce the same behavior.
  4. Check Settings → On Demand and record the auto-connect conditions and network exceptions. For now, just make a note; do not change working settings on the old device just for the transfer.
  5. After exporting the file below, open the copy and confirm its contents are readable. Keep the old device and its original data until the new device has been verified.
Check the original Export a copy Transfer the file Import on the new device Test the connection

3. Use iCloud: confirm the file is available locally before considering the restore complete

The iCloud approach is mainly for iPhone and iPad devices signed in to the same Apple Account. Distinguish between saving an exported file to iCloud Drive, which transfers a copy through the system file service, and using an iCloud sync option within the app, if available, whose scope depends on what that option actually shows. Neither confirms that Home details and all Settings have transferred completely.

  1. On both devices, open Settings, go to your Apple Account → iCloud, and make sure iCloud Drive is available. Menu names may vary by system version. If an iCloud access switch for Shadowrocket appears, check that it is enabled too.
  2. On the old device, export the Config file you need. In the system share sheet, choose Save to Files and save a copy in a transfer folder you create in iCloud Drive.
  3. Open the system Files app, go to that folder, and confirm the file appears and opens. If it is still waiting to upload or storage is full, resolve that first. Do not erase the old device.
  4. On the new device, open the same folder in Files. If the file has not downloaded yet, tap to download it and make sure you can read its contents—not just see its name.
  5. If a file with the same name has already appeared in Config through app sync, compare the contents before importing the copy to avoid creating duplicate configurations that are hard to tell apart.

Bottom line: use a readable copy as your transfer checkpoint

After the old device uploads the file, open that same file on the new device and check one custom rule. If you can see the name but cannot read the contents, troubleshoot sync before deleting any old data.

If the devices use different Apple Accounts, there is no need to switch accounts temporarily just to transfer a file. Use a file transfer method you control, then import it from Files on the new device. Do not put a credential-bearing Config in a publicly shared folder for convenience, or treat a shared link as a long-term backup.

4. Export Config manually: keep a copy and check external dependencies

Manual export is useful if you do not use iCloud, want a snapshot from before the transfer, or plan to review the configuration on another platform. Open the action menu for the target file in Config and use the share or export option shown in the current interface to save the actual Config file. Menu layouts may vary by platform and interface version. The goal is a readable copy of the file, not just its name.

  1. Select the Config file to keep, inspect its contents, and make sure your local edits have been saved.
  2. Open the system share sheet from the file’s share or export action, then choose Save to Files. If you need to transfer the file to another device, keep a local copy too.
  3. Give the copy a distinctive name, such as migration-before.conf, and keep its original file extension. Do not save a remote configuration URL as a text file and mistake it for a complete export.
  4. In Files, check that the file is not empty. Pay particular attention to [Rule], DNS-related content, and any entries you edited.
  5. If the Config references remote rule sets or other resources, record their sources and access requirements separately. Exporting the main file does not package those remote resources with it.

Check the file contents

File item
The Config currently in use
Local rules
Confirm custom entries such as DOMAIN-SUFFIX are still present
Rule order
Check the relative order of preceding match rules and FINAL
External references
Record their sources and separately check whether the new device can access them

Check the actual contents; matching file names or file sizes are not a substitute.

Check sensitive information

Subscription URLs
May contain active tokens; store them like credentials
Protocol authentication
Keep passwords, UUIDs, or private keys as required by the protocol
Manually added services
Keep the address and port together with the authentication and transport settings
Sharing scope
Limit it to devices and storage locations you control

When asking for help, share a redacted excerpt—not the full Config or subscription URL.

The example below illustrates how to identify rule order; it is not a general-purpose Config to overwrite your original during a restore. Rules are matched from top to bottom, and FINAL handles requests that did not match earlier rules. During migration, keep your own policy rather than changing your existing routing just because the example includes DIRECT.

[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY

5. Restore on the new device: import the file, then select it and grant permissions

Install Shadowrocket on the new device before importing. The iPhone and iPad version is a one-time $2.99 purchase on the App Store; check the App Store listing for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. See the download page for all platforms. The iCloud steps apply to Apple devices; for other platforms, use the file import route and check which settings the target platform supports.

  1. On the new device, find the backup in Files and choose Shadowrocket in the share sheet to import it. If the Config add menu offers file import, you can also select the same file there.
  2. Return to Config, check that the file appears in the list, and explicitly select the copy you restored. A successful import only means the file is in the list; it does not mean it is the active Config.
  3. Return to Home and check that your service details are complete. If a subscription is missing, reimport it using the original URL you kept. If a manually added entry is missing, restore its settings from your notes. Do not replace the original authentication details with a new blank entry.
  4. Set Home → Global Routing to the mode you expected from the old device. Select Config to route traffic according to Config rules. Proxy and Direct do not confirm that the original rules are active; with Scene, check the scene conditions too.
  5. Start a connection and allow the system to add a VPN configuration when prompted. VPN authorization is a local action on the new device; authorization on the old device does not remove the need to approve it again.
  6. After testing a manual connection, check Settings → On Demand. Restore the conditions for the new device’s Wi-Fi, cellular network, and actual usage, then watch for unexpected reconnects or disconnections.

6. Verify the restore: troubleshoot based on symptoms instead of repeatedly overwriting Config

Seeing a VPN status does not mean the transfer is complete. Test the connection, DNS resolution, and rule matching separately. Visit a site you use regularly and know the expected behavior for, then check the destination and policy in the connection log. You do not need to obtain another service for verification, and should not overwrite the restored file with an unfamiliar test configuration.

Why can I see the file in iCloud but not in Config?

A copy in iCloud Drive has not necessarily been imported. Download and open it in Files, then use the share sheet to send it to Shadowrocket. Return to Config, check the list, and select the target file. If app sync has already added an item with the same name, compare the contents before importing to avoid duplicates.

Why is Home still empty when all my rules are there?

First check whether your backup contains only rules and DNS, with no restorable service definitions. Reimport using the original subscription URL you saved, or restore manually added service details from your notes. Repeatedly importing a rules-only file will not restore entries in Home.

The new device behaves differently after connecting. What should I check first?

Check the currently selected file in Config, the active service in Home, and Global Routing in that order. Once all three match, compare DNS and remote resource loading. If the issue occurs only after switching Wi-Fi, check the conditions under Settings → On Demand rather than changing all settings at once.

The restore is complete on the new device. Can I delete the files on the old one now?

First verify the manual connection, rule matching, and network switching, then remove duplicate files. Deleting a file in a synced folder may also delete it on other devices. Before cleanup, save any migration snapshot you want to keep long-term in a separate location and confirm the copy is readable.

After verification, label the saved copy with its purpose, such as “original before transfer” or “copy verified on new device,” and store it separately from the Config you edit day to day. Before future remote Config updates or rule changes, follow the same backup steps to make files easier to identify and changes easier to trace.

Get Shadowrocket and continue setup

The iPhone and iPad version is a one-time $2.99 purchase on the App Store; check the App Store listing for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Visit the download page to choose your device, or continue to the first connection guide.

Download Shadowrocket