Official Manual · FAQ

Shadowrocket FAQ

First identify when the problem occurs, then check each item in turn. The questions below are grouped by availability, first launch, importing existing details, and connection troubleshooting. Interface labels such as Home, Config, and Settings stay in English so you can follow along in the app.

Get and install Import an existing subscription Check rules and connections

Before you download

Purchase and authenticity

Confirm your device, the App Store product page, and the original purchasing account before making or restoring a purchase.

Can you use Shadowrocket on desktop and Android? How much does it cost on each platform?

Yes. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Mac downloads are available for Apple Silicon and Intel. Get installers for other platforms from this site's download page; download URLs use the /dl/shadowrocket/ path. A one-time app purchase does not include a service plan. You'll need your own subscription or server details to use the app. This site does not provide, sell, or recommend servers or subscriptions.

How can you verify the official Shadowrocket app in the App Store?

Check the developer, official icon, and app ID—not just the name. Open the App Store product page linked here and confirm the developer is Shadow Launch Technology Limited and the app ID is 932747118. Then compare the icon with the official icon on this site. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. If any of these details differ, don't assume it's the same app.

Can't find Shadowrocket in the App Store? What should you check first?

Open the product page directly, then check your store region, age-rating restrictions, and account status. Confirm which account is signed in to the App Store. In system Settings, go to Apple Account → Media & Purchases → View Account → Country/Region to check the region, and review content restrictions in Screen Time. The app isn't available in the mainland China storefront. If you need to change your region, use this system path and first check any requirements for your balance, subscriptions, and payment details. Changing only your device's Language & Region won't change the store region.

Do you have to buy Shadowrocket again after changing devices or reinstalling it?

On iPhone or iPad, sign in with the account used for the original purchase, find Shadowrocket in the App Store's purchased apps, and download it again. If a purchase button appears, check the account, store region, and purchase history before paying again. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free and can be downloaded again from this site's download page. Restoring the app won't automatically restore all local settings. Back up Config and any existing subscriptions on the old device beforehand.

Can you install Shadowrocket on iPad? Is it obtained the same way as on iPhone?

Yes. Get Shadowrocket for iPhone and iPad from the same App Store product page. Check the App Store page for the current system requirements. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. If you use the original purchasing account, look for Shadowrocket in the purchased apps list on your iPad. After installation, check the connection permission, selected server, and Config. Purchase history and configuration data are separate—downloading the app doesn't mean your subscriptions and rules have been transferred.

Sources and system prompts

Installation and first launch

Verify the file's source before responding to system prompts. A clear threat warning is not the same as a prompt asking you to confirm the source.

Which Shadowrocket download should you choose for Mac: Apple Silicon or Intel?

Check About This Mac instead of guessing from the Mac's appearance or purchase date. Open the Apple menu → About This Mac. If it shows an Apple chip, choose the Apple Silicon version; if it shows an Intel processor, choose the Intel version. Then download the matching dmg from this site's download page and drag the app to Applications. If macOS says the developer can't be verified on first launch, confirm the file came from this site, then go to System Settings → Privacy & Security, review the prompt, and select Open Anyway. Don't disable system security checks.

Windows SmartScreen warns that Shadowrocket may be risky. How can you continue the installation?

First confirm the installer came from this site's download page and its URL uses this site's /dl/shadowrocket/ path. For a file whose source you've verified, select More info → Run anyway in the SmartScreen prompt, then follow the installer. If the file came from a chat, its source can't be verified, or the system reports a specific threat, stop and check again. Organization-managed computers may block users from allowing apps to run. Contact your device administrator rather than disabling protection to bypass management policies.

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

Check the download source and chip version first, then follow the steps for the specific message. For “developer cannot be verified,” try opening the app, then go to System Settings → Privacy & Security, select Open Anyway, and confirm. If macOS says the app is damaged, download it again and move it to Applications. Once you've confirmed the source is trustworthy, you can run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening the app again. This removes the app's extended attributes. Don't run it on files from unknown sources or apply it to entire directories.

Android: can't install the download, or download it from WeChat?

Open this site's download page in your system browser and download the arm64 apk. If WeChat won't download it, use the menu to open the page in a browser and try again. If installation is blocked, open system Settings and find the Install unknown apps permission for the browser or file manager you used. Temporarily allow installs from that source, then return to the installer. You can turn the permission off afterward. If you still see an incompatibility or parsing error, check the device architecture, available storage, and whether the download completed. Don't ignore an explicit system threat warning.

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

Choose a package format based on your distribution's package manager, and check the architecture requirements on the download page. Debian-based distributions usually use deb; distributions with an rpm package manager use rpm. For an executable format, consider AppImage. For a deb package, run sudo apt install ./Shadowrocket.deb from the directory containing the file, replacing the filename with the one you downloaded. For AppImage, run chmod +x Shadowrocket.AppImage first, then launch the file, replacing its name as needed. Grant execute permission only to files downloaded from this site. If dependencies are missing, follow your system's instructions.

The interface is in English. Where should you look for settings?

