Official Manual / FAQ

Shadowrocket FAQ

Find answers by step: getting the app, installation, importing, or connecting. First identify where the problem occurs, then adjust the relevant setting instead of changing server details and rules at the same time.

Getting the App

Verify the app and check pricing

Check your platform, store account, and purchase history before deciding whether you need to get the app again.

Can I use Shadowrocket on a computer or Android? How much does it cost on each platform?

Yes. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. To get the desktop and Android installers, visit the app download page on this site; files are downloaded from /dl/shadowrocket/. If the system blocks the first installation, confirm the file’s source and your device architecture, then follow the installation steps on this page. Don’t disable system-wide security protections.

How can I verify Shadowrocket on the App Store?

Open the product page and check the name Shadowrocket, developer Shadow Launch Technology Limited, and app ID 932747118. Compare the listing with the official icon in this site’s header. The iPhone and iPad app costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. Don’t rely only on a search result’s name or a similar-looking icon. Check the App Store listing for local pricing and system requirements.

Can’t find Shadowrocket in the App Store? What should I check?

Start with the App Store product page linked on this site to tell whether the app is missing from search or unavailable in your region. The app isn’t available in the mainland China App Store. On your device, go to Settings > Apple Account > Media & Purchases and check Country/Region. If you need to change it, follow Apple’s official account-region process and review its requirements for account balance, active subscriptions, and payment methods first. Your device language and region aren’t the same as your App Store account region; repeatedly changing the system language usually won’t help.

Do I have to buy Shadowrocket again after getting a new device or reinstalling it?

On iPhone or iPad, sign in with the account used for the original purchase, then find Shadowrocket in App Store purchase history and download it again. Both devices can use the same account’s purchase history. The iPhone and iPad app costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. If the store still shows a purchase button, check your purchase history, signed-in account, and store region before paying again. Reinstalling the app won’t restore your previous configuration, so back up your configuration separately before switching devices.

Can I install Shadowrocket on iPad? Where can I check the system requirements?

Yes. The iPhone and iPad app is available on the App Store for a one-time purchase of $2.99. The Mac, Windows, Android, and Linux versions are free. Check the App Store listing on your device for iPhone and iPad system requirements and compatibility. If the button isn’t available, check system compatibility, account region, available storage, and installation restrictions in Screen Time. These issues aren’t directly related to whether your rule file is valid.

Does Shadowrocket include servers I can connect to?

Buying the app once doesn’t include a server plan. Shadowrocket reads configurations, applies rules, and establishes connections; you’ll need your own subscription or server details before using it. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. This site provides the app and its official manual, but doesn’t provide, sell, or recommend servers or subscriptions. Installing the app, importing a configuration, and connecting to a server are separate steps, each of which needs to be verified.

Devices and permissions

Download, install, and approve system prompts

Choose the file that matches your device. After confirming it came from this site, follow the relevant system prompts.

Which Mac version should I choose: Apple silicon or Intel?

Open About This Mac from the Apple menu. Choose the Apple silicon version if the processor name lists an Apple chip, or the Intel version if it lists an Intel processor. Don’t choose based only on the year you bought your Mac. Both versions are available from the app download page on this site. If you see a developer verification warning on first launch, confirm the download came from this site, then go to System Settings > Privacy & Security, find the blocked app, and select Open Anyway. If the architecture doesn’t match, download the correct installer; repeatedly approving the prompt won’t fix an architecture mismatch.

Mac says the developer can’t be verified or the app is damaged. What should I do?

First confirm the installer came from this site, then move the app to Applications. If macOS can’t verify the developer, try opening the app once, then go to System Settings > Privacy & Security and select Open Anyway for that app. If macOS says the app is damaged, download it again and confirm you chose the correct chip version. Once you’ve verified the source, you can run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening the app again. This command removes the app’s extended attributes; run it only on this verified app, not on a wider directory.

Windows SmartScreen warns that Shadowrocket may be risky. How can I proceed?

