Official Manual · FAQ Index

Shadowrocket FAQ

Find answers from purchases and installation through subscriptions and rule troubleshooting. Choose the step you’re working on, then check each item in the answer. Change one setting at a time.

Select a question to expand the answer. When reporting an issue, include your device OS, steps to reproduce, and the exact error message. Hide subscription URLs and authentication details.

Verify and buy

Check the app, storefront region, and original purchase account before downloading or restoring a purchase.

How much does Shadowrocket cost? Does buying the app include a service subscription?

The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Prices may be shown in local currency; check the store page for the current amount. Buying the app does not include a service subscription. The purchase grants use of the client; get any subscription or server details needed to connect from your service provider. This is the Shadowrocket website and official manual; we do not provide, sell, or recommend servers or subscriptions.

How can I verify Shadowrocket in the App Store?

Open the specified App Store product page and verify the app name Shadowrocket, developer Shadow Launch Technology Limited, app ID 932747118, and official rocket icon with a white background and blue-purple outline. Don’t rely on the name in search results alone. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Get desktop and Android installers from this site’s app download page; downloads are served from this site’s /dl/ path.

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

First check the country or region associated with the Apple ID used for the App Store, not just your device language or current location. The app is not available in the China mainland storefront; open the product page to check the storefront notice. To change your region, go to your Apple ID in Settings and follow Media & Purchases, View Account, then Country/Region to review Apple’s process. Check any requirements involving your balance, active subscriptions, and payment method first. Changing your device language does not change your storefront region.

Do I need to buy Shadowrocket again after replacing my iPhone, reinstalling the app, or switching to an iPad?

Usually not. Sign in to the App Store on your new iPhone or iPad with the account used for the original purchase, find Shadowrocket in your purchased apps, and download it again. The iPhone and iPad app is a one-time $2.99 App Store purchase and works on both devices. The Mac, Windows, Android, and Linux versions are free. If the App Store shows a purchase button again, check your account, purchase history, and current storefront before paying again. Redownloading the app does not restore local settings, so save your subscriptions and configuration separately before switching devices.

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

Yes. Get Shadowrocket for iPad from its App Store product page. Check the compatibility section before installing; the system requirements for iPhone and iPad are as listed on the App Store page. Don’t rely on tutorial screenshots to determine whether your device is compatible. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Both mobile devices can download the app with the original purchase account, but check subscriptions, server settings, and local rules separately.

Why is the app interface in English? How should I interpret the English terms in this manual?

This manual uses the original interface labels so you can find each item: Home is where you access connections and servers, Config manages configuration files, Settings contains app settings, and Data shows traffic records. First check whether your system offers a language option for Shadowrocket; availability depends on the app and system. If English is the only option, follow the English labels. Don’t change settings based on approximate machine-translated terms. Layout and option locations may vary by device.

Install on any platform and open the app for the first time

Check your operating system and chip architecture first. If the system blocks the app, verify the file’s source before allowing that specific app to open.

Can I use Shadowrocket on desktop and Android?

Yes. Shadowrocket is available for Mac, Windows, Android, and Linux. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Choose your operating system and architecture on the app download page; installers are served from this site’s /dl/ path. When installing for the first time, check the macOS Privacy & Security prompt, review the Windows SmartScreen warning, or allow the browser used for the Android download to install unknown apps. Verify the source before proceeding.

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

Open About This Mac from the Apple menu and check the Chip or Processor field. Choose the Apple Silicon .dmg if it shows an Apple chip, or the Intel .dmg if it shows Intel. Don’t infer the architecture from the computer’s appearance, purchase year, or browser. Move the app to Applications before opening it. If macOS can’t verify the developer, confirm the installer came from this site, then choose Open Anyway in Privacy & Security in System Settings. Button names may vary by macOS version.

What should I do if Windows SmartScreen displays a warning?

First confirm that you downloaded the installer from this site’s app download page and that your device meets the installer’s system and architecture requirements. If SmartScreen says it protected your PC, select More info, verify the file, then choose Run anyway. If an organization policy blocks installation on a work- or school-managed device, contact your administrator; don’t try to bypass the policy. If you can’t verify the file’s source, stop and download it again from this site. Turning off system-wide protection is not an installation step.

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

