Official Manual · Troubleshooting
Shadowrocket
Installation & Connection Issues
First identify where the problem occurs, then follow the relevant section. The steps below use the iPhone and iPad interface as examples; desktop and Android installation issues are covered separately.
Select a question to expand its answer. You can open multiple answers to compare them. Before changing an existing subscription or server, keep a copy of the original information.
STORE / ACCOUNT
Verify Purchase & Get the App
Check where you got the app and which account made the purchase before troubleshooting store regions, device transfers, or compatibility.
Read the purchase verification guide →How do I get Shadowrocket for iPhone or iPad versus other platforms?
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 iPhone or iPad, use the App Store product page linked here; check the App Store listing for system requirements. For other platforms, choose the matching installer on this site’s download page. Installers are under /dl/shadowrocket/. If your system blocks the installation, check the relevant instructions under “Installation and first launch” before deciding whether to allow it.
Can’t find Shadowrocket in the App Store? What should I check first?
Check the country or region of the Apple ID’s store, not your device language or current network location. Shadowrocket isn’t available in the mainland China store. On your device, open Settings, tap your Apple Account, then Media & Purchases, View Account, and check Country/Region. To change it, use Change Country or Region on that page and follow Apple’s instructions for your balance, subscriptions, and payment details. Don’t keep changing regions just to alter search results.
How can I verify Shadowrocket in the App Store?
Check that the developer is Shadow Launch Technology Limited, compare the listing with the official icon shown on this site, and verify that the product link ends with app ID 932747118. Don’t rely on the name or a similar-looking icon in search results alone. On the product page, confirm device compatibility and purchase details. If the search result doesn’t match all three checks, return to the product page linked on this site. Get the desktop and Android versions from this site’s download page, not from search results for similarly named installers.
Do I need to buy Shadowrocket again when I replace my iPhone or reinstall it?
The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. When replacing a device or reinstalling, sign in with the Apple ID used for the original purchase, then find Shadowrocket in App Store purchases and download it again. If the page still shows a price, check the purchasing Apple ID and store region before proceeding; don’t pay again without checking. A purchase record doesn’t back up your configuration. Save or re-import servers, subscriptions, and rules from the original device separately.
Can I install Shadowrocket on iPad, and does the iPhone purchase cover it?
Yes. The iPhone and iPad version costs $2.99 as a one-time App Store purchase, and both devices can use the same purchasing Apple ID. The Mac, Windows, Android, and Linux versions are free. On iPad, sign in with the Apple ID used for the purchase and find Shadowrocket in your App Store purchases. Check the App Store listing for system requirements. You’ll still need to import your own server or subscription and grant connection permissions. Configurations from your iPhone won’t automatically appear in full on iPad just because the purchase is shared.
Does buying Shadowrocket include a working proxy server?
A one-time app purchase is not a proxy 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. These are the two ways to get the app, not server plans. Before configuring Shadowrocket, you’ll need your own subscription or server details. This site does not provide servers or subscriptions. If you encounter authentication, expiration, or connection errors after importing, check the settings and status of your existing service instead of buying the app again.
INSTALL / PERMISSION
Installation & First Launch
Tell apart an incompatible installer, a system block, and an unapproved connection permission instead of treating them as the same issue.
See steps to allow installation →Can I use Shadowrocket on desktop or Android?
Yes. The Mac versions for Apple silicon and Intel, plus the Windows, Android, and Linux versions, are free. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. Choose the version for your device from this site’s download page; don’t use an installer intended for a different operating system. Desktop and Android installers aren’t code-signed, so the first launch may trigger a system warning. On Windows, check SmartScreen; on Mac, check Privacy & Security; on Android, check the setting to allow installation of unknown apps. See the related answers below for steps.
Which Shadowrocket version should I download for Mac: Apple silicon or Intel?
Open the Apple menu and select About This Mac. Check the Chip or Processor entry. Choose the Apple silicon version if it shows an Apple chip, or the Intel version if it shows Intel; don’t guess based on the Mac’s appearance or purchase year. Both downloads are in the Mac section of this site’s download page. Move the app to Applications before opening it. If macOS says it can’t verify the developer, confirm the source using the next Mac security instructions, then follow the steps in Privacy & Security.
Windows SmartScreen blocks Shadowrocket. What should I do?
First, confirm that you downloaded the installer from this site’s download page, under /dl/shadowrocket/. If SmartScreen blocks it, select More info, verify the app, then choose Run anyway. Your organization’s policies may hide that option; if so, contact your device administrator rather than changing security settings for the entire device. If the warning comes from another security component, or you can’t confirm where the file came from, cancel and note the full warning before investigating further.
Mac says the developer can’t be verified or the app is damaged. How can I open it?
First, confirm that the file came from this site’s download page, then move Shadowrocket to Applications. If macOS says the developer can’t be verified, try opening the app once, then go to System Settings > Privacy & Security, find the blocked app entry, and choose Open Anyway. If macOS says the app is damaged, only after confirming the source and app path, run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening it again. If your device is managed by an organization, follow the administrator’s instructions; don’t disable system-wide protections.
Android or Linux blocks the first launch. What should I check?
On Android, first confirm the installer came from this site. In system settings, allow the browser or file manager you’re using to open the file to install unknown apps. You can turn off this permission afterward. On Linux, choose the deb, rpm, or AppImage that matches your distribution. For an AppImage, allow execution in the file’s properties or run chmod +x followed by the actual filename, then launch it. If device policies block installation, contact your administrator rather than bypassing organizational restrictions.
The Home connection switch won’t turn on, or the interface is in English. How do I troubleshoot it?
On Home, select a server with complete settings, then try turning on the connection switch. Watch for a system prompt to add a VPN configuration. On iPhone or iPad, grant permission when prompted; if you dismissed the confirmation, try connecting again. If it still fails, stop any other active VPN connection and check for device management restrictions. In the English interface, use Home, Config, Data, and Settings to find the relevant screens rather than guessing from icons. This manual keeps interface labels in their original English.
IMPORT / SUBSCRIBE
Subscriptions & Server Imports
These steps assume you already have your own subscription or server details. Identify what you have first, then choose the appropriate import option.
Do subscriptions and individual server share links use the same import option?
Not always. First determine whether you have a single server share link or a subscription URL that returns a list of servers. For a single server, use Scan QR Code or an available option under Add Server. For a subscription, choose Subscribe under Add Server and enter your existing subscription URL. Don’t enter a subscription URL as a server address in protocol settings, or combine multiple share links into one URL. After importing, return to Home and check that the group and its entries appear.
Subscribe import failed. What should I check, and in what order?
First, make sure the copied URL is complete and has no leading or trailing spaces, line breaks, or extra text added by a messaging app. Confirm that it’s a subscription URL, not a login or account management page. Then check whether your existing service has expired, the URL has been reset, and your current network can make the request. Note the specific error and troubleshoot request failures, authentication failures, and content parsing errors separately. Don’t share a complete subscription URL containing access credentials in public screenshots or discussions.
How do I update an existing subscription, and what should I save first?
On Home, find the subscription group and open its editing or action menu. Use the update option available in your current version; changing the notes for one server alone won’t update the subscription. Before updating, note your selected server and back up any settings you changed manually, since new subscription content may replace entries or remove older ones. After the update, check server names, the number of entries, and your current selection, then test the connection. If the update fails, keep the existing entries; there’s no need to delete the whole group right away.
No server appeared after scanning a QR code. Should I scan it again?
First, check that the QR code contains complete server share information or recognizable subscription content, not a link to an account webpage. When using Scan QR Code, allow camera access and make sure the entire code is clear and visible. For an image in your photo library, use the image recognition option available in the current interface. If an error appears, check its cause before trying again; repeated scans may create duplicate entries. After a successful scan, return to Home and compare the imported details with your existing server information.
Add Server asks for many details. Which fields should I never guess?
Type, server address, port, and authentication details must match your existing server information. Enter TLS, SNI, and transport settings according to the service details as well. Don’t treat SNI as a free-form note or disable TLS checks without a specific reason. Field meanings differ across protocols such as Shadowsocks, VMess, VLESS, and Trojan. Save and test a single server before adding it to your everyday setup. If you’re missing details, check the documentation for your existing service.
How should I organize subscriptions and configurations before changing devices or reinstalling?
Keep server details, subscription URLs, and configuration files used in Config organized separately. Note your current Global Routing selection and any important manual changes. A purchase record helps you download the app again, but it doesn’t back up this information. Export or copy files to storage you control, and don’t publicly share files containing passwords or access credentials. On the new device, check settings and rules before connecting; a matching filename alone doesn’t confirm that everything has been restored.
ROUTING / DIAGNOSIS
Routing Rules & Troubleshooting
Change one condition at a time. The connection switch, server reachability, DNS, and destination requests are separate things to check.
How do I choose among Config, Proxy, and Direct in Global Routing?
For everyday rule-based routing, choose Config. The active configuration file’s rules determine how traffic is handled. Proxy routes applicable traffic through the current proxy path; Direct lets you check traffic without that proxy path. Proxy won’t automatically fix server authentication or DNS issues, and Direct doesn’t delete your configuration. When troubleshooting, switch one mode at a time and record the result for the same destination. When finished, return to your intended mode.
The switch says connected, but webpages won’t load. What should I check first?
Temporarily disconnect and confirm that the device’s own network works. Then check that the selected server is still valid, its authentication details haven’t changed, and run Connectivity Test for an initial result. Next, check Global Routing and which file is active in Config so you don’t mistake a rule mismatch for a server failure. Finally, check that DNS resolves the destination. Change one setting at a time and record results for webpages, apps, and tests separately. The connection switch alone doesn’t mean a request to the destination succeeded.
Why isn’t traffic routed as expected when Config contains rules?
First, confirm that Global Routing is set to Config, then check that Config has the file you just edited enabled. Rules are usually matched in order, so a broad rule earlier in the list may take effect before a more specific one. Check whether conditions such as DOMAIN, DOMAIN-SUFFIX, and IP-CIDR match the actual request, and review the final policy in FINAL. Make sure PROXY, DIRECT, REJECT, and any referenced policies are valid. Troubleshoot one destination at a time instead of rewriting the entire ruleset.
DNS changes didn’t fix the problem. Should I try another DNS address?
Don’t keep stacking changes. Record your original DNS settings and confirm the active configuration is actually using the new ones. Then determine whether all domains fail, only some domains fail, or just one app is affected. If only domain access is affected, check the DNS results and request path. If the server itself can’t connect, troubleshoot server connectivity first. Restore a clear baseline and test one change at a time; it’s easier to find the cause than by changing DNS, servers, and rules all at once.
Battery use has increased. Should I turn off On Demand?
Compare battery use in system settings over similar periods and under similar network conditions, and check actual traffic in Data. Weak signal, frequent reconnects, continuous transfers, and very frequent testing can all increase battery use; don’t judge from a single change in charge level. On Demand starts connections based on conditions, so whether to turn it off depends on your needs. For troubleshooting, temporarily disable it and see whether manual connections are stable, then restore conditions one by one. Avoid changing servers, rules, and connection triggers at the same time.
What information should I keep if the problem persists?
Record the device OS, network type when the issue occurred, Global Routing mode, active configuration filename, and the full error message. Note whether all destinations are affected, whether the issue happens on another network, and whether you recently updated a subscription or configuration. Connectivity Test and Data can help document what’s happening, but test results don’t replace checking the actual destination. Before sharing notes, hide server addresses, passwords, and full subscription URLs. Keep only the interface labels and error details needed to troubleshoot.