Purchases and accounts
Store & Purchase
Check the app's identity, store region, and purchase history. Keep the client purchase separate from any connection service.
Can you use Shadowrocket on computers and Android? What does it cost on each platform?
Yes. The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. Mac downloads are available for Apple Silicon and Intel; Windows uses a 64-bit installer, and Android uses an arm64 package. Choose your device on this site's download page. Desktop and Android installers are available from this site's /dl/ paths. You will also need your own subscription or server details; installing the client does not provide a working connection.
How can I verify that I'm buying the genuine Shadowrocket app?
On the App Store product page, check the developer name, Shadow Launch Technology Limited, the official app icon, and app ID 932747118. The icon should match the official icon in this site's header. Confirm the app ID at the end of the product page URL rather than relying on the name in search results alone. The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. Get desktop and Android installers from this site's download page at /dl/.
Can't find Shadowrocket in the App Store? What should you check?
Open the App Store product page linked on this page to determine whether search failed or the app isn't available in your account's region. The app isn't available on the China mainland App Store. On your device, go to Settings, open your Apple Account, then select Media & Purchases to check the account's Country/Region. If you need to change it, follow Apple's official process and first address any account balance, active subscriptions, and Family Sharing requirements. Changing your device language won't change which apps are available in the store.
Do I have to buy Shadowrocket again after switching iPhones or iPads, or reinstalling it?
You can usually redownload the app from the App Store's Purchased list or your account's app list using the account that originally bought it. You shouldn't need to pay again. The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. If the page still shows a price, check the account signed in to Media & Purchases, your purchase history, and your account region before paying again. Redownloading the app does not restore local settings. Save your Config and server details separately before switching devices.
Why do I still need a subscription or server details after buying the client?
A one-time client purchase is not a connection service plan. Shadowrocket imports server details you already have, establishes connections, and applies routing rules; installing or buying it does not create a working server. The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. This site does not provide, sell, or recommend servers or subscriptions. Before setup, have your own subscription URL or server details ready, and check their validity and terms of use.
Related: App Store product page · How to verify the app
Devices and systems
Install and launch
Choose the right device architecture first, then address system prompts. Check system management policies separately from client connection settings.
Which Mac version should I choose: Apple Silicon or Intel?
Click the Apple menu in the top-left corner of your screen and choose About This Mac. If it lists a Chip and an Apple chip name, choose Mac Apple Silicon. If it lists a Processor and says Intel, choose Mac Intel. Both downloads are on this site's download page; check your Mac's chip type before installing. Open the DMG and drag the app to Applications. If macOS asks you to verify the developer on first launch, go to System Settings → Privacy & Security and follow the prompt. Don't choose an installer based only on your Mac's appearance or purchase year.
Windows or Mac warns that the app may be unsafe or can't verify the developer. What should I do?
First, confirm the file came from the /dl/ path on this site's download page. For a Windows SmartScreen warning, verify the source, then choose More info → Run anyway. If your computer is managed by an organization, contact your administrator first. If Mac says it can't verify the developer, go to System Settings → Privacy & Security, find the blocked app, and choose Open Anyway. These installers are not code-signed, so the system may show a warning. If you don't know where the file came from or the system reports specific malicious content, stop and don't disable system-wide security protections.
Can't install the Android download, or can't open it from WeChat?
If the download won't work in WeChat, open the top-right menu and choose to open the page in your system browser. Then visit this site's download page and get the arm64 installer. If Android says installs from this source aren't allowed, go to system settings and enable Allow from this source for the browser or file manager you're using. You can turn the permission off after installation. If parsing still fails, check that the file downloaded completely, your device architecture is compatible, and you have enough storage. Don't repeatedly install files with the same name from unknown sources.
Can I install Shadowrocket on iPad? Where can I check the system requirements?
Yes. iPhone and iPad use the same App Store product page; check that page for the system requirements. The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. Before downloading on iPad, check your store account and device compatibility. The first time you connect, follow the system prompt to allow a VPN configuration. If the connection control isn't obvious in the larger layout, return to Home. Being able to open the app doesn't mean you already have a subscription or that your Config was transferred automatically.
The interface is in English. Which screens should I start with?
Use each screen for its intended task: Home shows servers and connection status; Add Server lets you add a server you already have or a Subscribe URL; Config manages configuration files; Settings contains app options. In Global Routing, Config, Proxy, and Direct select configuration-based routing, proxy routing, and direct connections. The official manual keeps interface labels in English so you can match them on screen. If the app offers language options, check the app's settings or your system's per-app language settings. Changing the interface language won't fix a connection problem.
Related: Allow installation on each system · Getting started
Importing and managing existing details
Routing Rules
The steps below assume you already have your own subscription or server details. Keep the original information while troubleshooting, and hide credentials before sharing logs or screenshots.
How do I import a subscription URL I already have?
Have the complete subscription URL ready. In Home, open Add Server, set the type to Subscribe, enter the URL and a label you can recognize, save it, then update it. Before pasting, check for spaces, line breaks, or extra text added by a messaging app at either end of the URL. After the update completes, return to Home and confirm that server entries appear, then select one to connect. A subscription provides a server list; Config determines routing. They are separate items, and importing a subscription doesn't confirm that your current rules suit your needs.
Subscribe import failed. Should I check the URL or the network first?
First check that the URL is complete. Then make sure the device can access the internet while disconnected, and check the error reported by the app. For a timeout, check the current network and whether the subscription URL is reachable. For an authentication error, check whether the URL has expired or the credentials have changed. For a format error, make sure the response is subscription data the client can read, not a login page or error page. Change one thing at a time and retry. If you contact the original service provider, you can share the error text, but hide any token or other credentials in the URL.
How do I update a subscription, and why might the server count change afterward?
In Home, find the relevant Subscribe entry, use its update action, and wait for the request to finish before checking the list. The subscription provider may change its servers, remove inactive entries, or change the returned content, so the count can vary. This doesn't mean the app lost its configuration. If an update fails, keep the existing entry instead of deleting the whole group. Updates may overwrite manual changes to subscription-generated servers. Record any independent server details you need to keep, and distinguish them from subscription entries.
Why can't I connect after importing with Scan QR Code?
Scan QR Code reads connection details from a QR code; it doesn't check whether the server is online or the details are still valid. After importing, open the server editor and check the protocol, address, port, authentication details, and, where applicable, TLS, SNI, and transport settings. A QR code containing only a regular webpage URL won't become a working server automatically. Run Connectivity Test for the entry, then try connecting. If both fail, confirm the details with the original source rather than guessing by switching protocols.
What should I back up before switching devices?
Save at least your active Config, subscription source, individual server details, and any custom rules you need. Note your current Global Routing selection. If you use iCloud sync, confirm that syncing has finished on the old device, then check the data on the new one; seeing the app icon doesn't mean migration is complete. Config files may contain server passwords or subscription credentials, so store exported files securely. After migration, check subscription updates, the selected Config, the selected server, and VPN authorization. Remove data from the old device only after confirming everything works.
Related: Import a subscription and make your first connection · Systematic subscription troubleshooting
Modes, rules, and diagnostics
Routing Rules and Connection Troubleshooting
Narrow down the cause in order: network, server, DNS, then rules. Change one thing at a time and keep a configuration you can restore.
Which Global Routing option should I use: Config, Proxy, or Direct?
Config matches traffic against the rules in the selected configuration file and is suited to everyday split routing. Proxy sends applicable traffic through the current proxy route and can help with short-term comparisons while troubleshooting. Direct bypasses the proxy for applicable traffic but still depends on your device's network. Verify rule behavior in Config mode. You can briefly switch to Proxy to compare results, then restore your original setting. Proxy won't fix every problem, and the Proxy option in Global Routing is not the same as PROXY in a rule.
The connection switch won't turn on, or turns off right away. What should I do?
First, check that a valid server is selected in Home. Then see whether the system prompts you to authorize adding a VPN configuration. If you denied permission earlier, check the relevant configuration in system VPN settings and try connecting again. Another VPN connection, device management policies, or an invalid configuration can also make the switch turn off immediately. Save your Config and server details before making changes, then disconnect other VPNs and test again. If the switch still turns off, note the error text and steps that trigger it, then follow the troubleshooting manual. Don't repeatedly delete all your data.
It says connected, but I can't access the internet. How do I tell whether it's the server, DNS, or rules?
Disconnect first and confirm the device's regular network works. Reconnect, then check Connectivity Test and the connection logs. If all destinations fail, start by checking the server status and details. If only some domains fail, check DNS and which rules match. You can briefly switch to Proxy for comparison. If Proxy works but Config doesn't, check the selected Config, rule order, and where FINAL sends unmatched traffic. A DNS response doesn't guarantee the connection will succeed. Change one thing at a time and record the result so you can isolate the cause.
A site isn't using the proxy as expected under a DOMAIN-SUFFIX rule. What should I check?
First, confirm Global Routing is set to Config and the intended configuration is selected. Rules are matched in order, so an earlier, broader DIRECT, GEOIP, or other rule may take precedence over the target DOMAIN-SUFFIX rule. Check the connection logs to confirm the actual requested domain; a webpage may contact several domains, so the address bar alone doesn't show all its traffic. After editing and saving, start a new connection for the affected site and check which rule matches. Existing connections may continue using the old route. FINAL handles traffic that didn't match an earlier rule.
Battery use increases while connected, or problems appear after an app update. How should I troubleshoot?
Check your system's battery usage for the time in question. Distinguish heavy foreground traffic, repeated server reconnections, and background triggers. Check whether On Demand is behaving as expected and whether subscriptions are updating frequently, diagnostic tests are running, or logs are being recorded continuously. Adjust one item at a time and compare under similar conditions. If a problem starts after an app update, back up your configuration, reopen the app, confirm the selected Config and server, then run a connection test. Don't reset everything at once. Keep the error, system details, and reproduction steps for further diagnosis.
Related: Complete troubleshooting manual · Using Global Routing