Official manual · Find troubleshooting steps by issue

Shadowrocket FAQPurchase, setup & connection troubleshooting

First identify whether you’re getting the app, importing existing details, or establishing a connection, then find the relevant answer. The connection steps below use the iPhone and iPad interface; desktop and Android versions and system permissions are covered separately.

  • 01Verify and purchase
  • 02Download, install & open for the first time
  • 03Import subscriptions and servers
  • 04Routing rules & troubleshooting
01 · Before you get the app

Verify and purchase

First check the product listing, storefront region, and purchase history. Your account’s purchase history is for getting the app; service-provider details are for connecting. They’re managed separately.

How much does Shadowrocket cost, and does the app purchase include proxy service?

The iPhone and iPad version costs $2.99 as a one-time App Store purchase. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. The store shows the local currency and final price for your storefront. Buying the app once does not include a proxy service plan; you’ll need your own subscription or server details to use it. This is the Shadowrocket official site and manual; it does not provide, sell, or recommend servers or subscriptions. Your app purchase record is for obtaining the app and cannot pay for or restore service-provider data allowances or expiration dates.

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

Open the App Store product link from this site’s download guide and check the name Shadowrocket, official icon, developer Shadow Launch Technology Limited, and app ID 932747118 in the product URL. The icon should match the official icon in this site’s header. Don’t rely only on a nickname or search result 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. Don’t mistake a differently named app listed as free in the store for this product. For iPhone and iPad system requirements, see the App Store product page.

What should I check if Shadowrocket doesn’t appear in App Store search?

Open the product page directly from the download guide to see whether it’s missing from search results or unavailable in your current storefront. The China mainland App Store does not currently offer this listing. Your device’s language and physical location don’t determine your Apple Account storefront region. In Settings, open your Apple Account, then check Media & Purchases, View Account, and Country/Region. If you need to change the region, follow Apple’s instructions on that page for balance, subscriptions, and payment methods. Avoid repeatedly switching regions just to troubleshoot search.

Can I install Shadowrocket on iPad, and do I have to pay again on a new iPhone or when reinstalling?

Get Shadowrocket for iPad from the same App Store product page. For system requirements, see the App Store page. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. Sign in with the Apple Account used for the original purchase, find Shadowrocket in your App Store purchase history or Apps list, and download it again. The list name may vary by system version. If a price still appears, check which account is signed in to Media & Purchases and review your purchase history before proceeding. Redownloading the app won’t restore local settings, so back them up separately before switching devices.

The store says my device is incompatible. Can I rely on the system version listed in a tutorial?

Don’t use a fixed system-version requirement from an older tutorial instead of the current product page. For iPhone and iPad requirements, check Compatibility on the App Store page and compare it with the system information in Settings. If an update is available, back up your device and update as prompted, then check the product page again. If your device doesn’t meet the requirements, keep your existing data and don’t delete an app that still works. Purchase history, storefront region, and device compatibility are separate conditions; check each one.

02 · For your device

Download, install & open for the first time

Confirm the package type and source before responding to system prompts. Security warnings, architecture mismatches, and organization restrictions require different solutions.

Can I use Shadowrocket on a computer or Android, and where can I get it?

Yes. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Open this site’s download guide and choose the button for your system. Desktop and Android installers are available only through this site’s /dl/shadowrocket/ path. If a download is blocked, follow the relevant steps: choose More info and Run anyway in Windows SmartScreen, check Privacy & Security on Mac, temporarily allow the browser performing the installation to install unknown apps on Android, or set permissions for the selected package format on Linux. Before allowing anything, confirm the file came from this site and matches your device.

Should I choose the Apple silicon or Intel version of Shadowrocket for Mac?

