Shadowrocket Official Manual
Shadowrocket FAQ
Haven’t installed it yet? Check the App Store listing or installer first. If it’s installed but won’t connect, identify whether the switch won’t turn on or it turns on but webpages won’t load.
Purchase
Genuine app & purchase
Search results, the product page, and Purchased serve different purposes. Before downloading for the first time, verify the listing. When replacing or reinstalling a device, check the purchase history for the original account.
How can I verify the genuine Shadowrocket listing, and what are the two pricing options?
Check three details on the App Store product page: the developer is Shadow Launch Technology Limited, the icon is a blue-and-purple outlined rocket on a white background, and the product page URL ends in id932747118. Don’t rely on the name in search results alone. The iPhone / iPad version costs $2.99 as a one-time App Store purchase (US storefront; see the store listing for current details). The Mac / Windows / Android / Linux versions are free. A one-time app purchase is not a service subscription; purchasing the app does not include server details or a subscription.
Can’t find Shadowrocket in the App Store? Check your account’s country or region
First check the country or region associated with your App Store account; your device’s language and region settings don’t determine which listings are available. On iPhone / iPad, open Settings, tap your name, then Media & Purchases, View Account, and Country/Region. If the listing isn’t available in your current storefront, changing the device language won’t make it appear. To change storefronts, follow the App Store process on the same page. Before you do, check whether your balance, active subscriptions, and payment method meet the requirements.
Can I install Shadowrocket on iPad if I already bought it on iPhone?
Yes. Check the App Store listing for the iPhone / iPad system requirements. If both devices use the same App Store account and the listing is still available in your storefront, you can download it again on iPad from Purchased. If the store button doesn’t show a download icon, check the account and purchase history under Media & Purchases before paying again.
Do I need to buy Shadowrocket again after replacing or reinstalling my device?
When you replace an iPhone / iPad, look for Shadowrocket in the App Store’s Purchased section using the original purchase account. If the purchase appears and the listing is still available, you can download it again without paying again. If you can’t find it, check that you’re signed in with the original purchase account and that the listing is available in your storefront. Restoring access to the app does not restore its local configuration. Back up your existing configuration and server details separately before switching devices.
Install
Installation & first launch
Choose an installer that matches your device, then follow the system prompts. If the system reports an architecture mismatch, use the correct installer rather than changing permissions.
Is Shadowrocket available for desktop and Android?
Yes. The iPhone / iPad version costs $2.99 as a one-time App Store purchase; the Mac / Windows / Android / Linux versions are free. Mac downloads are available for Apple Silicon and Intel. Windows uses the 64-bit installer, Android uses the arm64 installer, and Linux users can choose deb, rpm, or AppImage for their distribution. Download installers from the relevant platform link in this site’s download guide; they’re served from this site’s /dl/ directory.
Which Mac download should I choose: Apple Silicon or Intel?
Open About This Mac from the Apple menu. If it shows Chip and an Apple M-series name, choose Apple Silicon. If it shows Processor and an Intel name, choose Intel. Both installers are dmg files, so the extension won’t tell you which architecture you need. Check the button label before downloading rather than guessing from the Mac’s appearance or purchase date.
Windows or Mac warns me when I first open Shadowrocket. How can I proceed?
First confirm that the file came from the relevant platform link in this site’s download guide. The desktop installers are not code-signed. Don’t proceed if the source is unknown or the system explicitly detects malware. If Windows SmartScreen only says the app is unrecognized, confirm the source, select More info, then choose Run anyway if that option appears. If macOS says the developer cannot be verified, try opening the file, then check System Settings → Privacy & Security for Open Anyway. Apply this only to the file in question; don’t disable system protection. If there’s no option to proceed or the device is managed by an organization, contact the administrator.
Android says apps can’t be installed from this source. What should I do?
First confirm that the arm64 installer came from this site’s Android download link. If Android says this source isn’t allowed to install apps, use the prompt to open Settings and enable Allow from this source for the browser or file manager you used to open the installer. This permission is set per source app, so you don’t need to grant it to other apps; you can turn it off after installation. An incompatible processor architecture or a security warning is a different issue, not a source-permission prompt.
Shadowrocket’s interface is in English. Which screens should I look for first?
On iPhone / iPad, start with Home, where you’ll find the connection switch and SERVER list. For a single server, look for Add Server; to view the active rules file, open Config. Global Routing controls how requests are handled after connecting. On Demand in Settings controls when to connect automatically. Use these English labels in the quick-start guide; there’s no need to change your system language first.
Import
Subscriptions & server imports
This section assumes you already have a subscription or server details. Use Subscribe for a full subscription link; enter single-server details field by field according to the protocol.
What should I check first if a subscription won’t import?
In Add Server, first make sure the type is set to Subscribe, not a single-server protocol. Copy the full subscription link again and check that the beginning, query parameters, and end weren’t truncated when it was shared. Remove any accidental spaces or line breaks. If the network works but the import still fails, ask the provider of the link whether it has expired and whether it returns content the client can read. Don’t post the full subscription link publicly while troubleshooting.
How do I fill in Add Server with details for a single server?
In Add Server, choose the protocol that matches your server details, such as Shadowsocks, VMess, or Trojan. Then enter the address, port, and authentication fields required by that protocol. Don’t enter a full subscription URL in the address field or reuse fields from another protocol. After saving, return to Home, confirm the new entry appears in the SERVER list, and select it before testing.
How can I update a subscription without affecting manually added servers?
Find the existing subscription group in the SERVER list on Home and update that subscription; there’s no need to clear the whole list first. After the update, check whether the previously selected server is still in the group. If it was removed, select another available entry in the group and test again. If the provider has changed the link, verify the new address and keep any manual entries you need before replacing the old subscription. Adding the same link twice can make the old and new entries hard to distinguish.
Why can’t I connect even though my server list appeared after importing?
A populated list only means the details were read; it doesn’t confirm that a server is currently reachable. Select the entry you want in the SERVER list on Home, then run Connectivity Test for an initial check. If every entry in the same subscription group fails, first confirm that the device itself has internet access. If only one entry fails, check that entry’s address, port, and credentials rather than reimporting the entire subscription.
Routing
Routing & troubleshooting
Check device permissions and the basic network first, then compare the same request under different routing modes. Don’t change servers, DNS, and rules all at once.
The connection switch on Home won’t turn on. What should I check?
The first time you connect on iPhone / iPad, iOS asks permission to add a VPN configuration. If you previously declined, return to Home, try again, and follow the system prompt. If the switch turns on and immediately off, make sure an entry is selected in SERVER and check whether another VPN is already running. On managed devices, ask the administrator whether changes to VPN configurations are restricted.
Shadowrocket says it’s connected, but I still can’t access the internet. Why?
Disconnect first, then use the same app to open the same address and check whether Wi-Fi or cellular data works normally. If the underlying connection is fine, reconnect and test with Direct, then compare the result with your original Global Routing mode. If Direct works but Proxy doesn’t, test the current server. If Proxy works but Config doesn’t, check the active configuration file, the first rule matching the destination domain, and DNS settings. Change one thing at a time and note the results before and after.
Which Global Routing mode should I use: Config, Proxy, or Direct?
Config routes traffic according to the rules in the active configuration file and is suited to everyday use once the rules are verified. Proxy sends requests handled by the client through the proxy and can help test the current server. Direct bypasses the proxy server while the client remains connected, making it useful for comparison when troubleshooting. Direct does not turn off the connection switch on Home. Restore your original mode after testing.
Shadowrocket is using more battery while idle. Should I turn off On Demand?
Check battery usage and activity times in your device’s battery settings, and see whether the drain coincides with a background connection, network changes, or a weak signal. If you only need a connection in certain situations, pause On Demand in Settings and compare battery use over similar periods; connect manually from Home when needed. If you need automatic connections, review the Wi-Fi and cellular triggers. Don’t infer the cause of battery drain from the switch state alone.