Official manual · FAQ index

Shadowrocket FAQ

Find the issue by following the purchase, installation, import, and connection stages. Check the current state first, then change one setting at a time.

These steps assume you already have your own subscription or server details. For a step-by-step walkthrough, see the setup guide →

Downloads and accounts

Purchases

Check your platform and purchase account first. Restoring the app, restoring its configuration, and getting a server service are separate tasks.

Check downloads and verify your purchase →
How much does Shadowrocket cost, and does buying the app include a server 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 in other storefronts are shown in local currency, so check the store listing. Buying the app does not include a server subscription. Getting the app and subscribing to a server service are separate. Have your own subscription or server details before use; get subscription details from your provider. This site is the official website and manual. It does not provide, sell, or recommend servers or subscriptions.

Can I use Shadowrocket on a computer or Android device?

Yes. Shadowrocket is available for iPhone, iPad, 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. For computers and Android devices, choose an installer from this site's all-platform downloads page. Files are served from /dl/shadowrocket/. The first launch may trigger a system warning. Verify the source, then follow the installation guidance in this section or on the downloads page.

Can I install Shadowrocket on iPad, and do I need to buy it separately from the iPhone app?

Yes, Shadowrocket is available for iPad. The iPhone and iPad app costs $2.99 as a one-time App Store purchase and works on both devices. The Mac, Windows, Android, and Linux versions are free. On your iPad, sign in to the App Store with the account used for the original purchase, open your purchased apps, and download Shadowrocket again. Check the App Store listing for system requirements. If the app still shows a price, verify your purchase history and the account signed in under Media & Purchases before paying again.

How do I restore a purchase after switching devices or reinstalling the app?

On your new device, sign in to the App Store with the account used for Media & Purchases when you originally bought the app. Open your purchased apps, search for Shadowrocket, and download it again. The list name may vary by system version. The iPhone and iPad app costs $2.99 as a one-time App Store purchase and can be restored using the same purchase account. The Mac, Windows, Android, and Linux versions are free. Restoring the app does not restore all your settings. Recover subscriptions and configuration files from your own backup or provider records.

How can I verify the Shadowrocket listing in the App Store?

Open the App Store product page from this site's downloads page. Check the name, Shadowrocket, the developer, Shadow Launch Technology Limited, and app ID 932747118. Compare the listing with the official icon shown in this site's header. You can confirm the app ID in the product page URL; don't rely on the name in search results alone. For computers and Android devices, choose the appropriate installer from this site's downloads page. If a similar listing has a different developer or app ID, stop and verify the product page again.

Architecture and system permissions

Installation and first launch

Verify the file source and device architecture before handling system warnings. Only change settings for apps you've verified; don't disable system-wide protections.

View the installation approval checklist →
Which Mac version should I choose: Apple silicon or Intel?

Open About This Mac from the Apple menu. If it lists a Chip with an Apple M-series name, choose the Apple silicon version. If it lists an Intel processor, choose the Intel version. The downloads page provides a separate dmg for each architecture; don't guess based on the Mac's appearance or purchase date. Move the app to Applications before opening it. If macOS says it cannot verify the developer, confirm the installer came from this site, then look for the relevant Open Anyway option under System Settings → Privacy & Security.

Windows SmartScreen warning: what should I do?

First, confirm the file came from this site's downloads page, its URL is under /dl/shadowrocket/, and your device is running the required 64-bit version of Windows. If SmartScreen displays “Windows protected your PC,” verify the source, then select “More info → Run anyway.” This allows the app to run; it is not a safety assessment. If the warning comes from an organization policy, security software flags the file, or you can't verify its source, stop. Keep the warning details and investigate before proceeding. Don't disable system-wide security protection.

Mac says “cannot verify the developer” or “is damaged”—what should I do?

First, confirm the app came from this site and is in /Applications. For a “cannot verify the developer” warning, try opening the app, then go to System Settings → Privacy & Security, find the app's Open Anyway option, and follow the prompts. If the app is reported as damaged, download it again and replace the existing copy. After verifying the source and path, you can run xattr -cr /Applications/Shadowrocket.app in Terminal, then try opening the app again. This command clears extended attributes from that app; don't run it in bulk on unknown files. Follow administrator policies on managed devices.

