Official User Guide · FAQ Index

Shadowrocket FAQ

First identify where the problem occurs: getting the app or making a purchase, installing it for the first time, importing details, or handling requests after connecting. The four sections below lay out what to check in order. Expand a question for the steps.

This guide assumes you already have your own subscription or server details. For installation options, see Download for All Platforms. For your first setup, follow the Getting Started guide in order; see Settings Reference for details.

PURCHASE & IDENTITY

Genuine App & Purchases

Check the platform, store listing, and purchasing account before deciding whether to restore a purchase.

Can I use Shadowrocket on a computer or Android device? How do I get it?

Yes. Shadowrocket is available for iPhone, iPad, Mac, Windows, Android, and Linux. The iPhone and iPad version costs $2.99 as a one-time purchase on the App Store. Versions for Mac, Windows, Android, and Linux are free. Choose your device on the all-platform download page. Mac downloads include separate DMG files for Apple Silicon and Intel; other installers are available from this site under /dl/. Before installing the desktop or Android version for the first time, read the download page’s instructions for handling system security prompts.

How can I verify that an App Store listing is the genuine Shadowrocket app?

Check the app name, Shadowrocket, the official icon, the developer, Shadow Launch Technology Limited, and app ID 932747118 in the product page URL. Don’t install an app based on a similar name alone. Price can also help verify the listing: the iPhone and iPad version costs $2.99 as a one-time App Store purchase; versions for Mac, Windows, Android, and Linux are free. Stores display the final price in local currency. Check the App Store page for system requirements.

What should I check if Shadowrocket doesn’t appear in App Store search?

Open the product page from this site’s all-platform download page, then check the country or region of the Apple Account used for Media & Purchases. The app isn’t available in the mainland China App Store. If you need to change your region, follow Apple’s official path in Settings: Apple Account → Media & Purchases → View Account → Country/Region. Review any requirements for your balance, existing subscriptions, and payment method first. Changing your device language or network location does not change your store region. Availability on the product page is the final check.

Do I need to buy Shadowrocket again when I replace my iPhone or use it on an iPad?

You can use the purchase associated with the same Apple Account on both iPhone and iPad. When replacing a device or reinstalling the app, make sure Media & Purchases in the App Store is signed in to the original purchasing account, then look for Shadowrocket in your purchased apps. If you still see a price, check your account and store region before paying again. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; versions for Mac, Windows, Android, and Linux are free. Reinstalling the app won’t automatically restore all local settings, so back them up separately before transferring devices.

Why do I still need my own subscription or server details after buying the app?

A one-time app purchase is not a service plan. Shadowrocket reads server details, establishes connections, and applies rules; buying the app does not include access to a server. This is the official website and user guide. It does not provide, sell, or recommend servers or subscriptions. Before setup, have your own subscription link or server details ready and make sure they’re still valid. Check import, update, and connection issues separately; an app purchase does not confirm that a service is active.

INSTALL & FIRST CONNECTION

Installation & First Launch

First check your device architecture and the installer’s source. Handle system installation warnings separately from connection errors inside the app.

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

Open About This Mac from the Apple menu. If the Chip field shows Apple Silicon, choose the Apple Silicon version. If the Processor field shows Intel, choose the Intel version. Don’t guess based on the case, purchase year, or browser detection. Back up your existing Config before installing the matching DMG from the download page. If you see an “unverified developer” warning the first time you open the app, confirm the installer came from this site, then go to System Settings → Privacy & Security and look for the option to open the app anyway.

How should I handle a security warning on Windows or Mac?

First make sure the installer came from this site’s download page and has a path under /dl/. Don’t allow files from unknown sources to run. If Windows SmartScreen shows “More info,” verify the file’s source before choosing “Run anyway.” On managed devices, contact your administrator. For a Mac “unverified developer” warning, go to System Settings → Privacy & Security and choose “Open Anyway.” If the system explicitly reports malware, stop and check the file’s source. Don’t disable device-wide protection to force the installation.

What should I do if Android blocks installation or a download link doesn’t work in WeChat?

Open this site’s all-platform download page in your system browser instead of repeatedly tapping the link in WeChat’s built-in browser. After downloading, Android may ask you to allow the browser or file manager to install unknown apps. Grant temporary permission only to the app that starts the installation, and turn it off afterward. Settings names vary by manufacturer; search for the option in system settings. If Android reports an incompatible package or a parsing error, check your device architecture and make sure the file downloaded completely. Don’t keep broadening system permissions.

Can I install Shadowrocket on iPad? Does the first launch require VPN configuration permission?

Shadowrocket can be installed on iPad; check the App Store page for system requirements. The first time you try to connect, iPadOS asks to add a VPN configuration. Make sure the request comes from the Shadowrocket app you just opened, then follow the system prompts to grant permission and complete device authentication. If you cancel, you’ll need to start the connection again. This permission allows the app to create a connection; it doesn’t confirm that your server details are correct. After granting permission, select one of your existing servers and check Global Routing.

The connection switch turns off immediately. What should I check, and in what order?

First, check that you’ve selected a complete server entry. Then confirm that system permission for the VPN configuration has been granted. Pause other apps that may be using the VPN, check whether device management policies restrict connections, and try opening Shadowrocket again. If it disconnects immediately, check the error for this attempt in Log, especially the protocol, address, port, and required authentication fields. Don’t delete all your configurations as a first step. Back them up, then change one parameter at a time to identify the cause.

