Shadowrocket Official Guide

Shadowrocket FAQ

Find answers by the stage you're at: check your purchase, install the app, review subscriptions, then troubleshoot connections and routing.

Verify the App Store listing and purchases

First check storefront availability, purchase history, and device compatibility.

How can I verify the official Shadowrocket listing on the App Store?

Open the App Store product page and check that the developer is Shadow Launch Technology Limited, the icon is a blue-and-purple outlined rocket on a white background, and the app ID in the page URL is 932747118. Search result names and icons are only useful for an initial check. If a listing has a similar name, verify that both the developer and app ID match.

Can't find Shadowrocket in the App Store? Check this first

Check which account is currently signed in to the App Store, not your phone's system language or region. On your device, go to Settings → your account name → Media & Purchases → View Account → Country/Region to check the storefront. App availability depends on the storefront. If you need to change it, select Change Country or Region on the same page, follow Apple's instructions for your balance, subscriptions, and payment details, then check the product page again.

Can I install Shadowrocket on an iPad?

Yes. iPhone and iPad use the same App Store listing. Sign in to Media & Purchases with the account used to buy the app to use it on compatible devices. Check the product page for compatibility before installing; refer to the App Store page for system requirements. If it says a system update is required, check your device's current version and then look for an available update.

Do I need to buy Shadowrocket again after getting a new iPhone or reinstalling it?

Usually not. Sign in to Media & Purchases with the account used for the purchase, open Purchased from your App Store account page, search for Shadowrocket, then tap the cloud download icon. If the product page shows a price, check the purchase account and transaction history before considering another purchase. Restoring the app restores your entitlement; back up locally stored subscriptions, servers, and configurations before switching devices rather than assuming they will return after reinstalling.

How much does Shadowrocket cost on each platform?

The iPhone/iPad version is a one-time purchase on the App Store, listed at $2.99 in the US storefront; the price at checkout depends on the current storefront. The Mac, Windows, Android, and Linux versions are free, with installers available from this site at /dl/. Buying the app once does not include a service plan. Get subscription details from your provider; this official guide covers installing and using the client.

Install and launch on each platform

Check your operating system and device architecture first, then distinguish permission warnings from compatibility issues.

Is Shadowrocket available for computers and Android devices?

Yes. The Mac versions (Apple silicon and Intel), Windows, Android, and Linux versions are free. The iPhone/iPad version is a one-time $2.99 App Store purchase in the US storefront; check your current storefront for the price that applies. For desktop and Android, visit the download guide, choose the installer under /dl/ for your operating system and device architecture, and follow the installation instructions. Get updates for your device from the same page.

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

Open About This Mac from the Apple menu. If it shows Chip and lists an Apple M-series chip, choose Mac Apple Silicon. If it shows Processor and lists Intel, choose Mac Intel. Don't infer the architecture from the device name or purchase year; models in the same product line can use different architectures. If you chose the wrong version, return to the Mac download card and select the other one. Don't change security settings to resolve an architecture mismatch.

Windows or Mac warns that the app may be risky. How can I tell whether it's safe to proceed?

First confirm that you just downloaded the installer for the correct operating system and architecture from this site's /dl/ page. The installer is not code-signed, so you may see a publisher warning the first time you launch it. On Windows, if SmartScreen only reports an unknown publisher, select More info; after confirming the source, continue with Run anyway if Windows offers that option. On macOS, if the only warning is that the developer cannot be verified, try opening the app once, then go to System Settings → Privacy & Security and look for Open Anyway for that app. If you see a malware or damaged-file warning, or your organization blocks the app, stop and investigate. Do not disable system protections.

Android says installation from this source isn't allowed. What should I do?

First confirm the installer came from this site's /dl/ page and that your device supports the architecture listed on the download page. If Android only says the current app isn't allowed to install apps, use the prompt to open Install unknown apps and allow only the browser or file manager you used to open this installer. You can revoke this permission after installation. If Android reports incompatibility or a security risk, stop and check the system warning; allowing installs from a source won't fix compatibility issues.