First confirm the file is the 64-bit Shadowrocket installer downloaded from this site’s app download page, then check the filename and save location shown in the warning. If they match, select More info in the SmartScreen prompt, then select Run anyway. If the device is managed by your organization, the button isn’t available, or security software reports a specific threat, pause the installation and investigate. Don’t disable all protections or bypass organization policies. After installation, review any system permissions needed for connections individually; a rule problem isn’t an installation block.

Android installation is blocked. Which permissions should I allow?

Download the arm64 installer from this site’s app download page. Open the file and follow the system prompt to enable Allow from this source for the browser or file manager you’re using. Grant installation permission only to the source you’re using, and revoke it afterward if you like. The first time you connect, you’ll also need to approve the system VPN connection request. Installation permission and VPN authorization are separate. If your device has management restrictions, check those requirements rather than repeatedly tapping Install to override system prompts.

Which Linux package should I choose? What if AppImage won’t open?

Choose the deb or rpm package on this site’s app download page to match your distribution. For AppImage, enable Allow executing file as program in the file’s properties, or enter chmod +x followed by the actual filename in Terminal. Run the command from the download directory, and use quotes if the filename contains spaces. If it still fails, launch the file from Terminal and note the exact error to distinguish permission, architecture, and runtime dependency issues. Don’t recursively grant execute permission to the entire Downloads directory or use administrator privileges to mask missing dependencies.

Do I need to uninstall Shadowrocket before updating?

Back up your current Config, any server details you maintain, and any settings you need, then update through the original platform. On iPhone and iPad, check for updates in the App Store. For Mac, Windows, Android, and Linux, download the installer for your platform and architecture from this site’s app download page. If the system blocks the first launch, follow the relevant steps in the installation section. Don’t uninstall as your first troubleshooting step; uninstalling may also remove local data. App updates and Subscribe content updates are separate, so completing one doesn’t update the other.

Existing configurations

Import subscriptions and server details

Tell subscription URLs, individual servers, and Config files apart, then check that each one was saved and updated correctly.

How do I import an existing subscription link?

On iPhone or iPad, open Home, tap Add Server, and select Subscribe. Enter your complete existing subscription URL, then save it with a name you’ll recognize. Update the subscription, confirm the expected entries appear in the list, then select a server and test the connection. Don’t enter a browser account page URL instead of a subscription URL, or remove parameters from the end of the link. A subscription URL may contain credentials; don’t share the original link or an uncropped screenshot that includes it when troubleshooting.

Subscription import failed. Should I check the link or the protocol first?

First check that the link is complete, has no leading or trailing spaces or line breaks, and hasn’t lost parameters during copying. Then check whether your current network can reach the URL. If the response can’t be parsed, check whether it’s actually a login page, an error message, or an unsupported format before changing the server protocol. If updates used to work but suddenly stopped, check whether the link has expired or the server-side content has changed. Test one factor at a time. Hide any access credentials in the URL when recording an error, and distinguish network failures from format issues.

Subscribe is imported, but no servers appear in Home. What should I do?

Saving a Subscribe entry doesn’t mean its content was successfully fetched. Try updating it and check for an error, then expand the relevant group to see whether its contents are collapsed or filtered. If the update succeeds but the list is still empty, check whether the original subscription actually includes server entries and whether its format is supported by the import method you’re using. Don’t create multiple copies of the same subscription to troubleshoot; that makes it harder to identify which entry to update. Keep one clearly named entry and use it to check the update result.

The QR code scan left out some settings. Can I connect anyway?

Don’t connect yet. Scan QR Code reads the encoded content; a successful scan doesn’t guarantee a complete server configuration. Open the entry for editing and check the type, address, port, authentication fields, and any required TLS or Server Name settings against your server details. If the QR code contains a subscription URL, manage it through Subscribe rather than as an individual server. Don’t guess missing fields based on other entries. Save only after confirming the complete details, then run Connectivity Test first.

How do I update an existing subscription, and what happens if the update fails?

