[FAQ]Official Manual
Shadowrocket FAQ
Start with getting and installing the app, then work through subscriptions, configuration and connection issues. Check your device and the exact error first, then open the relevant answer. Keep any working configuration before making changes.
Haven’t installed Shadowrocket yet? See the downloads and installation guide for all platforms. For your first setup, follow the quick start guide.
[Verify]
Purchasing and verification
Check your platform, the App Store product page and your purchase account before troubleshooting region or restore issues.
Can I use Shadowrocket on desktop and Android? How do I get it for 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. Choose your device on the downloads page; desktop and Android installers are available at /dl/shadowrocket/ on this site. Buying the app is separate from paying for a proxy service. After installation, import a subscription or server details you already have. This site does not provide, sell or recommend servers or subscriptions.
How can I verify Shadowrocket on the App Store?
Open the App Store product page linked here. Check the name Shadowrocket, the developer Shadow Launch Technology Limited, and the app ID 932747118 in the URL. The icon should be a rocket with a blue-purple outline on a white background. Don’t rely on similar names in search results alone. The iPhone and iPad versions cost $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. For desktop and Android, use the installer links on this site’s downloads page. An App Store purchase is not a prerequisite for installing on other platforms.
Can’t find Shadowrocket in the App Store? What should I check?
The app is currently unavailable to search for or download from the App Store in mainland China. In Settings, go to Apple Account → Media & Purchases → View Account → Country/Region and check the region of the account used for purchases—not just your device language or system region. Then open the product page to check its availability in your current storefront. If you need to change regions, use Change Country or Region on that page and review Apple’s requirements for balances, active subscriptions and payment methods first. Changing your device language does not change your storefront region.
Do I need to buy Shadowrocket again after changing devices or reinstalling it?
The iPhone and iPad versions cost $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. On an iPhone or iPad, sign in to Media & Purchases with the account used for the original purchase, then find the app in your App Store purchase history and download it again. You generally won’t need to pay again. If the App Store still shows a purchase button, check the account and purchase history. Restoring the app does not restore its configuration: check subscriptions, Config files and local settings separately. On a new desktop or Android device, download the appropriate installer from this site.
Can I install Shadowrocket on an iPad? Is the purchase shared with iPhone?
Yes. The iPhone and iPad versions cost $2.99 as a one-time App Store purchase, and can be downloaded on both device types using the same purchasing account. The Mac, Windows, Android and Linux versions are free. Check the App Store product page for the iPhone and iPad system requirements; follow the requirements listed there. Check the connection toggle, selected server and active configuration on each device separately. A shared purchase does not automatically sync connection status or guarantee that your service allows simultaneous connections on two devices.
[Install]
Installation and first launch
Check the installer’s source and your system architecture, follow the system’s prompts to allow it to run, then check connection permissions.
Which Mac version should I choose: Apple Silicon or Intel?
On your Mac, open About This Mac from the Apple menu. If it lists a chip and an Apple chip name, choose the Apple Silicon version. If it lists an Intel processor, choose the Intel version. The downloads page has a matching DMG for each; don’t decide based on the Mac’s appearance or purchase year. Open the DMG and move Shadowrocket to Applications. If you see a message that the developer can’t be verified on first launch, confirm the installer came from this site, then choose Open Anyway in Privacy & Security in System Settings. Don’t disable your Mac’s overall security protections just to open one app.
Windows or Mac warns that the app may be unsafe. What should I do?
First, make sure you downloaded the file from this site’s downloads page. If Windows SmartScreen appears, verify the source, then select More info → Run anyway; a work-managed computer may require administrator approval. If macOS says the developer can’t be verified, select Open Anyway in Privacy & Security. If macOS specifically says the app is damaged, download it again and move it to Applications. After confirming the source, run xattr -cr /Applications/Shadowrocket.app. If the source is unclear or security software reports a specific threat, stop and don’t dismiss the warning.
What should I know before installing Shadowrocket on Android or Linux?
Download the APK from this site’s downloads page. If it won’t download inside WeChat, open the page in your system browser instead. In system settings, allow unknown apps only for the browser or file manager you’ll use to install it; you can turn this permission off after installation. On Linux, choose the deb, rpm or AppImage package for your distribution. For an AppImage, allow it to run as a program in its file properties, or run chmod +x before launching it. Check your system architecture before installation. If an organization policy blocks installation, contact your administrator. See the downloads page for platform-specific commands and installation steps.
What if the connection toggle on Home won’t turn on or switches off immediately?
On Home, first select a working server; importing a server list does not select a server for you. The first time you connect, allow the system to create a VPN configuration. If you previously denied permission, try connecting again and check your system VPN settings. Temporarily stop other apps using the VPN tunnel to rule out a conflict. If the toggle switches off immediately, check the earliest error in Log, focusing on configuration syntax, certificates, port and permissions. Don’t repeatedly reinstall the app. Back up your existing Config and subscription details, then troubleshoot the specific error.
The interface is in English. Which items should I learn first?
Use Home to find the server list and connection toggle. Use Add Server to add a server or Subscribe, Config to manage rule files, and Settings to find app settings. Under Global Routing, Config, Proxy and Direct are the three routing modes: rule-based configuration, proxy and direct connection. This manual keeps these interface terms in English so you can match them on screen. If your device offers app-specific language settings, look for Shadowrocket in system Settings. Menu locations vary by system and platform, so follow what you see on your device.
Related: Installation permissions · Interface terms and glossary
[Subscribe]
Subscriptions and server imports
The steps below assume you already have your own subscription or server details.
An existing subscription won’t import. What should I check first?
Make sure you have a subscription link for a service you already use—not an account login page, web sharing page or link for a single server. In Add Server, choose Subscribe and paste the full URL. Check for leading or trailing spaces, line breaks and query parameters missing from the copied link. If the list is empty, check the service status, link expiry and subscription format. If the result is a web page, the URL type or access verification is probably incorrect. Don’t post the full subscription URL in public comments or screenshots: its token may let others access your service configuration.
A server entered manually or scanned from a QR code still won’t connect. What should I check?
In Add Server, make sure Type matches the protocol of the server you already have. Then check SERVER, Port, Password or UUID, and additional settings such as TLS, SNI and transport. Scan QR Code only reads the code’s contents into the app; it doesn’t confirm that the data is complete or the server works. After importing, reopen the entry and compare each field with the original, paying particular attention to special characters in the password and spaces around the server address. Don’t disable TLS verification just to make a connection work. Correct the certificate name, SNI or server configuration instead.
How do I update a subscription, and what happens if the update fails?
On Home, find the relevant subscription group and use its update action. Afterward, check the server list and the selected entry. If updating fails, keep any configuration that still works. Confirm the device can reach the subscription URL, then check whether the URL changed, the service expired or the response is a valid subscription. Don’t repeatedly delete and recreate entries as a substitute for troubleshooting—you could lose manual changes. Updating a subscription refreshes its server information; it does not update rule files in Config. Check those separately.
What’s the difference between a subscription and a Config file?
A subscription typically maintains a server list; a Config file organizes settings such as DNS, rules and policies. Having a working subscription doesn’t mean the right rules are enabled, and having a rule file doesn’t mean you have a server to connect to. Select a server on Home, check the file you need under Config, then set Global Routing to Config. Keep a copy of the original before editing, and change one type of setting at a time. That makes it easier to identify whether a problem comes from server settings, rule order or DNS.
What should I back up before switching devices?
Record the subscription source, manually entered server details, active Config file, and any settings you changed, such as DNS and On Demand. If you use iCloud sync, check iCloud permissions in system settings and the sync status in the app; an enabled toggle doesn’t confirm that a backup has completed. Exported configuration files may contain addresses and access credentials, so save them somewhere you control. On the new device, first check that the files and servers are present. Then select a server, set Global Routing and test the connection. Remove data from the old device only after confirming the restore worked.
Related: First import and connection steps · Settings reference
[Rule]
Routing rules and troubleshooting
Change one condition at a time to distinguish local network, server connection and rule-matching issues.
How do I choose among the three Global Routing modes?
Config follows the rules in the active configuration file and is suited to rule-based routing. Proxy generally sends requests through the selected proxy and can help check whether a server is working. Direct connects without a proxy and can be used as a comparison. For everyday rule-based use, select Config and make sure the policies referenced in the rules exist. Changing modes only changes how requests are handled; it won’t fix incorrect server settings. Restore your original mode after testing so you don’t leave a temporary troubleshooting setting in place.
Shadowrocket says connected, but web pages won’t load. What should I do?
Disconnect and make sure your Wi-Fi or cellular network can load regular web pages. Reconnect and check Log. Briefly switch to Proxy for a test: if Proxy works but Config doesn’t, check rule order, policy names and DNS. If neither works, check the selected server settings and service status. Connectivity Test only reports results for its specific target and method; it can’t confirm that every website is reachable. Change one condition at a time, and note the routing mode, network type and domain that failed.
Shadowrocket won’t connect. What troubleshooting steps should I follow?
Troubleshoot in this order: local network, system permissions, server settings, service status, then routing configuration. First verify the network, then check VPN permission and the selected server. Next, check SERVER, Port, credentials, TLS and the device’s date and time. Finally, look for the first failure in Log. Timeouts, authentication failures and certificate errors have different causes; don’t assume every issue is a rule problem. When contacting the provider of a service you already use, share a redacted error summary and the conditions that triggered it. Don’t send a full subscription URL, password or configuration file containing credentials.
The rules look right. Why are requests still using the wrong policy?
First check that Global Routing is set to Config and that the active file is the one you edited. Rules are generally matched in order. A broad DOMAIN-KEYWORD or IP-CIDR rule near the top may match before a more specific rule below it; FINAL usually belongs at the end. Check the domain, IP and DNS results actually used by the request instead of relying only on the browser’s address bar. After changing DNS, make a new request and, if needed, reconnect so an old connection or cached result doesn’t affect the test. Change one rule at a time and check the log.
Battery use increases after connecting. How should I check On Demand?
Compare similar periods of use and network conditions in your system’s battery statistics. Long transfers, weak signal, frequent reconnects and continuous detailed Log recording can all use more power. After troubleshooting, restore normal logging and avoid repeated speed tests or Connectivity Test runs. If the connection comes back automatically, check the network triggers in On Demand. It establishes connections when conditions are met; it doesn’t improve connection quality. Turn off the relevant conditions to compare, then enable them one at a time as needed. Test each one on Wi-Fi and cellular.
Read more: DNS, On Demand and Log settings