Use the interface labels to find what you need; you don't have to change the language first. Home shows servers and connection status; Add Server adds an existing server; Config manages configuration files; Settings contains app settings; and Global Routing selects the overall routing mode. If your system offers per-app language settings, look for Shadowrocket's language options in system Settings. Available options may vary. Before changing anything, make sure you're in the app rather than the system's VPN settings—their controls serve different purposes.

Use existing details

Subscriptions and server imports

First distinguish a subscription URL from individual server details. Importing, updating, and backing up serve different purposes; confirm where the details came from before deleting anything.

An existing subscription won't import. What should you check, and in what order?

Make sure you've copied the complete subscription URL you already have—not a sign-in page, instructions, or truncated text. Check for spaces or line breaks at the start, end, or within the URL, then confirm your current network can reach it. Choose Subscribe or the relevant import option for your existing details. For a QR code, use Scan QR Code. If you get a sign-in page, authorization error, or unsupported format, ask the original service provider to check the link's status and format. Don't post a full URL containing a token publicly or keep deleting existing configurations to troubleshoot.

How do you update a subscription, and why might the server list change afterward?

Updating a subscription reloads the server list from its original URL. Find the subscription group in Home, use its update action, and check the list when the update finishes. The button's location may vary by interface version. If servers are added, removed, or renamed, check the response from the original subscription and confirm which server is selected. A failed update doesn't mean the old list stops working immediately. Keep the existing entries while checking your network, authorization, and link status. Back up before updating multiple subscriptions, and don't mistake a single-server URL for a subscription URL.

Duplicate entries appear after import. Which group should you delete?

First distinguish manually added servers from subscription-managed entries; don't rely on display names alone. Check each group's source, address, port, and protocol to identify entries imported from the same subscription more than once. Back up your data, keep the group you want to continue updating, and remove only the group you've confirmed is a duplicate. If you delete an entry from a subscription group, it may reappear on the next update because the subscription still controls the list. To keep your changes, understand how local entries interact with subscription updates and record what you changed to avoid overwriting it.

A manually added server won't connect. Which fields should you check?

Check every field against the server details you already have, not just the address. Confirm that Type matches the protocol, then check the address, port, password or UUID, and any protocol-specific fields such as TLS, SNI, transport, and path. Fill in only fields included in your server details. Shadowsocks, VMess, VLESS, Trojan, and WireGuard use different fields; don't reuse parameters from another protocol. Save the entry, select it in Home, and run Connectivity Test. If it still fails, note the exact error and hide credentials before sharing it.

Change one thing at a time

Rules and troubleshooting

Check your local network, server, routing mode, configuration, and logs in that order. Record the conditions and result of each attempt.

How do you choose among Config, Proxy, and Direct in Global Routing?

Config applies the rules in the selected configuration; Proxy generally sends requests through the currently selected proxy; Direct connects directly. To route traffic by rules, make sure the intended file is selected in Config, then set Global Routing to Config. For troubleshooting, temporarily switch to Proxy and compare the result for the same destination. Direct can help check whether your local network is working. Change one setting at a time, record the result, and restore the original setting. Mode names don't indicate speed or security level.

The connection switch in Home won't turn on, or turns off immediately. What should you do?

First determine whether system authorization is incomplete or the server connection is failing. On your first connection, follow the system prompt to allow a VPN configuration and confirm with your device passcode or biometrics. Then return to Home and check that a valid server is selected. If the switch turns off immediately, check the error for that attempt in Log, then look for another VPN connection, device management restrictions, or an invalid configuration. Ask your administrator about permissions on a managed device. Don't toggle the switch rapidly or delete a system configuration without a backup. Restart the app, then reproduce the issue with one complete attempt.

Shadowrocket says it's connected, but websites won't load. What should you check next?

Connected means the connection process was established; it doesn't guarantee the destination website is reachable. Disconnect and confirm your local network works, then check the selected server in Home and whether its subscription is still valid. Next, check Global Routing and the current Config. If only certain domains fail, look in Log for the rule, policy, or DNS error affecting those requests. If nothing works, prioritize checking server reachability and authentication details. You can compare with another server you already have and know works, but change only one thing at a time. Changing DNS, rules, and connection settings together makes the cause harder to identify.

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

Connectivity Test may use a different destination and request path from the apps you use, so its result alone can't confirm that all traffic is working. Check the test method and destination in Settings, then try accessing the service you need on the same network. If the test succeeds but access fails, check DNS resolution, Global Routing, the rules matched in Config, and the destination service's status. If the test fails but access works, check whether the test destination is reachable instead of deleting the server right away. Keep the network and test method consistent when comparing results; don't treat values from different methods as a performance ranking.

Shadowrocket uses a lot of battery during long connections. Which settings should you check?

Compare similar usage periods and network conditions using your system's battery statistics; don't judge battery use by the VPN icon alone. Continuous traffic, a weak signal, repeated server reconnections, frequent tests, and extended detailed logging can all increase load. Check Log for repeated errors, stop unnecessary repeated tests, and return to your usual log level after troubleshooting. If you use On Demand, check the Wi-Fi, cellular, and domain conditions for conflicts that could trigger repeated connections. Change one setting at a time and observe the result; background battery use isn't always caused by a single switch.