Official Manual Browse by issue

Shadowrocket FAQ

First distinguish app access and installation, subscriptions and servers, and connections and routing rules. Then follow the steps for the relevant issue. Change one setting at a time and keep the error message so you can tell what changed.

The steps below assume you already have your own subscription or server details. Get subscription links from your provider. This is the Shadowrocket official website and manual; it does not provide, sell, or recommend servers or subscriptions.

Select a question to expand its answer. For step-by-step instructions, see the user guide. To get the app for your device, visit Downloads for all platforms.

Authenticity Checks and Purchases

Can you use Shadowrocket on a computer or Android? How do you get it on each platform?

Yes. The iPhone and iPad app 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 desktop and Android installers from the all-platform download page; the actual download paths are under /dl/shadowrocket/. Check the App Store listing for iPhone and iPad system requirements. Buying the app does not include a proxy service. You’ll need your own subscription or server details; get subscription links from your provider.

How can you verify the genuine Shadowrocket listing on the App Store?

On the product page, check the name Shadowrocket, the developer Shadow Launch Technology Limited, and app ID 932747118. Compare the icon with the official icon shown on this site. You can identify the app ID from the product page’s share link, which includes id932747118; don’t rely on a translated nickname in search results. If an entry with the same name has a different icon, developer, or ID, it isn’t the app covered here. Get the computer and Android versions from this site’s all-platform download page; App Store search results don’t apply to those installers.

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

First check the storefront region for the Apple ID used with the App Store, not your device language or current network location. The app isn’t available in the mainland China storefront. Open the product page from the download page to distinguish storefront availability from a failed search. To check your region, go to Settings, tap Media & Purchases under your Apple ID, then review Country/Region. If you change regions, follow Apple’s account process for your balance, active subscriptions, and payment details. Changing your device language won’t change the storefront, and repeatedly reinstalling the app won’t help.

Do you have to buy Shadowrocket again after getting a new iPhone or reinstalling the app?

In the App Store, first make sure you’re signed in with the Apple ID associated with the original purchase. Then find Shadowrocket in your account’s purchased apps and use the redownload option. Your device’s cloud account may differ from the account used for App Store purchases, so check the purchase history. If the product page still shows a purchase button, verify the account, storefront, and purchase history before paying again. Redownloading the app won’t restore your server list. Before switching devices, save your own configuration and subscription details separately, then check that sensitive fields are intact after restoring them.

Can Shadowrocket be installed on iPad? Are iPhone and iPad purchases shared?

Yes. If your iPhone and iPad use the same Apple ID, you can redownload Shadowrocket from the App Store’s purchased apps on the other device. Check the App Store listing for compatibility and system requirements. On iPad, landscape or split-screen layouts may show lists and details side by side, so controls may not be in the same place as on iPhone. Look for interface labels such as Home, Config, and Settings. A shared purchase history doesn’t sync configurations. After importing your own subscription, check the selected server, Global Routing, and connection permissions on each device.

See how to verify the app and restore a purchase →

Installation and First Launch by Platform

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

Open About This Mac and check whether it lists a Chip or a Processor. Choose the Apple silicon version for a Mac with an Apple chip, or the Intel version for a Mac with an Intel processor. Don’t guess based on the computer’s appearance or purchase date. Both installers are listed separately on the download page. After downloading, move Shadowrocket to Applications and open it. If macOS says it can’t verify the developer, first confirm that the file came from this site’s download page. Then go to System Settings → Privacy & Security, review the blocked app notice, select Open Anyway when prompted, and complete system authentication.

Windows or Mac warns that Shadowrocket may be unsafe or won’t open. What should you do?

First confirm the installer came from this site’s download page and that the warning identifies Shadowrocket. In the Windows SmartScreen warning, expand More info and, after confirming, choose Run anyway. If macOS can’t verify the developer, go to System Settings → Privacy & Security and choose Open Anyway. If an app downloaded from this site is reported as damaged, move it to Applications, then run xattr -cr /Applications/Shadowrocket.app in Terminal and reopen it. Don’t disable system-wide security protections. On a managed device, check with your administrator about the applicable policies.

What if Android blocks the installation or a Linux AppImage won’t run?

On Android, first confirm the file came from this site’s download page. In the system’s Allow from this source settings, grant install permission only to the browser or file manager you’re using for this installation; you can turn it off afterward. If the package doesn’t match your device architecture, check the arm64 details on the download page. On Linux, an AppImage needs execute permission. In the file properties, allow it to run as a program, then follow your distribution’s instructions for any runtime dependencies. Install deb and rpm packages with the package manager for your distribution; changing a file extension won’t convert the package. See the installation guidance on the download page for details.

What if the connection switch won’t turn on, or turns off immediately the first time you connect?

First make sure you’ve added and selected a server with complete parameters. Then check whether the system is waiting for VPN configuration approval or your device passcode. If you canceled authorization during the first connection attempt, start the connection again in the app and read the system prompt. If the switch immediately turns off, pause other connections using the system VPN, check device management policies, parental controls, and network permissions, then review the specific error in the app log. Don’t toggle the switch rapidly. Turn off the connection, change one setting, and try again to determine whether the issue is authorization or server configuration.

The interface is in English. Which controls should you learn first?

Identify interface labels by what they do: Home shows servers and connection status; Add Server adds a server; Subscribe adds your own subscription; Config manages configurations; and Settings opens app settings. Global Routing controls whether traffic follows Config, Proxy, or Direct; it isn’t where you add a server. Keep protocol names, rule keywords, and share-link fields unchanged. Don’t enter translated explanations in protocol fields. Layouts can vary by platform, so match controls by label and field meaning rather than relying only on their screen position.

See installation and security-prompt steps for each platform →

Subscription and Server Imports