Find the relevant Subscribe entry in Home and update it. When finished, check the server list and the currently selected server. If automatic updates are enabled, check the most recent result rather than relying on the toggle alone. If an update fails, keep the existing entry and configuration; don’t rush to delete and recreate them. The existing list may still be there, but server connectivity depends on the server’s status. Subscription updates refresh server information. Manage rule files in Config separately, using their own source and update method.

Why do my manually changed server settings revert after an update?

Server details managed by Subscribe usually follow the content returned by the subscription, so manual changes may be overwritten the next time it updates. If you need to test settings temporarily, note the original values and give the test entry a different name from the subscription-managed entry. Don’t rely on a temporary edit as a permanent sync method. If the server details have changed, check whether your existing subscription now returns the updated information. When troubleshooting is done, remove unused test entries and confirm which server is selected in Home so you don’t connect to an old copy.

Routing and diagnostics

Routing rules and connection troubleshooting

Check the original network, server, routing, and DNS in order. Keep the original settings and change one thing at a time.

How do I choose Config, Proxy, or Direct in Global Routing?

For everyday rule-based routing, choose Config and confirm the active Config file is valid. To temporarily compare the proxy route, choose Proxy. To check whether the original network can reach a destination, choose Direct. Proxy won’t fix incorrect server settings, and Direct doesn’t mean the proxy server has recovered. During troubleshooting, use the same destination and network, switch only one routing mode at a time, and note the result. Restore your usual Config when done. These modes determine routing behavior; they don’t replace a server connectivity check.

The connection switch won’t turn on, or turns off right away. What should I do?

First check whether the system is asking you to authorize the VPN configuration, and complete device authentication. If you previously denied authorization, review the relevant configuration status in system settings. Then confirm Home has a valid server selected, the current Config can be read, and no other service is using the VPN connection. Device management policies may also restrict connections. If the switch immediately turns off, note the message and logs. Don’t start by changing DNS or a large number of rules. Troubleshoot access failures only after the connection stays on.

It says connected, but websites won’t load. What should I check, and in what order?

Disconnect first and confirm the original network can reach a known working destination. Reconnect and run Connectivity Test for the current server. If the test fails, check the address, port, protocol settings, and system time. If the test succeeds but the destination still fails, check Global Routing, the matching policy in the current Config, and DNS results. Repeat the test with the same destination, changing only one setting at a time. Connected only means the local connection process was established; it doesn’t mean every remote destination is reachable. Hide server addresses, authentication fields, and subscription credentials before sharing logs.

My rules look right. Why isn’t traffic being routed as expected?

First confirm Global Routing is set to Config and that the active file is the one you edited. Rules are matched in order; a broad rule earlier in the list may match first, preventing later DOMAIN-SUFFIX or IP-CIDR rules from taking effect. FINAL should be the last policy for traffic that doesn’t match an earlier rule. Then check that the policies referenced by the rules exist, and identify the actual domain or address the destination is connecting to. Test with a new request after saving. If needed, close existing connections first so an old connection’s route isn’t mistaken for a rule that failed to update.

The interface is in English. Which settings should I learn first?

Start with the relevant screen: Home shows servers and connection status; Add Server adds existing server details; Subscribe manages existing subscriptions; Config manages configuration files; Global Routing sets the routing mode; Settings contains preferences; and Data shows traffic records. This manual keeps these interface labels in English so you can match them directly to the app. Check which screen you’re on before changing a setting, and don’t change an unrelated switch just because its label sounds similar. Keep protocol names and rule keywords as written; don’t enter translated explanations in configuration fields.

Battery use increases after connecting. Which settings should I check?

Start with your system’s battery usage details to distinguish the effects of screen time, background transfers, and network conditions. Compare similar usage durations on the same network. Continuous transfers, weak signals, frequent reconnects, extensive diagnostic logging, and overly frequent tests can all increase battery use. Check whether On Demand is triggering repeatedly. When you finish troubleshooting, turn off detailed logs and continuous tests you no longer need, and make sure your rules aren’t routing unnecessary traffic through the proxy. Protocol performance also depends on the server and network; don’t replace your entire configuration based on a single battery drop.