Shadowrocket FAQ
Find answers about purchasing, installation, imports, and troubleshooting. Check your device and the specific message, then change one setting at a time.
Need the app? See the downloads for all platforms. For initial setup, start with the user guide; see configuration fields for rule syntax.
Purchase
Check how you got the app and your purchase history before troubleshooting account or device issues.
Can I use Shadowrocket on a computer or Android device?
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, Android uses an arm64 package, and Linux users can choose deb, rpm, or AppImage for their distribution. Choose your device on this site's download page. Desktop and Android installers are available through this site's /dl/shadowrocket/ path. If your system blocks the app on first launch, follow the relevant steps under “Installation and First Launch” on this page.
Can I install Shadowrocket on an iPad? How does the iPhone purchase work?
Yes. iPhone and iPad use the same App Store product listing. 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. On both mobile devices, sign in with the Apple ID used for the purchase and look for Shadowrocket in your purchased apps. Don't rely on whether an app icon is already on the Home Screen to determine your purchase history. Check the App Store listing for system requirements. Review device compatibility on the product page before downloading, and check your connection settings on each device.
Can't find Shadowrocket in the App Store? What should I check?
Check the spelling, then open the App Store product page linked on this page and see whether the store reports regional unavailability or device incompatibility. Shadowrocket is not available in the mainland China App Store. Check the country or region for the account used under Apple ID's “Media & Purchases”—your device language does not determine your store region. Apple's usual region-change path is Settings → Apple ID → Media & Purchases → View Account → Country/Region. Before proceeding, review any system notices about your account balance, active subscriptions, and payment method.
How can I verify the genuine App Store listing?
Check all three: the product name, Shadowrocket; the developer, Shadow Launch Technology Limited; and the app ID 932747118 in the product link. The icon should match the official icon shown in this site's header. Don't rely on a nickname or a similar-looking image. 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. Prices may vary by storefront; check the listing for the amount shown. Get desktop and Android versions from this site's download page and confirm the path is /dl/shadowrocket/. Don't use the mobile App Store listing to verify a desktop installer.
Do I need to buy Shadowrocket again after changing devices or reinstalling?
On iPhone or iPad, sign in with the Apple ID used for the original purchase, then look for Shadowrocket in your purchased apps or app list and download it 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 App Store still shows a price, check the account under “Media & Purchases” and your purchase history before paying again. Reinstalling the app does not necessarily restore server details, subscriptions, or configuration files. Before changing devices, keep configuration materials you're entitled to use. After restoring, check connection permissions and rule selection again.
Does buying the app include the servers needed to connect?
No. A one-time app purchase is not a server plan. 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. These are the two ways to get the app, and neither includes servers or a subscription. This site does not provide, sell, or recommend servers or subscriptions; it only explains how to import subscription or server details you already have. Before setup, ask your service provider to confirm the subscription URL, validity period, and protocol settings. Installing the app without adding usable connection details is not enough to test whether it works.
Installation and First Launch
Check the installer source and device architecture first. Only bypass system restrictions for files whose source you've verified.
Which Mac version should I choose: Apple silicon or Intel?
Click the Apple menu in the top-left corner of the screen and select “About This Mac.” Check whether it lists “Chip” or “Processor.” Choose the Apple silicon version if it shows an Apple chip, or the Intel version if it shows an Intel processor. Don't guess based on the Mac's purchase date or case design. This site's download page has two matching dmg buttons. Open the disk image and move the app to Applications. If macOS says it can't verify the developer on first launch, make sure the installer came from this site, then go to System Settings → “Privacy & Security” and look for “Open Anyway.” Review the system prompt before confirming.
Windows shows a security warning. How can I continue the installation?
First, make sure you downloaded the installer from this site's download page and that its path is under /dl/shadowrocket/. Confirm that Shadowrocket is the app you intend to run. If SmartScreen displays “Windows protected your PC,” select “More info,” check the app details, then choose “Run anyway.” This warning does not verify the file's contents, so never do this for an app from an unknown source. If your device is managed by your employer or school, or Windows doesn't offer a way to continue, ask your administrator about the policy. Don't disable system protection. After installation, import your own configuration and test the connection.
Mac says it can't verify the developer or that the app is damaged. What should I do?
Make sure the file came from this site's download page and that you chose the version matching “About This Mac.” If macOS says it can't verify the developer, try opening the app, then go to System Settings → “Privacy & Security” and select “Open Anyway.” If it says the app is damaged, delete the incomplete download and download it again. Once you've confirmed the source and moved the app to Applications, run xattr -cr /Applications/Shadowrocket.app in Terminal, then try opening it again. This command clears extended attributes from the specified app. Use it only for an app whose source you've verified; don't replace it with a command that targets your entire disk or Applications folder.
Can't install Shadowrocket on Android, or does tapping Download in WeChat do nothing?
If you can't download the file in WeChat, open the menu in the top-right corner and use your system browser to visit this site's download page. Then download the arm64 installer. If Android says installation from this source isn't allowed, go to system settings and allow “Install unknown apps” for the browser or file manager that started the installation. You can revoke this permission after installing. If parsing fails, check that the download completed, that you have enough storage, and that your device supports arm64. Don't keep tapping the same incomplete file. Ask your administrator about installation restrictions on managed devices.
The connection switch won't turn on, or turns off immediately. What should I check?
First determine whether you haven't yet approved the system's VPN configuration request or whether the connection fails after approval. On the first connection from an iPhone or iPad, follow the system prompt to allow a VPN configuration and complete any required device verification. If you previously denied the request, try connecting again to bring up the prompt. Next, make sure Home has a selectable server with all required fields filled in. Temporarily stop other apps using the VPN connection and try again. Also check any device management policies. If it still fails, note the system prompt and the error in the app log. Don't delete all configurations right away—you may lose useful troubleshooting information.
Subscription and Server Imports
The steps below assume you already have your own subscription or server details.
Subscribe import failed. What should I check first?
Make sure you're using the complete subscription URL from your own provider, not an admin dashboard or login page. Check for spaces or line breaks, missing query parameters, and an expired link. In Add Server, choose Subscribe, enter the URL, and save. Then check the specific error: for a download failure, check your network and whether the URL is reachable; for a parsing failure, ask your provider to confirm the response format and supported protocols. Subscription URLs may contain access credentials. Don't share the full URL in public screenshots, logs, or support requests.
How do I update an existing subscription? What happens if an update fails?
Find the existing subscription group in Home and use its update action. The button's location depends on the current app version. Updating reloads the same subscription URL; you don't need to add another group with the same name each time. Before updating, make sure your local network is working. Afterwards, check whether the server list or selected server has changed. If the update fails, keep the error message and check that the URL is still valid. Don't rush to delete the original group; test whether its existing entries still work. If your provider changed the URL, edit the existing subscription URL rather than repeatedly trying to update it.
Duplicate entries appeared after an update. How should I clean up my subscriptions?
Check each subscription group to see whether the same URL was added more than once. Then distinguish entries generated by a subscription from servers you added manually. Two entries with the same name may have different settings, so compare their addresses, ports, and protocols before deciding what to keep. Save any manual configurations you need, confirm that the group you're keeping updates and connects properly, then remove duplicate groups. Don't clear the entire list at once. If your provider changed entry names, older manually added copies usually won't sync with the subscription; review and manage those separately.
Scan QR Code didn't add a usable server. What should I do?
Make sure the QR code comes from server details you already have and contains server-sharing information the app can read—not a web login link or ordinary text. When using Scan QR Code, check camera permissions, lighting, and image clarity. If the app reads the code but can't parse it, ask your provider to confirm the format and protocol. You can also use Add Server to enter the address, port, password, and any other protocol-specific fields manually. Check each field after saving. Don't assume the import worked based on the entry name alone, and don't share QR code images that contain credentials.
Rules and Troubleshooting
Narrow down the cause by checking your local network, server, routing mode, rules, and DNS in that order.
How should I choose Config, Proxy, or Direct in Global Routing?
Config routes traffic according to the rules in the currently active configuration file, making it suitable for everyday use with split routing. Proxy routes traffic handled by the app through the proxy, which can help you check whether an issue is related to split-routing rules. Direct routes traffic directly; it does not turn off the app. System-reserved traffic and bypass settings may still affect the result. When troubleshooting, change one mode at a time and test the same destination. Switch back to your preferred mode before resuming normal use. PROXY and DIRECT in a configuration file are policy names; don't confuse them with the Global Routing modes.
The app shows connected, but webpages still won't load. What should I do?
A connected status only means the system connection is established; it doesn't prove that the server, DNS, and rules are working. Disconnect and confirm your local network can reach a site you normally use. Reconnect, then run Connectivity Test on the selected server. If the test fails, check the address, port, credentials, protocol settings, and system time. If it passes but a specific site fails, check the request log for the matching rule and policy. You can briefly compare results in Config and Proxy, then check your DNS settings. Change one thing at a time and note the difference; avoid changing the server, rules, and DNS all at once.
The interface is in English. Which terms should I start with?
This manual keeps interface labels in English so you can match them directly: Home shows servers and connection status; Add Server is for entering server details; Config manages configuration files; Settings contains app settings. Global Routing lets you choose Config, Proxy, or Direct, while On Demand controls when the app connects automatically. The interface language and store account region are separate settings. If your version offers a language option, check the app's settings or its individual settings in the system. Don't change your store region just to change the language.
Background battery use has increased. How can I tell whether connection settings are involved?
Compare similar periods of typical use in your system's battery statistics rather than relying on a single reading right after connecting. Ongoing transfers, a weak network signal, repeated server reconnects, frequent tests, and diagnostic logging can all increase activity. Traffic shown under a VPN name may also come from other apps, so it doesn't necessarily represent traffic initiated by the client itself. Stop batch tests, check whether any app is downloading continuously, then see whether On Demand is repeatedly triggering under current network conditions. Change one setting at a time and observe it over a similar period. Don't delete working rules or disable necessary system settings just to lower the reported usage.
Rules don't seem to be taking effect. How can I check the matching order?
Make sure Global Routing is set to Config and that you've selected the configuration file you edited. Rules in the Rule section are generally matched from top to bottom, and the first matching rule determines the policy. A broader rule placed earlier may therefore override a more specific rule below it. Check that rule types such as DOMAIN, DOMAIN-SUFFIX, and IP-CIDR are correct, and that the policy is the intended PROXY, DIRECT, or REJECT. Use FINAL as a fallback when no earlier rule matches. Check the request log to see which rule actually matched. After editing, save and retry the request; don't use a reused connection to judge a new rule.