Subscribe import failed. What should you check, and in what order?

First make sure you pasted the complete subscription link from your provider, not an account webpage URL, a single-server share link, or a QR code image URL. Check for spaces or line breaks at either end and make sure no query parameters are missing. Then confirm that your local network can reach the subscription address. If the response is a login page, verification page, or invalid format, the app can’t use it to create a server list. Ask your provider to confirm that the link is valid and uses a supported format. Don’t post the full link in public forums while troubleshooting: parameters such as tokens are often tied to account access. Hide sensitive details in screenshots, too.

How do you update a subscription? Can an update change the current server?

Find the existing Subscribe entry, check its URL and remark, then use that entry’s update action. Don’t create duplicate subscriptions just to update one. An update reloads the list provided by your provider, so server names, addresses, or available entries may change. After updating, confirm that your previously selected server is still listed before testing the connection. For scheduled updates, use the settings available in your current version and check the conditions for background updates. If an update fails, keep the existing list and error details instead of deleting them. Changes to subscription data depend on what your provider returns.

The subscription imported, but no servers appear—or the list suddenly got shorter. What should you check?

First check whether you’re viewing a different group, or whether search, filters, or a collapsed list are hiding entries. Then confirm that the subscription update finished successfully. A successful import means the app accepted the input; it doesn’t guarantee that the server returned a valid list containing servers. If the list is still empty, check whether your provider returned any entries, whether the subscription is active, and whether the link format is supported. Entries may also have been removed or renamed by the provider. Keep the original subscription record and remark, then compare the list before and after the update. Don’t hide the problem by importing the same subscription again, and don’t judge connection quality by the number of entries.

What’s the difference between entering details with Add Server and importing with Scan QR Code or the clipboard?

Use Add Server to enter complete server details field by field. Scan QR Code and clipboard import read an existing share link and reduce manual entry. Whichever method you use, check the protocol, host, port, authentication fields, and additional settings such as TLS and SNI—not just the address and password. If a QR code contains a subscription link, follow the Subscribe workflow rather than treating it as a single server. For example, set the Trojan SNI to the value provided by your provider; don’t change it to an arbitrary domain. The remark in a share link is usually just a label for identifying the entry.

How should you organize multiple subscriptions? What should you back up before deleting one or switching devices?

Give each Subscribe entry a remark that identifies its purpose, rather than relying on server names alone; different subscriptions may contain entries with the same name. Before deleting a subscription, check which servers belong to it so you don’t remove entries you still use. Before switching devices, save your own subscription links, manually entered server details, and any Config you maintain separately. These may not be restored with your purchase history. Backups may contain authentication details, so store them securely. After restoring, verify a few entries before switching to your usual configuration. Don’t import several old backups at once, as that can create duplicates.

See the subscription and server management guide →

Routing Rules and Troubleshooting

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

Config routes traffic according to the rules in the current configuration, making it suitable for everyday use once you’ve checked the rules. Proxy sends requests handled by the app through the selected proxy policy, which is useful for temporary comparisons. Direct sends app-handled requests directly, which can help test your local network. These modes don’t replace valid server settings or guarantee that every type of system traffic is covered. When troubleshooting, keep the server and test destination fixed and change only one mode at a time. If Proxy works but Config doesn’t, check rule order, policy names, and DNS settings.

Shadowrocket shows connected, but you can’t access the internet. What should you check first?

First disconnect the app and confirm that your Wi-Fi or mobile data works on its own. Then check that the selected server is still listed and its authentication details are complete. A system Connected status means the VPN tunnel is established; it doesn’t confirm that the remote server, DNS, or rules are working. Keep the test destination the same and compare Proxy with Config: if both fail, check the server and local network first; if only Config fails, check the matching rules and policies. For domain access issues, also review DNS settings and request logs. Don’t treat disabling TLS verification as a general fix.

Connectivity Test looks good, so why are downloads still slow?

Connectivity Test measures connectivity or response under a specific test method; it doesn’t measure sustained download throughput. Compare results on the same device, network, and destination. Rule out background downloads, weak Wi-Fi, and local bandwidth use, then compare performance at different times. Server load, network congestion, protocol settings, and the destination service can all affect speed. A single latency value doesn’t tell you which server is fastest. If changing networks makes a clear difference, investigate your local network first. If only one destination is slow, check its matched rules and service status before changing servers.

Why does On Demand connect automatically? What if it reconnects after you disconnect manually?

On Demand requests a connection based on configured networks and trigger conditions, so reconnecting after you disconnect manually doesn’t necessarily mean the switch is broken. Check the On Demand settings in the app and the system VPN settings to see whether automatic triggers are configured for the current network. To pause automatic connections, disable the relevant conditions before disconnecting. After changing them, switch networks once and observe whether another configuration triggers a connection. On Demand doesn’t fix subscription, authentication, or rule errors. If the basic connection fails, test a manual connection first, then restore automatic triggers one at a time.

Does keeping Shadowrocket connected use more battery? How can you spot unusual drain?

Battery use depends on actual traffic, network signal, reconnection frequency, protocol, and diagnostic settings—not simply how long the connection switch is on. Compare similar usage in your system’s battery statistics. Check for ongoing downloads, repeated reconnects under a weak signal, or detailed logs left on for long periods. After troubleshooting, restore your usual logging settings and avoid unnecessary repeat tests. Don’t change protocol settings required by your provider just to save battery. If unusual drain comes with frequent disconnects, check the local network and connection logs first, then adjust On Demand triggers if needed.

Keep context in issue reports; hide credentials

Include the device platform, network type, Global Routing mode, steps that led to the error, and the exact error message. Before sharing, hide subscription URLs, authentication fields, and QR codes. Don’t post your full configuration to demonstrate an issue.

See interface labels, protocols, and routing keywords →