Official Manual · FAQs by Topic

Shadowrocket FAQ

Answers on purchasing, importing, and connection troubleshooting. Identify where the issue occurs, then check each step in order.

Shadowrocket is available only on Apple platforms, and the App Store is the only place to buy and install it. This page covers app operation and troubleshooting for users who already have their own subscription or server details.

Select a question to expand its answer. For the full setup process, see the Quick Start Guide. To verify where to buy the app, see the App Store Purchase Guide.

Verify the App and Purchase

Check the product page and purchase history first, then review pricing, region, and purchase restoration.

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

Open the App Store product page from this site's verification page rather than relying on search results to determine whether the app is available. If the page says it isn't available in your region, check the country or region of the account used for Media & Purchases in the App Store. Your device language, physical location, and store region are separate settings. If you need to change the region, go to Settings and follow Account → Media & Purchases → View Account → Country/Region. First review Apple's information about your balance, subscriptions, and payment terms. Menu names may vary by system version; availability is determined by the current App Store page.

How can you confirm that the App Store listing is the genuine Shadowrocket app?

Check the developer name, Shadow Launch Technology Limited, the official app icon shown on this site, and the product page URL containing id932747118. The App ID is 932747118. Don't rely on the app name or search ranking alone; similar names and icons aren't proof. On the product page, review compatibility, price, and the purchase button to confirm the listing applies to your device. Shadowrocket is available only on Apple platforms, and the App Store is the only place to buy and install it. This site's verification page lists these three details for you to check before purchasing.

How much does Shadowrocket cost, and what does the one-time purchase include?

Shadowrocket is a paid app. The US storefront price is approximately $2.99 as a one-time purchase; the actual price, taxes, and local currency price in other storefronts are shown on the App Store page. Buying the app once does not include a service plan: your purchase grants access to the app, not server details or a subscription. Before configuring the app, you'll need your own subscription or server details. This site does not provide, sell, or recommend servers or subscriptions. App updates are available through the App Store. Check your subscription's term, data allowance, and account status separately; they can't be inferred from your app purchase history.

Do you need to buy Shadowrocket again when switching devices or reinstalling it?

On your new device, first make sure the App Store's Media & Purchases account is the one used for the original purchase. Then look for Shadowrocket in your account's purchased apps. If you see a redownload icon, follow the store prompts. If you see a price, check your purchase history, account, storefront region, and whether the app is hidden before paying again. Availability across devices, Family Sharing, and compatibility are subject to the App Store listing. Restoring the app doesn't restore its configuration. After reinstalling, check whether your existing configuration is still there and restore any settings you need from your own saved records.

Before you buy, check: How to Verify the App · Price and One-Time Purchase · Restore a Purchase

Install and First Launch

Keep app installation, system permissions, and server connection troubleshooting separate.

Can you install Shadowrocket on iPad? What should you check on iPad and iPhone?

Shadowrocket is primarily used on iPhone and iPad, and it's available for both from the same App Store product page. Before installing, check compatibility and system requirements for each device; refer to the App Store page for system requirements and purchase eligibility. If you've already bought the app, check your App Store account and purchase history first. Available space and screen layouts may differ between iPad and iPhone. Find controls by their interface labels, such as Home, Config, Data, and Settings, rather than expecting them in the same position on both devices. Check VPN permissions and local configurations on each device separately.

What should you do when a system prompt asks to add a VPN configuration on first connection?

After confirming the app is from the specified App Store product page, allow it to add a VPN configuration when prompted during your first connection, then complete any device authentication required. This permission lets the system route the relevant network traffic through the app; it doesn't validate server details or guarantee that all traffic will use Proxy. If you dismissed the prompt, try connecting again from the app and check the VPN configuration status in the relevant section of Settings. Managed devices may have additional restrictions; check with your device administrator. Don't remove other VPN configurations unless you know what they're for, as this could disrupt an existing work connection.

The interface is in English. Where are Home, Config, Data, and Settings?

Home is where you view existing server entries, choose a connection, and manage it. Config is for managing configuration files and rules. Data shows traffic and connection records. Settings contains app preferences. Global Routing is where you choose how traffic is handled; Config, Proxy, and Direct there refer to different handling modes, not the names of the bottom navigation tabs. This manual keeps interface labels in English so you can match them to the app without memorizing every menu. If you can't find a control, first check which screen you're on, then look for it by function. The layout may vary by app version.

The connection switch won't turn on, or turns off right away. What should you check first?

First determine whether the switch won't stay on or whether it stays on but you can't access anything. If it won't stay on, check that system VPN permission is granted, that the device has no management restrictions, and that the selected server entry and configuration are usable. Also make sure another VPN connection isn't taking over the network. Turn off the connection, reopen the app, select an existing entry with complete settings, and try again. If it still switches off immediately, note any system prompt or app error and check the configuration for unsupported fields or missing values. Don't start by repeatedly reinstalling the app; doing so may erase local configurations and troubleshooting clues.