First verify the download source and chip version, then move Shadowrocket to Applications and open it. If macOS can’t verify the developer, go to Privacy & Security in System Settings, find the relevant blocked app notice, and choose Open Anyway. If macOS says the app is damaged, download it again first. Only after confirming the app came from this site and the path is correct, run xattr -cr /Applications/Shadowrocket.app in Terminal to clear the app’s quarantine attribute, then try again. Use this only for an app from a verified source, never for an unknown file.

What should I do if I can’t download the Android version or Android won’t let me install it?

If tapping the link in WeChat’s built-in browser doesn’t start the download, use its menu to open this site’s app download page in your system browser, then choose the Android arm64 installer. After downloading, follow the system prompt to allow the browser or file manager to install unknown apps; grant permission only to the app that will install the file. You can revoke the permission afterward. If Android says the package can’t be parsed, check that the download is complete and the device architecture matches. Don’t repeatedly try to install the same incomplete file.

Which Linux installer should I choose, and what if AppImage won’t run?

Choose based on your distribution and device architecture: use the deb package on systems managed with deb packages, rpm on systems managed with rpm packages, or check whether AppImage is compatible with your environment if you want to run it directly. AppImage needs execute permission first. In the file properties, allow it to run as a program, then try opening it. If it still fails, launch it from a terminal and check the specific error, such as a missing dependency. Get installers from this site’s app download page. Before granting system permissions, verify the source and file path.

Need full instructions for your system? See installation and security prompts.

Subscriptions and server imports

These steps assume you already have a subscription or server details. First identify whether you have a subscription URL, a single server, or a configuration file.

Where do I import an existing subscription?

Get a Shadowrocket subscription link from your service provider. In Home, open Add Server, set Type to Subscribe, paste the complete link, and save. Wait for the list to update. Paste the subscription URL into the address field; don’t enter it as the hostname for a single server. If your provider gave you details for one server, add it manually using the corresponding protocol instead of trying to import it as a subscription. After importing, select a server and run Connectivity Test.

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

First check that the link was copied in full, including trailing parameters, and that it contains no line breaks or extra spaces and hasn’t expired. Confirm that your service provider returned subscription data, not a login page, verification page, or regular webpage. Then check that your current network can reach the subscription URL and that your device’s date and time are correct. If the error continues, note the exact message and ask your provider to confirm the link’s status and format. Subscription URLs may contain access credentials; hide the full URL and sensitive parameters in screenshots, chat logs, and public reports.

How do I update a subscription, and why did server names change afterward?

In Home, find the subscription group and use its update action. Wait for the request to finish, then check the list. An update may change server names, settings, or entries to match the latest information from your provider, so the previously selected server may change. Confirm the current server and test it after updating. If the update fails, don’t delete a group that still works; save the link and check the error first. Updating a subscription is separate from updating the app and does not automatically replace the Config file in use.

When should I use Scan QR Code instead of adding a server manually?

If you have a QR code, use Scan QR Code to read it, then verify the imported details. If you only have a list of settings, open Add Server, choose the Type that matches the protocol provided by your service provider, and enter the address, port, and authentication details. A QR code may contain a single server or a subscription URL; its appearance alone won’t tell you which. For VLESS, Trojan, and similar configurations, also check related settings such as TLS, SNI, transport, and path. A successful save only means the format was accepted; it doesn’t guarantee the server is reachable.

What’s the difference between a subscription and Config? Will deleting a subscription remove my rules?

Subscriptions are mainly for getting and updating server lists. Config manages settings such as rules and DNS; they serve different purposes. Deleting a subscription usually affects its server entries, not the Config itself. However, connection results may change if rules refer to a server or policy name that was removed. Before deleting a subscription, save its URL and your current configuration. Afterward, check the selected server and any rule references. Don’t use reimporting a subscription as a substitute for troubleshooting rules, or overwrite a tuned configuration just to update servers.

