Shadowrocket
Troubleshooting
Work through issues in order: getting the app, installing it, importing details, and connecting. Identify the step that failed, then change one condition at a time. The exact error message is more useful than repeatedly reinstalling.
Purchase and availability
Check how to get the app for your device, then verify the store listing, purchase account, and compatibility.
Can you use Shadowrocket on a computer or Android? How much does it cost on each platform?
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 your device on this site’s download page; desktop and Android installers are served from /dl/shadowrocket/. Buying the app does not include a service plan. You’ll need your own subscription or server details from your provider; purchasing the app does not provide a server to connect to.
How can you verify the official Shadowrocket listing on the App Store?
Don’t rely on the name in search results alone. Open the product page and check the developer, Shadow Launch Technology Limited, the official icon, and app ID 932747118 in the product URL. Compare the icon with the official 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. A free listing with the same name in the store is not the iPhone or iPad version covered here; get the desktop or Android installer from this site’s download page.
Can’t find Shadowrocket in the App Store? Check this first
Check the storefront region for your App Store account, not just your device’s language or region. The app is currently unavailable in the mainland China storefront. On your device, go to Settings, tap your Apple Account, open Media & Purchases, then check Country/Region under View Account. If you need to change regions, follow Apple’s official account instructions and check your balance, active subscriptions, and payment method requirements first. Avoid repeatedly switching regions. You can also open the product page linked here to see the current message from your storefront.
Do you need to buy Shadowrocket again after changing or reinstalling a device?
On a new iPhone or iPad, sign in to the App Store with the account used for the original purchase, then find Shadowrocket in your purchased apps and download it again. The list name 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 and can be downloaded again from this site. If the store still shows a purchase button, check your purchase history and account before paying again. Reinstalling the app does not restore its configuration, so back up your settings and subscriptions beforehand.
Can you install Shadowrocket on iPad? Are the system requirements the same as on iPhone?
Yes, Shadowrocket can be installed on iPad. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. With the original purchase account, you can redownload the app from your purchased apps on another compatible iPhone or iPad. Check the App Store page for the current system requirements rather than relying on an older guide. Check local configuration, VPN permission, and connection status on each device separately. For simultaneous use, check the terms provided by your service provider.
Installation and first launch
Check the installer source and device architecture first. Only allow an app through system protections after confirming its source, and assess any specific warning separately.
Mac Apple Silicon or Intel: which Shadowrocket version should you download?
Open About This Mac from the Apple menu. If it lists a Chip with an Apple M-series name, choose Mac Apple Silicon; if it lists an Intel processor, choose Mac Intel. Don’t judge by the computer’s appearance or purchase year. Both downloads are on this site’s download page. Choose the matching DMG and install it. If macOS blocks the app on first launch, confirm that it came from this site’s /dl/shadowrocket/ path, then check the notice under System Settings → Privacy & Security and select Open Anyway if needed. You don’t need to switch to the other chip version.
Mac says the developer can’t be verified or the app is damaged. What should you do?
Confirm the installer came from this site’s download page and that the app is in Applications. If macOS says the developer can’t be verified, try opening the app once, then go to System Settings → Privacy & Security, select Open Anyway, and confirm. If macOS says the app is damaged, download and install it again. Once you’ve confirmed the source, you can run xattr -cr /Applications/Shadowrocket.app in Terminal, then reopen the app. This removes the quarantine attribute for this app; don’t disable system protection globally. If the device is managed, contact its administrator first.
Windows SmartScreen warns that Shadowrocket may be risky. How can you proceed?
Check that you got the file from this site’s download page, with a URL under /dl/shadowrocket/. If SmartScreen says “Windows protected your PC,” confirm the source, then select More info → Run anyway and handle any subsequent permission prompt. Don’t treat all warnings alike: if an organization policy, device management rule, or security software reports a specific threat, read the details and check with your administrator rather than disabling all protection. If the download is incomplete, download the file again instead of repeatedly launching the same copy.
What permissions do Android and Linux need for the first installation?
On Android, download the arm64 installer from this site. If installation is blocked, temporarily enable Allow from this source for the browser or file manager you used to open the file, then disable that permission when installation is complete. On Linux, choose deb, rpm, or AppImage for your distribution. For AppImage, run chmod +x Shadowrocket.AppImage before launching the file; replace the filename in the command with the name of your download. If you encounter a device management policy or dependency error, address the specific message rather than assuming every failure is a permissions issue.
The interface is in English, so how can you follow the guide?
This manual uses the interface labels as they appear in English: Home shows servers and connection status, Add Server adds a server, Config manages configuration files, and Settings contains app settings. Find these sections first, then match the fields you need. Don’t rely only on button colors or locations in old screenshots; system versions, screen sizes, and app updates can change the layout. If an item has moved, look for its current label. In Global Routing, Config, Proxy, and Direct are routing modes—not server types or app versions.
Subscriptions and server imports
Distinguish between an unreachable link, content that won’t parse, and a list display issue. Keep existing groups and configuration before making changes.
Subscribe import failed. What should you check first?
First, make sure you already have a subscription URL from your provider. Check that it contains no extra spaces, line breaks, quotation marks, or explanatory text, then confirm the link is still valid, your access is active, and the current network can reach it. In Add Server, select Subscribe and enter the URL as directed by your provider. Don’t use an account management webpage as the subscription URL. If parsing fails, keep the error message and ask your provider whether the response is in a format Shadowrocket can read. If the connection times out, check network access and whether the subscription URL is reachable; these errors need different fixes.
How do you add a server in Add Server if you only have its connection details?
Open Add Server and select the protocol that matches your connection details. Enter the server address, port, and authentication information in the corresponding fields; the wrong protocol will prevent a connection even if the address is correct. For additional fields such as TLS and SNI for Trojan or keys and Peer for WireGuard, use the details from your provider—don’t apply instructions for another protocol. Save, return to Home, select the server, and test the connection. If your details came as a QR code, use Scan QR Code to import them, then check the protocol and address after saving. Don’t mistake another QR code on the information page for server details.
How do you update a subscription? Will an update overwrite manual changes?
On Home, find the subscription group and use its management option to update it. When the update finishes, check the server list and any error messages; the exact option may vary by interface. Updating reloads the subscription source, so entries removed from the source may disappear, and local edits to subscription entries may be replaced. Manage manually added servers separately if you need to keep them, and back up important settings and configuration first. If an update fails, keep the existing content, note the error, and check the link and network before deleting a group that still works.
The import says it succeeded, but no servers appear. Why?
Return to Home and check whether the subscription group is collapsed or a search or filter is active. Then make sure you didn’t import into another group with the same name. A completed import only means the process finished; it doesn’t guarantee that the subscription returned usable server entries. An empty source, unsupported format, or changed access permissions can leave the list without the expected items. Check the group’s update message and verify the link with your provider. Avoid importing repeatedly and creating duplicate groups. Keeping one clear subscription entry makes it easier to assess the result of an update.
What’s the difference between Subscribe and Config? Do you need to import both?
Subscribe is generally used to retrieve and update a server list. Config manages rules, policy references, and other configuration options; they serve different purposes. Having servers doesn’t mean you already have routing rules suited to your needs, and importing a Config file doesn’t guarantee that its policy names match your available servers. Whether you need either one depends on the information you already have. Don’t import files you don’t understand just to fill in the sections. Back up your current configuration before switching Config, and check the policy names used by its rules. To test a new server, use a clear test mode to isolate the effect of your rules.
Routing rules and troubleshooting
Check system permission, the server connection, rule matches, and destination access separately. Connection status is only one part of the test.
How do you choose Config, Proxy, or Direct in Global Routing?
Config follows the rules in your current configuration to route traffic. Proxy sends traffic handled by the app through the selected server. Direct is useful for checking your local network without routing through a server. Use Config for rules you’ve already checked; for an initial server test, temporarily use Proxy, then restore your previous setting. Proxy doesn’t guarantee the server is working, and Config doesn’t mean every request will use a proxy. Check rule match records and test actual access to confirm the result.
The connection switch won’t turn on, or turns off immediately. How do you troubleshoot it?
First, make sure a server is selected on Home and its details are complete, then turn on the connection switch. The first time you connect on iPhone or iPad, allow Shadowrocket to add a VPN configuration and complete any device verification requested by the system. If you canceled, try again and allow it. If the switch still turns off immediately, check System Settings for another active VPN, a managed configuration, or permission restrictions, then review the error shown by the app. Don’t change the server, rules, and DNS at the same time. Keep your current configuration and note the steps that fail. Restart the device if needed, and avoid repeatedly changing subscriptions before system permission is granted.
Connected, but can’t access the internet? What should you check, and in what order?
A connected status means the local connection process is established; it doesn’t guarantee every destination will respond. Disconnect Shadowrocket first to check that your regular network works. Then confirm the selected server is still valid and run Connectivity Test. Next, temporarily use Proxy to test the same destination. If it works in Proxy but not Config, check rule matches, policy references, and FINAL. If both fail, check the server details, network, and DNS. Change one condition at a time and note whether the results differ on Wi-Fi and cellular, so you can identify which setting caused the problem.
Connectivity Test succeeds, but a website still won’t load. Why?
Connectivity Test reports the result for its test destination and the connection at that moment. It can’t confirm that every website, app, or protocol is accessible. First check whether one domain or all requests are failing, then review the rule and policy that the request actually matched. If the rule sends it to DIRECT, check the local connection; if it sends it to PROXY, check whether the selected server can reach the destination. Also consider DNS resolution, an outage at the destination, or the app’s cache. Compare results using the same destination. Before sharing diagnostics, remove subscription URLs, authentication details, and personal browsing records.
Battery use increases after enabling Shadowrocket. What should you check in On Demand?
Start by checking your system’s battery usage breakdown for foreground use, background activity, and periods of actual data transfer. Don’t judge an issue from a single percentage. Repeated retries after failed connections, sustained high data use, detailed logging, and network changes can all increase activity. If On Demand is enabled, check whether its Wi-Fi, cellular, or domain conditions are triggering each other. For troubleshooting, temporarily disable On Demand, confirm that manual connections are stable, then restore its conditions one at a time. Compare the same usage scenario before and after each change. Don’t turn off several settings at once or rely on a fixed battery-use percentage as the measure of normal behavior.