Android says installation isn't allowed. Where can I enable it?

Download the arm64 installer from this site's downloads page. Android may ask you to enable “Allow from this source” for the browser or file manager you're using. Grant permission temporarily only to the app that opens the installer, then turn it off after installation. If parsing still fails, check that the download completed, the device architecture matches, and no older file is being used. Don't keep opening the same incomplete download. If WeChat restricts downloads, use its menu to open this site's downloads page in your system browser.

Which Linux package should I choose: deb, rpm, or AppImage?

Choose the package format used by your distribution: Debian- and Ubuntu-based systems typically use deb, while Fedora and similar systems typically use rpm. If you prefer a standalone app, check whether AppImage works in your environment. After downloading, work from the directory containing the file. For deb, run sudo apt install ./ followed by the actual filename; for rpm, run sudo dnf install ./ followed by the actual filename. For AppImage, run chmod +x on the file, then launch it. Verify the source and architecture first. If a runtime dependency is missing, install what the error identifies; don't repeatedly mix package formats.

The connection switch won't turn on the first time. What should I check?

On iPhone and iPad, the first time you enable the connection, Shadowrocket asks to add a VPN configuration. Allow it when prompted and complete device authentication. If you tapped Cancel, return to Shadowrocket and try again, then check in Settings that the VPN configuration exists. Make sure a valid server is selected, temporarily disconnect other apps using a VPN tunnel, and check whether a device profile or organization policy restricts VPN access. If the switch turns off immediately, note the exact error. Don't delete all configurations or mistake the system's approval to add one for a successful connection.

Importing and managing existing details

Subscriptions and server imports

Get subscriptions from your provider. An import failure, an update failure, and a server connection failure happen at different stages and should be checked separately.

Check the import steps in the guide →
Subscribe import failed: how can I tell whether it's the link or the app?

Make sure you're using the complete subscription URL from your provider—not a page title, description, or sign-in page URL. Check for leading or trailing spaces, line breaks, and truncated query parameters. Then confirm that Type is set to Subscribe in Add Server. Keep the exact error message: for a timeout, first check whether your current network can reach the subscription URL; for an unsupported format or no servers returned, ask your provider to confirm the content format and subscription status. Don't share a complete URL containing access credentials in public screenshots or discussions.

Why does Shadowrocket still show the same servers after a subscription update?

Make sure you updated the Subscribe group you're actually using, not a different group with the same name, and check whether the update completed successfully. A successful update only means that Shadowrocket fetched the content returned by your provider. If the provider hasn't changed the list, server names may remain the same. If something looks wrong, back up your current data, check the subscription status and expiration date, and ask your provider to verify the returned content. Don't repeatedly delete and recreate the group to refresh it. After updating, check that the selected server is still listed and that existing configuration references remain valid.

Scanned with Scan QR Code, but nothing was imported. Why?

Check camera permissions, make sure the QR code is clear and complete, and identify whether it contains server details, a subscription URL, or an ordinary webpage. A readable QR code doesn't necessarily contain data that can be imported as a server. If it contains a subscription URL, add it using Subscribe. If it contains server details, check the protocol type and required fields. Ask your provider for the original text to verify the contents rather than repeatedly scanning a blurry screenshot. QR codes may also contain passwords or subscription credentials; redact them before sharing.

Which fields should I keep separate when adding a server manually?

Select Type based on the details from your provider, then fill in the corresponding fields. Enter the server address in Address and the port in Port. Passwords, UUIDs, keys, and other authentication details belong in the fields for their respective protocols and aren't interchangeable. When using TLS, also check Server Name, certificate options, and any transport parameters required by your provider. The server address and TLS name may differ; don't change either just to make them match. If you're unsure about a field, check the protocol reference and ask your provider. Don't disable certificate verification to hide a parameter error.

My manually edited server settings disappeared after an update. How can I avoid this?