Open About This Mac from the Apple menu. If it shows Chip and lists an Apple chip, choose Mac Apple Silicon; if it shows Processor and identifies Intel, choose Mac Intel. Don’t decide based only on the computer’s appearance or purchase year. The download guide has two matching DMG buttons; choose the one for your Mac. Open the DMG, drag Shadowrocket to Applications, then launch it from Applications. If macOS says it can’t verify the developer, confirm the source, then choose Open Anyway under Privacy & Security in Settings. Don’t repeatedly launch the app from the disk image.

Windows SmartScreen warns that Shadowrocket may be unsafe. What should I check before continuing?

First confirm that you got the file from this site’s download guide, that its address is under /dl/shadowrocket/, and that you selected the Windows installer. Once you’ve confirmed the source, choose More info in the Windows SmartScreen dialog, then Run anyway, and follow the installer. If your organization’s policy hides the button or Windows explicitly blocks execution, don’t disable system-wide protection; contact your device administrator. If security software quarantined the file, check the specific detection reason rather than treating every block as the same warning. The first connection after installation may also require network permission from Windows.

Mac says the developer can’t be verified or the app is damaged. How do I handle each message?

Confirm the installer came from this site and that you moved Shadowrocket to /Applications. If macOS says it can’t verify the developer, try opening the app once, then go to Privacy & Security in Settings, find the relevant blocked app entry, and choose Open Anyway. If macOS explicitly says the app is damaged, download the installer for the correct chip again. After confirming the source, you can run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening the app again. This command clears extended attributes from that app directory. Use it only on an app whose source you’ve verified; don’t run it on the entire disk or disable system-wide security.

Shadowrocket won’t open after downloading on Android, or the Linux AppImage won’t run. What should I do?

On Android, get the matching apk from this site’s download guide. If a download doesn’t start inside WeChat, open the same download page in your system browser. When asked for installation permission, allow only the browser or file manager actually performing the installation to install unknown apps, then revoke the permission afterward if you like. Follow your organization’s policy on managed devices. For Linux AppImage, allow execution as a program in the file properties, or run chmod +x on the actual file in your downloads folder before launching it. Install deb and rpm packages with your distribution’s package manager. If the architecture doesn’t match, download the right package; don’t try to fix it by changing the file extension.

03 · Use your existing details

Import subscriptions and servers

The steps below assume you already have your own subscription or server details. First make sure they appear correctly in the list, then troubleshoot connection and access issues.

A subscription won’t import in Subscribe. What should I check first?

Make sure you pasted the subscription URL provided by your service provider, not an account sign-in or information page. Check that copying didn’t add spaces, line breaks, or punctuation. Go to Add Server, choose Subscribe, save, then try an update on a working network. If parsing fails, check that the URL is valid, that the subscription format is supported, and whether your provider needs to generate a new link. Don’t keep adding the same URL to try to fix it. Save the exact error message, and share only necessary information with the original provider. Don’t disclose a complete link that contains credentials.

The subscription saved, but the server list is empty. Is the connection toggle the problem?

An empty list points to a subscription fetch or parsing issue, so check that before the connection toggle. Update the Subscribe entry you just added, then check whether a group is collapsed or a filter is hiding entries. If the list is still empty, check the subscription’s expiration date, account status, and returned content with your provider. A sign-in prompt or error in the response can appear even when saving succeeded. Try updating once on another working network for comparison. Troubleshoot connection and routing only after a server appears in the list and is selected.

How do I update a subscription, and will an update change entries I edited manually?

In Home, find the relevant Subscribe entry and run its update from the entry’s action menu. When it finishes, check the server count, names, and selected entry. An update reloads the content published by the provider, so manual edits to subscription-generated servers may be overwritten next time. Don’t rely on those edits as a long-term backup. Manage any manual servers you need to keep separately and note their purpose. Updating servers is different from updating a Config. After a server change, check that the names referenced by your rules still exist so traffic isn’t sent somewhere unexpected.

I only have server details or a QR code. Which option should I use?

