Official Manual / FAQ
Shadowrocket FAQ
Find answers by where the issue occurs: the app is missing from the store, the system blocks the installer, the subscription list is empty, or you still can't access sites after connecting.
Verify and purchase
Check the product listing, account storefront, and purchase history.
How much does Shadowrocket cost? Does buying it include a subscription?
The iPhone and iPad version costs $2.99 as a one-time purchase on the U.S. App Store; both devices can use the same purchase. Prices in other storefronts are shown on the product page. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free, with installers available from this site's /dl/. Buying the app once does not include a service subscription. This site does not provide, sell, or recommend servers or subscriptions. To use a subscription, get one from your service provider.
How can I verify that a Shadowrocket App Store listing is genuine?
Open the App Store product page and confirm the developer is Shadow Launch Technology Limited. Then compare its icon with the official icon in this site's header: it should have a white background and a blue-purple outlined design. Finally, check that the app ID at the end of the product page URL is 932747118. Don't rely on search rankings or a similar-looking icon. If any of the three details don't match, return to the product page and check again.
Can't find Shadowrocket in the App Store? How do I check my account's storefront?
App availability depends on the storefront associated with the Apple ID used for purchases. The app isn't listed in the mainland China storefront. On your device, go to Settings › Apple Account › Media & Purchases › View Account › Country/Region to check the current storefront; changing your device's language or region won't change it. If you need to change your storefront to match your country or region of residence, use Change Country or Region on the same page and follow Apple's instructions for your balance, active subscriptions, and payment details.
How do I restore a purchase after changing devices or reinstalling the app?
On the new device, sign in to Media & Purchases with the Apple ID used for the original purchase. Open your App Store profile menu and find Shadowrocket in Purchased or your purchase history. Tap the download icon to reinstall it; you won't be charged again for the same purchase. If the page still asks you to pay, check the Apple ID, storefront, and app ID before placing an order. After reinstalling, import any configuration you saved, if needed.
Can I install Shadowrocket on iPad and use the same purchase as on iPhone?
Yes. The iPhone and iPad versions use the same App Store listing. Check the App Store page for system requirements. If you bought Shadowrocket on iPhone, sign in with the same Apple ID on iPad and download it from your purchased items. Purchase history and connection settings are separate: if the original servers aren't listed on the new device's Home screen, import a saved configuration or add your existing server details again.
Download, install, and open
Choose the installer for your device, then respond to any system prompts.
Can I use Shadowrocket on a computer or Android?
Yes. The iPhone and iPad version costs $2.99 as a one-time purchase on the U.S. App Store; the Mac, Windows, Android, and Linux versions are free. Choose an installer for your device from the all-platform download page under /dl/: use the 64-bit installer for Windows, the arm64 package for Android, and the deb or rpm package—or AppImage—for Linux. If you see a system warning during installation, first confirm the download source and your device architecture, then read the relevant installation instructions. Follow your organization's policy on managed devices.
Which Mac version should I choose: Apple Silicon or Intel?
Check the information shown in About This Mac. Open the Apple menu and select About This Mac. If Chip shows Apple Silicon, choose the Apple Silicon version. If Processor shows Intel, choose the Intel version. Both installers are in the Mac downloads section and use the .dmg extension, so the file extension or appearance of your Mac alone won't tell you which one to choose. If you install the wrong version, quit the app, download the one for your architecture, and replace it.
What should I do if Windows or Mac warns me about a security risk during installation?
The desktop installers aren't code-signed, so you may see a system warning when you first open one. Confirm the file came from this site's /dl/, and check your operating system and device architecture. If Windows only says SmartScreen couldn't recognize the app, you can select More info › Run anyway after verifying the source and confirming your device policy allows it. If macOS only says the developer can't be verified, try opening the app, then go to System Settings › Privacy & Security and select Open Anyway. Stop if the source is unclear, the system reports malware, or the device is managed by your organization. Don't disable system protections.
Android says installation isn't allowed. What should I check?
First, open the download page on this site in your browser and confirm the installer is from /dl/ and your device supports arm64. If the system only says the browser or file manager isn't allowed to install apps, open the Allow from this source page shown by the system and temporarily grant permission only to the app you're using to open the file. Turn off the permission when you're done. If the system reports an incompatible device, an unreadable file, or a security risk, don't proceed. Check the device architecture, whether the download completed, and the warning details.
The interface is in English. Where are the main controls?
Look for the labels as they appear in the interface. Home lets you select a server, view Global Routing, and toggle the connection. To add existing details, look for Add Server or Subscribe. Config is where you select and review configuration files, and Settings contains app options such as On Demand. If you're following a guide, you don't need to change your system language first. Identify whether you're working on a connection, server, or rule, then open the relevant screen to avoid making changes in the wrong place.
Import subscriptions and servers
First, distinguish subscription links from single-server details and share links.
How do I import a subscription link and check that it worked?
Use the complete subscription link from your service provider. On Home, open Add Server, select Subscribe, paste the link, and save it. Return to Home and check whether server entries appear under the subscription. Seeing only the subscription name doesn't mean the server list has loaded. If the entries appear, select an existing server, run Connectivity Test, and then try connecting.
Subscription import failed or the list is empty. How do I troubleshoot it?
First, make sure Add Server is set to Subscribe, not a single-server protocol. Check that you pasted the full subscription link, not an account page URL. Don't remove or edit query parameters, and make sure there's no leading or trailing whitespace or line break. If the link still won't load, check whether your current network can reach it, then ask your service provider to confirm the link is active and the response format is supported. Redact access credentials from the link when reporting the issue.
How can I confirm the updated subscription has loaded the new server list?
On Home, find the subscription you want to refresh and use its menu to update it. Wait for the list to reload, then check your usual servers. If a previously selected server was removed or renamed, select and test a server from the updated list; don't assume an old name still refers to the same connection. Give each subscription a distinct name and update them individually. If one won't open, check its link first; there's no need to delete the others.
I have server details but no subscription link. How do I add a server manually?
On Home, open Add Server and choose the protocol listed in your server details, such as Shadowsocks, VMess, or Trojan. Enter the address, port, and authentication details in the fields for that protocol. If your details specify transport or TLS settings, match the server configuration; don't copy them from another entry. Save the server and run Connectivity Test. If the test fails, check the protocol and port first, then review the authentication and transport settings.
Should I import a QR code or share link as a subscription or as a single server?
First determine whether the content represents one server or updates a group of servers. Scan an existing QR code with Scan QR Code, or import an existing share link from the clipboard. Before saving, check the type and address recognized by the app. Don't enter a single-server share link as a Subscribe link. Share links and QR codes may contain authentication details; keep backups in a secure place and don't post the original in a public issue report.
Rules, routing, and connection troubleshooting
Check the system network, server, and active rules in order.
How do I choose Config, Proxy, or Direct in Global Routing?
For everyday rule-based routing, choose Config. The active configuration determines which policy handles each matching connection. To temporarily check whether the selected server can handle a request, choose Proxy. To test whether your network works without a proxy, choose Direct. When troubleshooting the same site, change only one mode at a time and retry the request. Restore your original Global Routing setting once you've narrowed down the issue.
The connection switch on Home won't turn on. What should I check first?
Note whether the switch is unresponsive, turns off immediately, or prompts for system confirmation. The first time you connect, follow the system prompt to approve adding a VPN configuration. If you canceled before, turn it on again from Home and check whether the prompt appears. If it still disconnects immediately, confirm that the server and configuration required by the selected mode are in place, and check whether another VPN is running. If the device is managed or has system restrictions, check with your administrator; don't remove managed configurations.
It says connected, but webpages won't load. How can I narrow down the cause?
Test the same URL in stages. First, turn off the connection and confirm the current Wi-Fi or cellular network can access it. Then turn the connection on and run Connectivity Test for the selected server. If the server is reachable but the site only fails in Config mode, check the active file in Config, DNS settings, and rule order. Check whether the request matches REJECT or is routed to a policy that no longer works. Change one thing at a time and record the result; don't switch servers and change DNS at the same time.
My rule changes aren't taking effect. Should I check the configuration or rule order first?
On Home, confirm Global Routing is set to Config. Then open Config and make sure the active file is the one you edited. Check the rules from top to bottom to see which one matches the test domain first. If a broad DOMAIN-SUFFIX rule appears before an exact DOMAIN match, the later rule may never be reached. Save a copy before editing. After saving, retry the request, then check whether FINAL handles requests that don't match another rule.
Battery use seems higher after enabling the connection. How can I tell if On Demand is the cause?
On your device, go to Settings › Battery and check Shadowrocket's activity periods, distinguishing extended use from background activity while idle. If the connection often reconnects when switching between Wi-Fi and cellular, open Settings and check whether the On Demand conditions match what you expect. With similar network conditions and usage habits, change only one condition, observe battery use over a similar period, and compare the battery records. Don't draw conclusions from a single reading.