Shadowrocket Official Guide · Official Manual

Shadowrocket FAQ & Troubleshooting

First identify whether the issue is about getting the app, configuring it, or connecting. Then troubleshoot based on what you see. These FAQs cover iPhone, iPad, Mac, Windows, Android, and Linux. Follow the device-specific instructions in each answer when provided.

Select a question to expand its answer. Before troubleshooting, note your current SERVER, Config, and Global Routing settings. Change one thing at a time.

App Store

Verify and purchase

Start by identifying your device and where to get the app. Your account region affects App Store availability; manage purchase history and configuration backups separately.

Can I use Shadowrocket on a computer or Android? How much does it cost?

Yes. The iPhone and iPad version 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 installers for other platforms from this site's download page; files are hosted under /dl/shadowrocket/. Shadowrocket is closed-source commercial software for handling connections and rules. A one-time app purchase does not include a service plan. You’ll need your own subscription or server details to use it. This site does not provide, sell, or recommend servers or subscriptions.

Can I install Shadowrocket on an iPad? Do I need to buy it separately for iPhone and iPad?

Yes, Shadowrocket works on iPad. The iPhone and iPad version costs $2.99 as a one-time App Store purchase and works on both devices. The Mac, Windows, Android, and Linux versions are free. Sign in to Media & Purchases with the Apple Account used for the purchase, then find Shadowrocket in your purchased apps on another compatible device. Check the App Store product page for system requirements. Getting the app and transferring your configuration are separate steps: after installation, import your own configuration and confirm the required system connection permissions.

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

Check Settings → Apple Account → Media & Purchases → View Account → Country/Region. Your device’s language and region settings don’t determine which App Store storefront you’re using. Shadowrocket is currently unavailable in the mainland China App Store. Use the download guide to open the product page and check availability in your current storefront. If you need to change your account’s country or region, go to Country/Region → Change Country or Region and review the requirements first. Resolve any account balance, active subscriptions, or payment method issues before making a change. Don’t switch regions repeatedly just to run a search. If the page says your device is incompatible, check the system requirements listed on the App Store page.

How can I verify that a Shadowrocket listing in the App Store is genuine?

Check three details on the product page: the name is Shadowrocket, the developer is Shadow Launch Technology Limited, and the app ID in the product link is 932747118. The icon should match the official icon in this site's header. Don’t rely only on a nickname or search ranking. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. The final price is the one shown in your storefront. Get the desktop and Android versions from this site's download page; installers are hosted at /dl/shadowrocket/.

Do I have to pay again after changing devices or reinstalling? Will my configuration come back too?

On iPhone or iPad, sign in with the Apple Account used for the purchase. In your App Store account, open Apps or Purchased, find Shadowrocket, and download it again. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. To reinstall on a computer or Android device, download the app again from this site's download page. If the store still shows a purchase button, check the account used for Media & Purchases and your purchase history. Redownloading the app does not restore your configuration. Back up your own configuration before changing devices, and keep your subscription URL somewhere safe.

Need help checking the store listing and purchase history? Read the genuine app guide.

Settings

Download, install, and open

Installer format, system security prompts, and VPN authorization are separate steps. Confirm the file source and device architecture first, then address the relevant prompt.

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

Open the Apple menu in the top-left corner of your screen and choose About This Mac. If it shows Chip and an Apple chip name, download the Mac Apple Silicon version. If it shows Processor and Intel, download the Mac Intel version. Both are DMG installers. If macOS blocks the app the first time you open it, confirm it came from this site's download page, then go to System Settings → Privacy & Security, find the relevant warning, and choose Open Anyway. Don’t switch between versions to get around a security prompt; check the processor architecture and the macOS permission separately.

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

First, make sure the installer came from this site's download page, is hosted under /dl/shadowrocket/, and has finished downloading. If Windows SmartScreen appears, confirm the source, then choose More info → Run anyway. If your organization’s policy blocks the app, contact your device administrator. If Mac says it can’t verify the developer, go to System Settings → Privacy & Security and choose Open Anyway. If the app is reported as damaged, make sure it’s in Applications, then run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening it again. Only do this for an app whose source you’ve verified. Don’t disable system-wide security protections.

What permissions and file formats should I check when installing on Android or Linux?

The Android download page provides an arm64 installer. Check your device architecture first. When prompted, allow your current browser or file manager to install unknown apps; you can turn this permission off after installation. On Linux, choose deb, rpm, or AppImage based on your distribution, not just the file size. For an AppImage, allow execution in the file’s properties, or run chmod +x on the downloaded file before launching it. If your device is managed by an organization, the architecture doesn’t match, or a policy still blocks installation, check the environment before trying again.

What if the connection switch won’t turn on or switches off right away?

Check that a working SERVER entry is selected and that the subscription actually imported servers. The first time you connect on iPhone or iPad, allow the system to add a VPN configuration. If you canceled the prompt, turn the switch on again and watch for the system dialog. Next, check whether Screen Time or device management policies restrict VPN configurations in system settings. Pause any other VPN connection that is controlling network traffic. Note whether the switch turns off before or after authorization, then check the client logs. Don’t delete all your configurations first; they may contain useful clues.

The app is in English. How do I find the settings described in the guide?

The guide keeps interface labels in English so you can match them directly. Home is where you check servers and connection status; Add Server adds server details; Config lets you view and select configurations; Settings contains app preferences; and Global Routing controls how connections are handled. The layout may vary slightly by device or app version, so look for the feature name rather than matching a screenshot pixel for pixel. Note the current screen and selected items before making changes. If you can’t find an option, read the relevant steps and keep system VPN settings separate from in-app settings.