Subscription entries are usually maintained using data returned by your provider, and an update may recreate or overwrite them. Don't rely on manual changes to subscription entries as a permanent solution. If you need separate changes, back up your existing data first, save the required details as a separate manual entry, and give it a distinct name from the subscription group. Keep checking whether your provider changes the address, port, or authentication details. Server entry updates and Config file updates are separate; check their sources, contents, and enabled status independently.

What information can I share when troubleshooting an import issue?

You can share your device and OS, the selected Type, whether the failure occurred during import or connection, the full error message, and screenshots of relevant settings with sensitive details redacted. Hide access credentials in subscription URLs, passwords, UUIDs, Private Keys, and QR code contents. Field names can help with troubleshooting, but don't disclose their values. If your provider needs to check subscription status, use its existing private support channel. This manual covers importing and using the app; it doesn't need your subscription URL, server credentials, or account password.

From tunnel status to actual requests

Routing and troubleshooting

The connection switch, server tests, and requests to a destination are not the same thing. Keep test conditions consistent to identify which layer is causing the problem.

View protocol fields and selection guide →
Which Global Routing mode should I use: Config, Proxy, or Direct?

Config uses the rules in the currently enabled configuration to determine how requests are handled. Start here for everyday rule-based routing. Proxy sends requests handled by the app through the selected proxy, which can help determine whether a rule match is the issue. Direct connects those requests directly and can help establish a baseline for your local network. Changing modes doesn't switch servers or fix incorrect authentication details. For comparisons, keep the network, server, and destination the same, change one setting at a time, and restore your preferred mode afterward.

Connected, but can't access the internet. What should I check, and in what order?

Disconnect and make sure your Wi-Fi or cellular connection works on its own. Reconnect and verify that the correct server is selected. Then check whether all destinations fail or only some do. If everything fails, check server authentication, connectivity to the server, and DNS. If only some destinations fail, check which rules match and whether the destination service is available. Compare Proxy and Config briefly using the same destination. If only Config fails, review the current Config's Rule order and policy references. A VPN shown as connected only confirms the local tunnel state; it doesn't prove remote requests are succeeding.

Connectivity Test shows a result, but actual requests still fail. Why?

A test result applies only to the method and destination used at that time. Reaching the server port, completing a protocol handshake, resolving a domain, and accessing an app are different layers of testing; one result can't confirm them all. Make sure the test used the same server that's selected for actual use, then check the target request's routing policy and DNS. A few repeat tests on the same network and destination, with error types recorded, are more useful than comparing latency alone. Don't use test results to promise actual speeds or attribute a single timeout directly to an app fault.

Does On Demand affect battery life after connecting?

Battery use depends on ongoing traffic, wireless signal strength, protocol processing, network changes, and background requests—not just whether the VPN icon is visible. Compare similar periods in your system's battery usage statistics, then check whether frequent tests, detailed logging, or subscription updates are running continuously. On Demand triggers connections according to its conditions. If the connection quickly returns after you disconnect manually, review those conditions and temporarily disable them while testing. Don't change protocol authentication or transport settings just to reduce battery use; first stop unnecessary diagnostic activity and compare the results.

The interface is in English. Which sections should I start with?

This manual keeps interface labels in English so you can find them in the app: Home shows servers and connection status; Add Server adds server details; Subscribe identifies the subscription type; Config manages configuration files; Global Routing selects a routing mode; and Settings contains app settings. To change the display language, check whether your system offers a language option for the app and use only the options the app provides. The interface language doesn't change the meaning of server settings. If you're unsure what a switch does, note its original value and check the guide rather than trying every setting.

My Rule changes aren't taking effect. How do I check the active configuration and rule order?

In Config, first confirm that you're editing the file currently enabled. Then check that Global Routing is set to Config; don't expect the same rule-based routing in Proxy or Direct. Rules are generally matched from top to bottom. A broad rule near the top may match before a more specific rule below it. Keep FINAL as the fallback at the end. Also check that the policy name exists and is spelled correctly, and that a remote configuration update hasn't overwritten your local changes. After saving, retry the same destination and, if needed, check the logs to see which rule actually matched.