If you have details for a single server, go to Add Server, select the protocol that matches those details, and enter the address, port, authentication information, and any other fields required by your provider. If you have a QR code for a configuration, use Scan QR Code and grant camera access when prompted the first time. After importing, check the protocol, port, and authentication fields; matching names alone don’t confirm that the settings are correct. Shadowsocks, VMess, VLESS, Trojan, and other protocols use different parameters. Ask the original provider about missing fields instead of guessing. Save and select the entry before testing the connection.

Can I send screenshots and configuration files to someone while troubleshooting a subscription?

Check for subscription URLs, passwords, authentication fields, QR codes, and complete server details before deciding what to share. Subscription links often contain credentials that grant access to personal resources, and QR codes can contain the same information. Hiding only the account name isn’t enough. Keep only the error message, the step you were on, and the checks you’ve already tried; fully redact sensitive fields before contacting the original provider. Review Config exports and logs too. If you’ve exposed a complete link, reset it with the original provider and update the saved link on your device. Deleting a chat doesn’t invalidate an old link.

04 · Change one thing at a time

Routing rules & troubleshooting

Check the local network first, then the selected server, and finally the mode and rules. Keeping the exact error and test conditions is more useful than repeatedly retrying.

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

For everyday rule-based routing, choose Config. The rules in the current Config determine whether requests use PROXY, DIRECT, or REJECT. Proxy sends requests covered by the app through a proxy; use it briefly to check whether rules are affecting the result. It won’t fix server authentication errors. Direct sends requests over your local network and can serve as a baseline comparison. During troubleshooting, change only this setting and repeat the same test, note the difference, then restore your usual setting. If Config and Proxy behave differently, check rule order, match targets, and the final rule first.

The connection toggle in Home won’t turn on, or turns off immediately. What should I do?

Confirm that Home has a valid server selected, then try the connection toggle again. Watch for a system prompt to authorize adding a VPN configuration; connection won’t work if you cancel it. In Settings, check for a pending VPN permission, device-management restrictions, or another active VPN connection. Stop any conflicting connection and try again. If the toggle still turns off immediately, note the exact error and check the selected server’s protocol and authentication details. Don’t rapidly toggle the connection on and off. On a managed device, ask the administrator to allow the required permission; don’t remove management settings to bypass restrictions.

Shadowrocket shows connected, but web pages won’t load. What order should I troubleshoot in?

A connected status means the local connection process is established; it doesn’t guarantee that the remote server or every destination is available. Disconnect temporarily and confirm that your local Wi-Fi or cellular network can reach pages that normally work. Reconnect, then check the selected server, your subscription’s validity with the provider, and authentication details. Use Connectivity Test as an aid, but one successful test doesn’t prove that all traffic works. Next, compare Config and Proxy and check DNS, rule matches, and REJECT entries. Change one thing at a time. If every server fails, start with conditions shared by all of them: the network, subscription, and configuration.

The app interface is in English. How do I match the labels in a tutorial?

This manual keeps interface labels in English; explanations describe what they do without renaming buttons. Home shows servers and connection status. Add Server adds server details. Subscribe is for an existing subscription. Config is for configuration files. Settings contains app settings. Data shows traffic records. Find the English label first, then read the explanation beside it. Menu locations can vary by system or app version, so don’t rely only on screenshot coordinates. In Global Routing, the three modes are Config, Proxy, and Direct; PROXY, DIRECT, and REJECT are rule keywords.

A persistent connection uses a lot of battery. What should I check in On Demand?

Check battery usage over time in your system’s battery settings, considering usage duration, data transfer, signal quality, and background activity rather than relying on one percentage reading. Weak signals, repeated connection retries, frequent tests, and sustained high-volume transfers can all increase battery use. Check whether On Demand has overly broad triggers that reconnect immediately after disconnection. Temporarily turn it off while troubleshooting and see whether a manual connection stays stable. Run Connectivity Test less often and check for repeated failed requests. Record the original settings before changing anything. Don’t change rules, DNS, and subscriptions all at once, or you won’t know what made a difference.