Shadowrocket FAQ
First verify the source and permissions, then check your existing subscriptions, selected configuration and connection status. Find your issue by stage and expand it for step-by-step instructions.
- 4 categories
- 20 step-by-step answers
- Connection steps use iPhone and iPad as examples
New users can start with the getting started guide. For the full workflow, see the user guide. Expand any answer below; no interaction script needs to load first.
Purchase & Authenticity
Understand the difference between app purchase eligibility, device platforms and access to your existing service.
Can you use Shadowrocket on a computer or Android? How do you get it on each platform?
Yes. Shadowrocket is available for iPhone, iPad, Mac, Windows, Android and Linux. The iPhone and iPad versions cost $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free. Visit the all-platform download page and choose your device. Mac downloads are available for Apple Silicon and Intel, and computer and Android installers are provided at /dl/shadowrocket/ on this site. The one-time app purchase is separate from any service plan. You’ll need your own subscription or server details to use the app; this site does not provide, sell or recommend servers or subscriptions.
How can you verify Shadowrocket on the App Store?
Open the App Store product page from the download page. Check the name, Shadowrocket, the developer, Shadow Launch Technology Limited, and the app ID 932747118 in the product URL. Then compare the listing with the official icon in this site’s header. Matching names alone don’t confirm that it’s the same listing, so don’t rely only on the search result title. The iPhone and iPad versions cost $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free. The amount charged depends on the current storefront. Verify the listing before paying; system requirements are as shown on the App Store page.
Can’t find Shadowrocket in the App Store? What should you check first?
Open the product page from the download page to see whether the search result is missing or the app is unavailable in your current storefront. Shadowrocket isn’t listed on the mainland China App Store. Check the Apple Account currently used for Media & Purchases rather than relying on your device language or region. You can check the account region under Settings → Apple Account → Media & Purchases → View Account → Country/Region. If you need to change it, follow the requirements shown in that official account flow and resolve any restrictions, such as account balance or active subscriptions, first. Also check Screen Time content restrictions and your account’s payment status.
Do you have to buy Shadowrocket again after getting a new iPhone or reinstalling it?
Sign in to the App Store with the account used for the original purchase. Find Shadowrocket in your account’s Apps or Purchased list, then tap the cloud download icon. The iPhone and iPad versions cost $2.99 as a one-time App Store purchase. The Mac, Windows, Android and Linux versions are free. If your original purchase is available, you can reinstall without paying again. If a price still appears, check the account used for Media & Purchases, your purchase history and the storefront before proceeding. Reinstalling the app doesn’t restore your configuration, so back up Config and your existing service details separately before switching devices.
Can you install Shadowrocket on an iPad? How do purchases and configurations differ from iPhone?
You can get Shadowrocket for iPad from the same App Store product page. Check the App Store page for system requirements. The iPhone and iPad versions cost $2.99 as a one-time purchase and work on both devices. The Mac, Windows, Android and Linux versions are free. On an iPad signed in with the same purchasing account, you can download the app from your purchase history. App purchase eligibility is separate from any device limits set by your service provider. After restoring the app, check that your subscription is available, the right Config is selected and your service allows multiple devices. A purchase record does not grant access to a service.
Installation & First Launch
Make sure the installer matches your system, then follow system prompts for installation and network permissions.
Should you choose the Apple Silicon or Intel version for Mac?
Open the Apple menu → About This Mac. If it shows Chip and an Apple chip model, choose the Apple Silicon version. If it shows an Intel processor, choose the Intel version. Both installers are in the Mac section of the download page; don’t judge by the computer’s appearance or purchase year. Open the matching DMG and move Shadowrocket to Applications. If macOS says it can’t verify the developer, first confirm the package came from this site, then go to System Settings → Privacy & Security and choose Open Anyway. If macOS says the app is damaged, follow the steps in the next answer.
Mac says the developer can’t be verified or the app is damaged. What should you do?
First confirm the installer came from this site’s download page and that you chose the correct version for your Mac’s chip. If macOS can’t verify the developer, try opening the app once, then go to System Settings → Privacy & Security, find the blocked app notice and choose Open Anyway. If macOS says the app is damaged, download it again and move it to Applications. After confirming its source, you can run xattr -cr /Applications/Shadowrocket.app in Terminal, then reopen the app. This command removes extended attributes from this app’s directory only. Don’t run it on the entire disk or disable system-wide security checks.
Windows warns that the app may be risky or blocks it with SmartScreen. How do you install it?
Get the Windows 64-bit installer from this site’s download page. Before running it, confirm the download source and where the file was saved. If SmartScreen shows a protection warning, check that it’s the Shadowrocket installer you just downloaded, then choose More info → Run anyway and follow the setup wizard. If User Account Control appears, verify that the program matches what you’re installing before approving it. If your computer is managed by your organization, the option to proceed is unavailable, or a management policy blocks installation, contact your device administrator. Don’t disable all protection. When you connect for the first time, follow the system prompts to grant the required network permissions.
What should you check before installing Shadowrocket on Android or Linux?
On Android, first confirm that your device supports arm64. Download the installer, then allow the browser or file manager you’re using to install unknown apps for this installation only. You can turn off that permission afterward. Approve the system VPN request when you connect for the first time. On Linux, choose deb, rpm or AppImage to match your distribution. For AppImage, allow execution in the file’s properties or run chmod +x on the actual file. To install a deb package, use sudo apt install ./ followed by the actual filename. Install rpm packages with your distribution’s package manager. Use the downloaded filename in commands; don’t copy someone else’s file path.
The connection switch won’t turn on, or turns off right away. What should you do?
The steps below use iPhone and iPad as examples. First, make sure Home has a server with all required details selected, then turn on the connection. When the system first asks to add a VPN configuration, follow the prompts to allow it and authenticate on your device. If you previously denied the request, try connecting again and check the VPN configuration status in Settings. Pause any other connection using the system VPN, then try again. Managed devices may restrict VPN configuration; ask your administrator to confirm your permissions. If the switch still turns off immediately, note the exact error and check the selected server details. Don’t delete every Config or repeatedly reinstall the app as a first step.
Subscriptions & Server Imports
The steps below assume you already have your own subscription or server details. Keep a copy of the original information before making changes.
Can’t import an existing Subscribe link? How should you troubleshoot it?
Make sure you copied the complete subscription URL for a service you already use, not a web-based account management link. Check the URL’s protocol, final characters, line breaks and spaces. Some messaging apps may truncate links. Confirm that the service is still active, your current network can reach the subscription URL and the response uses a format supported by the client. If the import shows a login or error page, check the link in your service’s own management portal. You can retry on another trusted network and share the error text with your service provider. Subscription URLs often contain access credentials; don’t post the full link in public comments, screenshots or online conversion tools.
How do you update a Subscribe entry? Why does nothing seem to change afterward?
Find the relevant Subscribe entry on Home and use its update action. Wait for the request to finish, then check any error message and the server list. An update retrieves whatever the URL currently returns. If your service provider hasn’t changed it, the list will stay the same. If the request times out, check whether your current network can reach the subscription URL. If the content is invalid, check whether the link has expired or been replaced. Don’t repeatedly add the same URL as a new entry; that can cause confusion. After updating, verify the selected server and the names referenced in Config. A changed list doesn’t mean the current connection will automatically switch to a new entry.
When adding a server manually with Add Server, which settings are easiest to get wrong?
In Add Server, choose the protocol used by your existing service, then check the address, port and authentication details one by one. Shadowsocks encryption methods and passwords, VMess or VLESS UUIDs, and Trojan passwords aren’t interchangeable. If your service uses additional settings such as TLS, Server Name or WebSocket Path, make sure they match the server. Don’t include a colon in the port field or paste a full webpage URL into the address field. After saving, run Connectivity Test before trying to connect. If the test fails, check the original details rather than switching protocols at random or disabling certificate verification.
Scan QR Code doesn’t import anything, or adds multiple entries. What should you do?
Make sure the QR code comes from a service you already use and contains supported server sharing details or a subscription URL—not a payment page, login page or regular website. When you use Scan QR Code, allow camera access if prompted. If scanning from an image, make sure the code is clear, complete and not cropped at the edges. A subscription URL can contain multiple servers, so multiple entries don’t necessarily mean the code was imported more than once. Check which Subscribe group they belong to, then verify their names and protocols. QR codes may contain credentials; when troubleshooting, share only the error text, never the original code.
What’s the difference between Subscribe and Config? Which should you back up when switching devices?
Subscribe is mainly for retrieving and updating server lists. Config organizes rules and related settings. They aren’t interchangeable just because both can be imported. A subscription alone may not include the routing rules you need, while a Config alone may not contain usable server details. Before switching devices, check the active Config, subscription URLs and manually added servers. Back them up separately using the app’s export or sync options. Configuration files may contain passwords and access credentials, so store them securely. After restoring, verify that all references are intact, then test the connection. An imported file alone doesn’t mean the migration is complete.
Rules & Routing
Check your local network, server connection and rule matching separately to avoid making the same changes repeatedly.
Which Global Routing mode should you choose: Config, Proxy or Direct?
Config applies the routing strategy defined by the selected configuration rules and is suitable for everyday use once you’ve checked those rules. Proxy sends connections handled by the client through the selected proxy, which can help determine whether rules are causing the problem. Direct accesses destinations without a proxy server and can be used to compare against your local network. These modes change routing behavior; they won’t fix incorrect server details. When troubleshooting, change one setting at a time and retest the same destination, noting the result. If Config fails but Proxy works, check the rules, policy references and match order first. Restore your preferred mode after testing.
Shadowrocket shows connected, but you can’t access the internet. What order should you troubleshoot in?
A connected status usually means the system connection is established; it doesn’t guarantee that the selected server can reach every destination. First disconnect Shadowrocket and confirm your local network can still access sites that were previously reachable. Then check the status and details of your existing service and the selected server. Test the same destination with Proxy and Config. If only Config fails, check the rules and policies. If both fail, check server connectivity, authentication and DNS. Change one setting at a time and keep a record of its original value. If only certain websites fail, consider whether those sites are having problems. Don’t immediately reset all network settings or delete the app.
Connectivity Test shows very low latency, but browsing is still slow. Why?
Connectivity Test results depend on the test method, destination and current network. They don’t represent the throughput of every website, video loading times or long-term stability. Compare your existing servers on the same network and under the same test conditions, then try the destinations you actually need. If the test responds but webpages won’t load, check DNS, the policy matched by your current rules and whether the server limits that type of connection. Data can help show whether traffic is flowing during a connection, but traffic alone doesn’t mean a request reached its destination. Avoid repeatedly testing many entries; narrow the test to one server and one destination you’re using.
The interface is in English and you don’t understand a setting. What should you do?
This guide keeps the app’s English labels so you can match them directly: Home shows servers and connection status; Add Server adds an existing server; Subscribe manages subscriptions; Config manages configurations; Global Routing selects a routing mode; Data shows traffic records; and Settings contains app settings. To find a feature, first check which screen you’re on, then match the full label rather than relying on an icon’s position. Layouts may vary by platform or app version, so use the labels shown in your current interface. Leave unfamiliar switches unchanged until you’ve checked the quick reference for an explanation.
Shadowrocket uses more battery than expected. How should you configure On Demand?
First, use your system’s battery usage report to distinguish Shadowrocket’s activity from the network activity of other apps. Then check whether it’s transferring data continuously, retrying connections frequently or running repeated tests. Temporarily stop frequent tests and any detailed logging you don’t need, then compare battery use over the same period. On Demand triggers connections based on conditions; it isn’t a battery-saving guarantee. To troubleshoot, turn it off temporarily and connect manually for comparison, then restore only the conditions you actually need. If the app reconnects after you disconnect manually, check whether the On Demand conditions are still met. Record the original settings before changing them, and distinguish automatic connections from routing rules and service availability.
Further troubleshooting: record the error and steps to reproduce it
If you haven’t identified the cause, note your device platform, current network, selected Global Routing mode, affected destination and exact error message. Compare results under the same conditions before checking permissions, your existing service or Config.
To review the full procedure from the beginning, read the complete user guide. To get the app or check system installation steps, visit the all-platform download page.