How should I clean up duplicate servers across multiple subscriptions?

Group entries by subscription source and update each group separately. Check whether duplicates came from importing the same subscription more than once or from different routes returned by your provider. Identical names don’t guarantee identical settings, so compare the protocol, address, port, and transport before deciding what to keep. If an entire group was imported twice, save the link and remove the extra group; it’s easier to verify than deleting entries one by one. Then reselect the server and check whether Config uses any fixed server names. Don’t bulk-delete entries by name if rules still refer to them.

For a first walkthrough, see the subscription import and connection guide. For definitions, see the quick reference.

Rule-based routing and troubleshooting

Narrow down the cause in this order: local network, server, routing mode, then rules. Verify connection status separately from access to the destination.

How should I choose between Config, Proxy, and Direct in Global Routing?

For everyday rule-based routing, choose Config; requests follow the Rules in the current configuration. To temporarily check whether the selected server can handle requests, switch to Proxy. To test your direct connection, choose Direct. Global mode usually refers to Proxy; it doesn’t mean every request bypasses all system restrictions. Change one setting at a time during testing, then restore your preferred mode. If results differ between Config and Proxy, check which rules match, DNS, and the final fallback policy.

The connection switch in Home won’t turn on or turns off right away. How do I troubleshoot it?

When connecting for the first time, approve the system prompt to add a VPN configuration and complete device authentication as instructed. If you denied it earlier, turn the switch on again to trigger the authorization prompt. Then confirm that a working server is selected, the current Config loads correctly, and no other conflicting VPN connection is active. On managed devices, check organization policies as well. If the switch immediately turns off, note any error from the app or system and check permissions and configuration one at a time. Don’t keep toggling the switch or delete all system network settings before making a backup.

I’m connected but can’t access the internet. What should I check first?

Disconnect first and confirm that Wi-Fi or cellular data works on its own; complete any public Wi-Fi sign-in if needed. Reconnect and run Connectivity Test on the selected server. If the test fails, check the server status and authentication settings. If it passes but websites still fail, compare the results in Proxy and Config, then check DNS and the Rule. A connected status only means the tunnel is established; it doesn’t guarantee the destination is reachable. Change one variable at a time and note the target domain and error so you can narrow down the cause without changing the server, DNS, and rules all at once.

Rules aren’t routing traffic as expected. Should I check rule order or policy first?

First confirm Global Routing is set to Config and that the selected configuration is the one you just edited. Rules are generally evaluated from top to bottom; the first match determines the policy. Put more specific conditions before broader rules, and place FINAL at the end as a fallback. Then check that the target domain matches conditions such as DOMAIN and DOMAIN-SUFFIX, and that PROXY, DIRECT, or REJECT is set correctly. After editing, start a new test connection and review available diagnostics. Existing connections may still use their previous routing results.

A persistent connection is draining my battery. How should I configure On Demand?

Compare battery use over the same duration on the same network, distinguishing the app’s own usage from traffic routed through the tunnel by other apps. Weak signal, sustained downloads, frequent reconnects, intensive rule processing, and continuous diagnostic logging can all add overhead. On Demand triggers connections under specified conditions; it isn’t a universal battery-saving switch. Make sure the trigger conditions match your actual network, then check whether connections keep restarting. For testing, temporarily reduce unnecessary background traffic and diagnostic logging. Avoid changing several settings at once, so you can identify the cause.

Can Data traffic stats confirm that rules are working? Why don’t they match my provider’s figures?

Data can help you monitor traffic, but an increase in total usage alone doesn’t prove that a particular Rule matched. Server and app views may cover different traffic, and your provider may use a different billing period, multiplier, or accounting method for protocol overhead. To verify a rule, note the starting reading, visit just one clearly identified destination, then compare the destination and policy in connection diagnostics. If you need to clear the stats, save any records you want to keep and confirm what will be cleared. Don’t treat the client’s stats as your provider’s billing figures.

Need to check rule syntax and matching order line by line? See the Shadowrocket rule reference.