By device: Get Shadowrocket on iPhone · Get Shadowrocket on iPad

Subscriptions and Server Imports

Check the source, import type, and update result, and keep a copy of your existing configuration.

A subscription import fails, or the server list is empty after an update. What should you check?

First make sure you copied the complete subscription URL without spaces, line breaks, or punctuation added in error, and check that it's a subscription URL rather than a webpage. Then confirm that your subscription is valid, that your current network can reach its URL, and that the response is in a format Shadowrocket can read. An empty list may mean the server returned no content, authentication has expired, or the format has changed; it doesn't necessarily mean the app was installed incorrectly. Note any import error and, if needed, ask the original provider to confirm the URL status and supported format. Keep existing working configurations while troubleshooting, and don't share the full subscription URL or its access credentials publicly.

Scan QR Code doesn't add anything. What should you do?

First allow camera access and make sure the entire QR code is in view, without glare, cropping, or excessive zoom. A QR code is just a way to encode information: it may contain a single server entry, a subscription URL, or simply a webpage. Successfully scanning it doesn't guarantee the contents can be imported directly. If the code is displayed on the same device, use the image recognition option available in the app, or copy the relevant link from your own original records and choose the appropriate import method. After importing, check the entry type and required fields in Home. QR code contents and screenshots may include passwords, so protect them like any other connection credentials.

How do you update an existing subscription? Should you keep retrying if automatic updates fail?

In Home, find the relevant subscription entry and use its update action. To update subscriptions when opening the app, look for the relevant option in Settings and follow the trigger conditions shown in the current interface. Manual updates let you check the result; automatic updates reduce repeated steps. Both require an accessible URL and a valid response from the server. If an update fails, check the error, your network, the subscription's status, and whether its URL has changed. Avoid sending repeated requests in quick succession, as the server may impose rate limits. Updating a server list usually doesn't update rule files in Config; check these separately.

Why aren't there any rules in Config after importing a subscription?

Server subscriptions and configuration files serve different purposes. A subscription typically provides connection entries; a configuration file contains traffic rules and related settings. The actual contents depend on what you imported. After importing a subscription, check the server list in Home. For rule-based routing, go to Config and check whether a suitable configuration exists, is selected, and references available policies. Multiple server names in the list don't mean routing rules are ready. Save a copy before replacing or editing a configuration, and check how FINAL is handled to avoid sending unknown traffic to an unexpected policy.

Read next: How to Add a Server by QR Code · Troubleshoot Subscription Import Errors · Updating Subscriptions

Routing and Troubleshooting

Compare against your original network and change one setting at a time.

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

Config handles traffic according to the rules in the current configuration, making it suitable for everyday use after you've checked the rules and policies. Proxy sends traffic handled by the app through the proxy policy; use it briefly to check whether a destination is reachable through the current connection. Direct connects traffic handled by the app directly, which can help you compare against your original network. None of these modes fixes an incorrect password, expired subscription, or unreachable server. Before troubleshooting, note the original setting, change one thing at a time, and restore your intended mode after testing. DNS, system routing, and configuration exceptions may still affect results, so the mode name alone can't tell you the actual path of every request.

Shadowrocket says connected, but you can't access the internet. What should you check, and in what order?

Connected usually means the system VPN tunnel is established; it doesn't mean the remote server or destination website is reachable. First disconnect and confirm that your original network can access ordinary websites. Then check the current server address, port, protocol, and authentication fields, and use Connectivity Test to gather clues about reachability. Next review Global Routing, the matching policy in the current Config, and DNS settings. Determine whether all websites fail or only certain domains. If needed, compare with another working connection you already have, changing one condition at a time. A test result isn't a substitute for checking actual access; a returned latency doesn't guarantee the request will succeed.

Only some websites fail. How can you tell whether rules or DNS are the cause?

Note the failing domain, time, network, and Global Routing mode. Then check available records in Data to see which policy handled the request. In Config mode, check the order of DOMAIN, DOMAIN-SUFFIX, IP-CIDR, and other rules, and where FINAL sends traffic when no earlier rule matches. If the domain won't resolve, check DNS settings and whether the resolver is reachable. If it resolves but the connection fails, check the route to the destination and the server. Save a copy of the configuration before making changes. Don't change DNS, rules, and server settings all at once, or you won't know which change helped. Remove personal credentials before sharing logs.

Does leaving Shadowrocket on drain the battery? How should you configure On Demand?

Battery use depends on traffic, signal strength, connection retries, protocol, and background activity—not simply how long the app is on. Check usage for the relevant period in the system's battery settings, then review activity in Data for continuous transfers or frequent retries. On Demand controls when a connection starts under specified conditions; it doesn't replace rules in Config. If you use it, review the network conditions available in your current settings and test the behavior when switching between Wi-Fi and cellular. For a useful battery comparison, keep usage duration, signal strength, and activity similar. There's no need to run speed tests continuously.

Related: Global Routing Modes · DNS Settings · Shadowsocks Settings Reference