Import subscriptions and servers

Use an existing subscription or server details; don't share URLs or authentication fields when troubleshooting.

Subscribe import failed. What should I check?

First check whether you have a subscription URL or details for a single server. Get subscription URLs from your provider. In Add Server, choose Subscribe and paste the full URL. Check for extra spaces or line breaks at either end, and don't remove query parameters. If the request times out, make sure the device is online and try again on a network you know works. For access or expiration issues, ask your provider to check the URL. Don't include the full URL when reporting a problem.

Why is the subscription group there, but its server list is empty?

The subscription group appearing means its entry was saved, not that the server list downloaded successfully. In Home, update the group, wait for the operation to finish, then expand it and check whether any SERVER entries appear. If parsing fails, make sure you entered the subscription URL from your provider, not an account sign-in page. If there's no error but the list stays empty, note the message and time, then ask your provider what format and content the URL returns.

How do I update an existing subscription without disrupting my configuration?

In Home, find the existing subscription group and update it from that group's action menu; there's no need to keep adding new Subscribe entries. Note the SERVER you're using before updating. If it disappears afterward, select it again from the refreshed list and test the connection. If a policy group in Config refers to the old server name, check that the reference is still valid. If your provider changed the URL, edit the subscription entry before updating.

Should I use Subscribe if I only have one server?

No. In Add Server, choose the protocol that matches the details you have, such as Shadowsocks, VLESS, or Hysteria2. Enter the address, port, and any authentication or transport fields required by that protocol. Don't copy fields from one protocol to another. Save the entry, return to Home, select it, and test the connection. If you have a QR code for a single server, use Scan QR Code to import it and verify the protocol and address before saving.

Rules & Routing troubleshooting

Compare using the same network and URL, changing only one setting at a time.

The connection switch in Home won't turn on. What should I check first?

In Home, make sure there's a SERVER to select and choose the one you want to test. The first time you connect on iPhone or iPad, iOS may ask to add a VPN configuration. Allow it in the system prompt after confirming it was triggered by your action. If the switch turns off immediately, note the system message and check whether another VPN is running or the device is restricted by a management policy. Contact your administrator about managed devices; don't remove their management configuration.

Shadowrocket says it's connected, but I still can't access the internet. Why?

Disconnect, then use the same network to open a website you know is reachable and confirm the underlying connection works. If it works while disconnected, check that the right SERVER is selected and run Connectivity Test. A successful test only means its target is reachable; it doesn't guarantee access to every site. If only some sites fail, temporarily switch Global Routing and test the same URL: if Proxy works but Config doesn't, check the rule order and policy groups first. Restore your original settings when you're done.

Which Global Routing mode should I choose: Config, Proxy, or Direct?

Config routes traffic according to the rules in your current configuration, making it suitable for handling different destinations in different ways. Proxy sends traffic covered by the connection through the selected proxy and can help you compare rule behavior. Direct bypasses the selected proxy and can help distinguish proxy-path issues from problems with your underlying network. In Config, first confirm the expected configuration is enabled, then trace the applicable rules through to FINAL to see how unmatched traffic is handled.

The interface is in English. Where can I find the steps in the Getting Started guide?

Look for the names shown in the app; you don't need to change your system language first. Home is where you view SERVER entries, toggle the connection, and check Global Routing. Add Server is for entering existing server details; choose Subscribe there to add a subscription URL. Config lets you view and select configurations, and Settings contains app preferences. When reporting a problem, note the exact English message and the steps that triggered it, rather than describing a button only by its position or color.

On Demand increases battery use. How can I troubleshoot it?

On your iPhone or iPad, compare background activity for similar periods on the system Battery page; don't draw conclusions from a single instance of battery drain. Note your current On Demand settings, pause automatic connections, and compare usage on the same network and over similar periods. If the difference is noticeable only when frequently switching between Wi-Fi and cellular, check for repeated reconnects first. Adjust the relevant condition only if you don't need automatic connections on that type of network. Change one setting at a time so you can identify the cause.