What should I do before updating the app or operating system?

Note the selected SERVER, Config, and Global Routing settings, and back up any configurations you’ve edited. Update on iPhone or iPad through the App Store. For Mac, Windows, Android, and Linux, get the installer for your platform from this site's download page. If an update is blocked by the desktop or Android system, verify its source and follow the system security instructions on this page. Updating the app does not update your subscription or fix invalid server details. After updating, test your existing configuration before changing settings, and adjust one thing at a time.

See the full steps for your device: installation and system security guidance.

Subscribe

Import subscriptions and servers

The steps below assume you already have a subscription or server details. Subscriptions manage the server list; Config controls rules and related settings. Check them separately.

A subscription won’t import. What should I check, and in what order?

First, make sure you copied the full subscription URL you already have—not an account dashboard or help page. Check for leading or trailing spaces, line breaks, and truncated parameters. Confirm your local network can reach the URL, and check whether it returns configuration data, a sign-in page, or an error. In Home, open the add option, choose Subscribe, and paste the URL. If it still fails, note the exact error and when it occurred, then ask your service provider to check the link and output format. A subscription URL may contain credentials; don’t post the full link publicly or share an unredacted screenshot while troubleshooting.

How do I add a server if I have the details but no subscription URL?

Use server details you already have. In Home, open Add Server and select the protocol that matches your information, then enter the server address, port, and authentication details. Protocols such as Shadowsocks, VMess, VLESS, and Trojan use different fields; matching only the address and port doesn’t make two configurations equivalent. Enter TLS, SNI, and transport settings as specified in your original details. Save the entry, select it, and test the connection. Don’t disable certificate checks just to make a test pass. If required information is missing, ask your service provider rather than guessing.

How do I update a subscription? Will it keep changes I made manually?

In Home, find the relevant Subscribe group, open its action menu, and update it. Then check whether the server list changed and whether the selected entry is still there. Updating a subscription fetches its remote contents again, so manual changes in the group may be overwritten. Back up any custom entries you need to keep and distinguish them from subscription-managed entries. If the update fails, keep the existing entries and check the subscription URL and network first. Updating the server list is different from updating rule files in Config. If routing behaves unexpectedly, also check whether the active configuration was switched or updated.

What should I do if imports create duplicate entries or old servers remain in the list?

Check which Subscribe group each duplicate belongs to. Distinguish a subscription imported more than once from manually added entries and servers with the same name in different subscriptions. Matching names don’t necessarily mean the address and protocol are the same. Compare the details and note which entry is currently in use before deleting anything. If the same subscription was imported twice, keep the group you’ve confirmed can update and remove the other one. Don’t clear every server at once. Check that your backup and subscription URL are still available, then clean up one group at a time to avoid deleting a manual configuration stored only on your device.

New to this? Start with the subscription import and connection steps.

DOMAIN-SUFFIX

Routing and troubleshooting

Turning on the connection means the client has started handling connections. Access to a destination also depends on the server, rules, DNS, and local network.

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

Config follows the rules in the active configuration to decide how connections are handled. Proxy sends connections the client can handle through the selected proxy. Direct connects those destinations directly. For everyday rule-based routing, choose Config and make sure the intended file is selected in Config. To troubleshoot, compare Proxy and Config on the same network and destination: if Proxy works but Config doesn’t, check the rules and DNS first. A mode controls how connections are handled; it can’t restore a server that’s no longer working. Don’t treat switching modes as the only fix.

The connection is on, but websites won’t load. What should I check first?

Turn the connection off and check that your local network can still reach websites that normally connect directly. Turn it back on and verify the selected SERVER. Connectivity Test checks only some aspects of connectivity; a successful result doesn’t confirm that a website’s DNS, TLS, and transport path are all working. Compare different websites and local networks, then check the rules and outbound route used by failed connections. If every destination fails, check the server and local network first. If only some domains fail, check the rules, DNS, and destination service. Change one setting at a time and keep a record of the original settings.

Connectivity Test passes. Why could DNS still be the problem?

Connectivity Test and browser traffic may use different resolution and connection paths, so one successful test can’t rule out a DNS problem. Note the full domain name that won’t load, then look for resolution failures or timeouts in connection records or logs. Check whether a remote configuration has overridden the DNS settings in your active Config. Compare Wi-Fi and Cellular, and distinguish a DNS lookup failure from a connection failure after resolution. Don’t change several DNS addresses and rule files at once. Back up your settings first, then test changes so you can identify which one made a difference.

Battery use seems higher after connecting. What should I check?

Check your system’s battery usage for the same time period, and note screen time, downloads, video playback, and local signal strength. Traffic handled while the proxy is running may be attributed to the client, so usage share alone doesn’t prove there’s a problem. Check whether you’re repeatedly testing the full server list, subscriptions are updating over and over, detailed logging is left on, or connections are failing and retrying continuously. Cut unnecessary tests and observe battery use for a while under similar network conditions. Don’t turn off essential connection features just to lower the displayed percentage; first find what’s causing sustained activity.

Why does it reconnect after I turn it off manually? Could On Demand be responsible?

It could be. On Demand can trigger connections based on network conditions. Check whether it’s enabled and whether conditions such as Wi-Fi or Cellular match your current environment. To distinguish an automatic trigger from a connection issue, note the original settings, temporarily pause On Demand, and see whether the manual switch stays in the expected state. Also check the system VPN page for other automatic connection configurations. Once you find the cause, change only the relevant condition. Don’t delete all network configurations. Menu locations may vary by device; follow the options shown in your current version.

Need to understand how matching rules relate to outbound routes? Read the proxy mode guide or see how to troubleshoot DNS resolution failures.