Official Guide · FAQ Index

Shadowrocket FAQ

Find answers by stage: getting the app, installing it, importing details, and connecting. First identify your device and where the error occurs, then follow the relevant checks one at a time. Change only one setting at a time, and keep your original configuration so you can restore it.

Browse the questions below; they work without scripts. For the full setup walkthrough, see Getting Started. Find platform downloads on the all-platforms download page.

Verify the App & Purchases

Start by checking the platform, storefront region, and purchase history.

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

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. Choose your device on the all-platforms download page. iPhone and iPad users go to the App Store product page; downloads for other platforms are available from this site under /dl/shadowrocket/. Buying the app is not the same as buying a service plan. To connect, you still need your own subscription or server details.

Can I install Shadowrocket on iPad? How do I check the system requirements for iPhone and iPad?

Yes, Shadowrocket can be installed on iPad. The iPhone and iPad versions are covered by a single $2.99 one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Check the App Store page for the current iPhone and iPad system requirements and compatibility details before installing. On another compatible device using the same purchase account, look for Shadowrocket in your purchased apps. If a price appears, check the store account and purchase history before confirming another payment.

How can I verify Shadowrocket in the App Store?

Check the app name, Shadowrocket; the developer, Shadow Launch Technology Limited; the official icon; and the app ID, 932747118. Compare the icon with the official icon in this site's header, and verify the app ID in the product page URL. Don't rely on the search result name alone. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free; don't confuse App Store pricing with the download options for computers and Android.

Why can't I find Shadowrocket in the App Store?

Open the App Store product page linked here to tell a search miss from unavailability in your current storefront. The app isn't available in the mainland China storefront. The storefront depends on the purchasing account's settings, not the device's display language. In your system account settings, open Media & Purchases and check the account's Country/Region. If you need to change it, follow the region-change process on that page and review any balance, subscription, and payment method requirements first. You don't need to change regions just to troubleshoot.

Do I need to buy Shadowrocket again after changing devices or reinstalling it?

On iPhone or iPad, sign in with the original purchasing account, find Shadowrocket in the App Store account page or your purchased apps, then tap the cloud download button. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Restoring the app doesn't restore its data, so save your own configuration and connection details before moving devices. For a computer or Android reinstall, get the installer from this site's download page and make sure your backup is available before importing your data.

Can family members install Shadowrocket through Family Sharing?

Check the current Family Sharing details on the App Store product page, then confirm that Purchase Sharing is enabled for your family group and that members' account regions meet the store requirements. If eligible, family members can find the app in their family's purchase history; there's no need to share account passwords. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Sharing a purchase doesn't automatically share subscription links, configuration files, or server credentials in the app.

Install & Launch

Check the architecture and download source before handling system warnings.

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

On your Mac, open the Apple menu and choose About This Mac. If it shows Chip and an Apple chip name, choose the Apple silicon version. If it shows an Intel processor, choose the Intel version. Don't guess based on the computer's appearance, purchase year, or browser detection. Get either version from this site's download page. If macOS blocks the app after installation, first confirm the download source and architecture, then follow the macOS steps in this section. Save your existing configuration before switching architectures.

What should I do if Windows warns that Shadowrocket may be risky or SmartScreen blocks it?

First confirm that the installer came from this site's download page, that the download URL is under /dl/shadowrocket/, and that your device allows you to install apps. If SmartScreen appears, expand More info, verify the file you're about to run, then select Run anyway. This is not a reason to disable system protection entirely. If that option isn't available, or the device is managed by your organization, stop and contact your administrator. Don't override a warning for a file from an unknown source, with an unexpected filename, or explicitly detected as a threat.

How do I handle a Mac warning that the developer can't be verified or the app is damaged?

First confirm that the installer came from this site's download page and is for the right architecture. If macOS says the developer can't be verified, try opening the app once, then go to System Settings > Privacy & Security, find the blocked app, and select Open Anyway. If macOS says the app is damaged, download it again. After confirming the source, you can run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening the app again. This command removes extended attributes from the specified app; it can't repair actual damage. Make sure the path matches the app's installed location, and don't run the command on your entire disk.

What should I do if Android blocks installation or tapping the download link in WeChat does nothing?

Copy this site's download page URL and open it in your system browser, then download the Android installer. If Android asks for permission, go to Settings and allow the browser or file manager you actually use to open the installer to install unknown apps. You can turn off this permission after installation. Make sure the device architecture matches the download page instructions. If installation still fails, check available storage, whether the file downloaded completely, and any device management restrictions. Don't disable all security checks to bypass a clear threat warning.

Which Linux package should I choose: deb, rpm, or AppImage?

Choose the package format for your distribution: Debian and Ubuntu-based systems typically use deb, while Fedora and some others use rpm. If you're unsure, check your system documentation and the download page's requirements. For AppImage, grant execute permission to the downloaded file, then launch it from a terminal to see any errors. For deb or rpm, use your distribution's package installer where possible so it can handle dependencies. Resolve architecture mismatches or missing dependencies based on the specific error; don't repeatedly install different formats over one another.

The interface is in English. Which items should I look for first?

This guide keeps interface labels in English so you can match them directly. Home shows your existing connection profiles. Add Server adds a server. Subscribe handles subscription actions. Config is for configuration files. Global Routing sets the routing mode, and Settings contains other options. Menu locations may vary by platform and version, so look for the label. Start by importing your details, choosing a mode, and testing the connection. Then explore automatic connection options such as On Demand. You don't need to change your system language to follow this guide.

Import Subscriptions & Servers

The steps below assume you already have your own connection details.

What information do I need before importing for the first time?