SUBSCRIBE & IMPORT

Subscriptions & Server Imports

Identify what kind of details you have before choosing an import method. Manage subscription updates separately from changes to manual entries.

What’s the difference between Subscribe and Add Server?

Subscribe saves a subscription link you already have and retrieves its server list when you update it. Add Server creates a single entry, with the address, port, and authentication details filled in for its specific type. Entries in a subscription are usually managed remotely, so manual changes may be overwritten at the next update. Manage any manual entries you want to keep separately. Both options are ways to import details; neither verifies that a service is active or guarantees that an entry will connect.

A subscription import fails or shows an empty list. What should I check first?

Make sure you pasted the complete subscription URL provided by your service provider, not an account management webpage. Check for extra spaces, line breaks, or punctuation at either end. Then confirm that the subscription hasn’t expired or been reset and that the response is in a format the app can read. If the request times out, check whether your current network can reach the subscription URL. A login page can open in a browser but cannot be imported as a subscription. When contacting your provider, describe the error without sharing the full subscription URL.

How do I update an existing subscription, and why did its names or server count change?

Update the existing subscription from its group’s action menu. The button location depends on the current app version; you don’t need to add another Subscribe entry every time. An update retrieves the list currently returned by the remote service, so names, counts, and available entries may change. If a previously selected entry was removed, select another one. Note the group and current selection before updating, then check the result message. If the update fails, keep the existing list and record the error. Don’t repeatedly delete and recreate the subscription to mask an invalid URL.

What should I do if scanning a QR code or pasting text doesn’t give me a usable server?

Scan QR Code reads the contents of a QR code, but not every QR code contains server settings. First make sure it contains server details you already have, rather than a webpage URL, image caption, or account login code. When importing pasted text, copy the entire string, including the protocol prefix and trailing parameters. After import, check Type, address, port, and authentication details. Use Subscribe for a subscription URL and Add Server for a single set of server details. Don’t keep switching between import methods.

Is it safe to send a subscription link or configuration file to someone for troubleshooting?

Don’t share a full subscription link, server password, or configuration containing authentication details publicly. Subscription URLs often include account-identifying parameters, and anyone with the link may be able to access its contents. For troubleshooting, share the error message, steps to reproduce it, protocol type, and rule snippets with sensitive details removed. Redact addresses and authentication fields from screenshots. Keep configuration backups somewhere you control. If a link has been exposed, reset it through your own service provider account, then update the saved URL in Shadowrocket.

ROUTING & DIAGNOSTICS

Routing Rules & Troubleshooting

Note the current mode and error first, then change one condition at a time. Connection status, server tests, and actual request results are different things.

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

Config uses the rules in the current configuration to route requests and is suitable for everyday use when those rules are set up correctly. Proxy generally sends requests that the app can handle through the current proxy policy; it can help diagnose routing issues temporarily. Direct connects to the destination directly and doesn’t test whether a proxy server works. Before troubleshooting, note the original mode. Change one condition at a time, test the same destination, then restore the original setting. If your interface also shows Scene, check its scene-specific settings separately; it isn’t another name for these three modes.

The connection shows as successful, but webpages still won’t load. How can I troubleshoot?

A connected status means the local connection process was established; it doesn’t guarantee that every request will succeed. Disconnect first and confirm the device’s basic network works. Reconnect and test a specific destination. Check that the selected server, Global Routing, and Config match your expectations, then look in Log for the rule and error associated with that request. If a domain fails but its IP address behaves differently, DNS may be involved. If only certain destinations fail, check their rules first. Connectivity Test results can offer clues, but they don’t replace testing an actual webpage or app request.

Rules aren’t routing traffic as expected. How do I check DOMAIN-SUFFIX and FINAL?

First confirm Global Routing is set to Config and that you’re editing the configuration currently in use. Rules are generally matched in order, so a broader rule near the top may match before a more specific one below it. DOMAIN-SUFFIX matches domain suffixes. Put FINAL after the regular rules you want to check so it acts as a fallback. Also verify that every policy name referenced by a rule exists. Save a copy before making changes, then send the request again and check Log. A rule appearing in the editor doesn’t prove that it’s active.

The interface is in English. How should I follow the user guide?

The user guide keeps interface labels in English so you can match them directly: Home shows connection status and servers; Add Server adds an entry; Subscribe manages existing subscriptions; Config manages configurations; Settings contains app settings. If your device supports choosing a language for individual apps, check the available options in system app settings. Language availability depends on what the app offers. Don’t change protocol types or configuration keywords to translate interface labels. Syntax such as DOMAIN-SUFFIX, GEOIP, and FINAL must stay as written.

Battery or data use increased after enabling On Demand. What should I check?

Compare system battery records over the same duration and under similar network conditions. Separate foreground app use, network traffic, and connection maintenance instead of judging by battery percentage alone. Check for frequent speed tests, repeated reconnections, continuous detailed Log recording, and switching between Wi-Fi and cellular networks. On Demand triggers connections based on conditions; if the connection starts again after you turn it off manually, review those conditions. Temporarily disable automatic connection conditions you don’t need, observe the same usage scenario, then restore any settings you still need.

For details on DNS, On Demand, or Log, see Settings Reference.