Have your own subscription link or server details ready: address, port, protocol, authentication information, and any required TLS or SNI settings. A subscription link and a server share link are different, so choose the matching import method. To enter details manually, open Add Server and select a protocol first. The example address example.com is for illustrating the format only and cannot be used to connect. This site does not provide, sell, or recommend servers or subscriptions, and does not collect users' complete connection credentials.

Shadowrocket subscription import failed. What should I check, and in what order?

First check that the link is complete and doesn't contain extra spaces, line breaks, or punctuation added by a messaging app. Confirm it's a subscription URL intended for a client, not a login page. Then check that your current network can reach the URL and that the subscription is still valid. If it returns a webpage, an authentication prompt, or no content, ask the original provider to confirm the link status and supported format. Record only the error type while troubleshooting. Don't paste a full link containing access credentials into public screenshots, search boxes, or feedback.

Why can't I connect after Scan QR Code succeeds?

A successful scan only means the QR code was read; it doesn't mean the server details in it are valid. Check that the code contains server sharing details or supported subscription content, not an ordinary webpage URL. After importing, confirm that the protocol, address, port, and authentication fields are complete, then check the expiry and service status. If the camera can't read the code, improve the lighting or use a clearer original image. Don't upload a QR code containing connection credentials to a public decoding site.

How do I update an existing subscription, and why hasn't the list changed?

Find the existing subscription in Home and use its update action. Don't repeatedly add the same link as a new subscription. Keep a backup if needed before updating. Afterward, check for errors and make sure sorting or filters aren't hiding changes. A successful update may return the same content, so an unchanged list doesn't necessarily mean it failed. If you see an authentication or access error, first confirm that the original subscription URL is still valid. Repeatedly refreshing won't fix an expired link.

How can I organize duplicate entries from multiple subscriptions without deleting the wrong ones?

Add recognizable notes to subscriptions from different sources, then identify which entries came from subscriptions and which were added manually. If duplicates appear after an update, check whether the same subscription was imported more than once. Don't judge by server name alone: entries with the same name may use different addresses or protocols. Back up your data before removing an extra subscription source, and check that your selected entry is still there afterward. Where possible, manage subscription-generated lists through the original subscription to avoid a later update overwriting manual changes.

What's the difference between importing a subscription and importing a Config file?

Subscriptions are generally used to update a server list. Config files may include rules, DNS, and policy settings, so the two serve different purposes. Having a server list doesn't mean you've enabled a rule configuration that suits your needs. Before importing a Config, review it and back up your current configuration. Pay particular attention to rule order, policy targets, and DNS settings, then select Config under Global Routing to test it. Don't overwrite an active configuration with an unfamiliar one, or change several settings at once before troubleshooting.

Routing & Troubleshooting

Test the basic network first, then check the server, rules, and DNS.

What should I do if the connection switch won't turn on or turns off immediately?

The first time you connect, your system must allow Shadowrocket to add a VPN configuration. If you previously canceled, start the connection again and confirm the system prompt. Then check that a valid server is selected in Home and that another VPN or device management policy isn't occupying the connection. Disconnect conflicting connections and test Shadowrocket on its own. If the switch turns off immediately, note the system prompt and app error, and restart the device if needed. Don't delete all configurations without a backup or remove configurations managed by your organization.

Shadowrocket says connected, but I can't access the internet. What should I check first?

Disconnect and confirm that your Wi-Fi or cellular network can access common websites on its own. If the network requires a browser sign-in, complete that first. Reconnect and test several destinations to distinguish a single-site issue from a general failure. Temporarily switching Global Routing to Proxy can help determine whether rules are involved; restore your original mode after testing. If the problem persists, check that the server is valid, review authentication and DNS settings, and compare with another network. A VPN status of Connected only means the tunnel is established; it doesn't guarantee the remote service is available.

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

Config routes traffic according to the rules in the current configuration file, making it suitable for everyday use once you've checked the rules. Proxy sends traffic through the selected proxy and can be useful for short-term comparison and troubleshooting. Direct connects without routing through a proxy. Changing modes won't fix server authentication errors or replace valid connection details. For a useful test, keep the server and network unchanged, switch only one mode at a time, record the result for the same destination, then restore your intended setting.

Battery use increases while connected. How should I troubleshoot On Demand?

Check your system's battery usage details to distinguish foreground use, background connections, and network activity from other apps. Don't assume something is wrong based on a single percentage. Continuous downloads, frequent reconnections, detailed logs, and network switching can all increase power use. Temporarily turn off On Demand and maintain one stable connection manually; compare battery use under the same conditions, then set automatic connection rules to suit your needs. Change one thing at a time. When you're done, disable diagnostic logging you no longer need and check for repeated failed connection attempts.

Why does Connectivity Test pass when I still can't access websites?

Connectivity Test results reflect only the test method and destination used at that moment. They don't confirm that every website, protocol, or long-running connection is working. First check that the actual request uses the same server, then review the rule matched by the destination domain and its DNS resolution. If only some destinations fail, check their rules, the remote service, and the destination site. If all fail, investigate the network, authentication, and server status. Compare results on the same network and with the same test destination; a single latency reading doesn't prove the service is available.

How can I identify DNS issues and keep useful troubleshooting details?

If the error points to domain resolution, first check the DNS settings in the current Config, whether the network requires sign-in, and whether the problem occurs only on a particular network. Don't change DNS, servers, and rules all at once, or you won't know which change mattered. Note your device and OS, network type, Global Routing mode, steps to reproduce the issue, and a redacted error message. Compare these with the verification steps in Getting Started. Before sharing logs, remove subscription URLs, passwords, access credentials, and any QR codes containing them.