Official guide · FAQ

Shadowrocket FAQ

Follow the steps for getting, installing, importing and connecting. Check your device and existing details first, then adjust settings. Back up before deleting, reinstalling or clearing configurations.

  • Platform availability
  • Two ways to get the app
  • Troubleshoot by symptom

Genuine & Purchase

Check the app, account and acquisition method first. Keep the app purchase separate from the server details needed to connect.

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

Yes. Get the iPhone and iPad version from the App Store for a one-time payment of $2.99. The Mac (Apple silicon and Intel), Windows, Android and Linux versions are free. Choose your device on this site's download page; desktop and Android installers are provided at /dl/shadowrocket/. For Mac, choose the version that matches your chip. For Linux, choose the correct package format. Do not use installers intended for another operating system. The download page also lists the steps to allow the first installation on each platform.

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

Check all three details: the app name is Shadowrocket, the developer is Shadow Launch Technology Limited, and the product page's app ID is 932747118. Then compare its icon with the official icon in this site's header. A similar name or a prominent search result is not enough to verify the app. 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 store displays the price in your local currency. Check the App Store page for system requirements.

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

First, make sure you're in the App Store and check the country or region of the Apple ID used for Media & Purchases; changing your device language alone won't help. The app isn't available in the mainland China storefront. Use the product page link below to check availability in your current storefront. To change your region, go to Media & Purchases in your Apple ID settings and review the account's Country/Region. Follow Apple's process for any remaining balance, active subscriptions and payment details. Changing the region setting alone doesn't guarantee that the account meets the requirements immediately.

Do I need to buy Shadowrocket again after changing or restoring my iPhone or iPad?

Using the same purchasing account, find Shadowrocket in your App Store purchase history and download it again. You can use the same account's purchase on both iPhone and iPad. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. If the store still shows a purchase button, check the account signed in under Media & Purchases and review your purchase history before paying again. Restoring the app doesn't restore its configuration. Back up and import configurations and subscriptions from your old device separately.

Why do I still need my own subscription or server details after buying the app?

A one-time app purchase is not a service plan. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. These options cover the app itself, not a server you can connect to. Shadowrocket uses the details you provide to connect and apply rules. Get a subscription link from your service provider, or use server details you manage yourself. This site is the official website and guide; it does not provide proxy servers. Before importing, make sure your details are valid and keep your credentials secure.

Download, install & first launch

Choose the version that matches your system and chip, then handle permissions for the specific file. Follow your administrator's policy on managed devices.

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

Open the Apple menu in the top-left corner of your Mac screen 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 Mac's appearance or purchase year. The download page provides the corresponding DMG for both versions. After opening the installer, move the app to Applications and follow the first-launch prompts. If macOS says it can't verify the developer, confirm the file came from this site, then go to System Settings → Privacy & Security and select Open Anyway.

How should I handle a Windows SmartScreen warning?

First, confirm that you got the installer from this site's download page at /dl/shadowrocket/ and that the download completed. If SmartScreen appears, expand More info, confirm the file, then choose Run anyway. If your device is managed by your organization, the option to proceed is unavailable, or security software explicitly reports a threat, stop and ask your device administrator. Don't disable system-wide protection. Only allow a file to run after confirming its source; don't apply these steps to email attachments or unknown files with the same name.

What should I do if my Mac says the developer can't be verified or the app is damaged?

Check that you downloaded the correct version for your chip from this site, then move Shadowrocket to Applications. If macOS can't verify the developer, try opening the app, then go to System Settings → Privacy & Security, find the blocked app notice and select Open Anyway. If macOS says the app is damaged, delete the incomplete file and download it again from this site. After confirming the source and app path, you can run xattr -cr /Applications/Shadowrocket.app in Terminal and try opening the app again. This command removes extended attributes; it won't repair a genuinely damaged file and shouldn't be run on unknown apps in bulk.

Can I install Shadowrocket on iPad? Is the first VPN configuration request expected?

Yes. Get Shadowrocket for iPad from its App Store product page. Check the App Store page for system requirements. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. When you import existing details and connect for the first time, iPadOS may ask permission to add a VPN configuration. Confirm the request came from the Shadowrocket app you just opened, then follow the system prompts to authorize it and enter your device passcode. If your device is managed or has restrictions, check its management policy rather than repeatedly reinstalling the app.

Android or Linux installer won't open? Check these settings first

On Android, first check that the arm64 installer is compatible with your device. If your browser asks for permission, allow Install unknown apps only for the app you're using to install the file; you can revoke the permission afterward. On Linux, choose deb, rpm or AppImage to match your distribution. AppImage files need executable permission before you run them. For both systems, download the installer from this site's download page and follow its installation and permission checklist. If the system architecture, distribution or dependencies don't match, resolve the compatibility issue rather than repeatedly opening the same file.

View installation permissions and commands →

Subscriptions & server imports

These steps assume you already have a valid subscription or server details. Check the source before importing, and keep a backup before updating or cleaning up.

Where do I import an existing subscription link?

Get your subscription link from your service provider. On iPhone or iPad, open Home, go to Add Server and choose Subscribe. Paste the complete link into URL, add a label you can recognize, save it and update. Check that the link's protocol and trailing parameters are intact and that it contains no extra spaces. Don't use a webpage title or account dashboard address as the subscription link. After updating, confirm the expected entries appear, then select an available entry to connect. Subscription links often contain access credentials; don't share them in public screenshots, chats or configuration examples.

Subscription import failed or the list is empty after updating. How can I troubleshoot it?

Keep your existing subscription and configuration, and note whether the failure happened while saving the link, requesting an update or parsing the response. Check that the link is complete and hasn't expired, and that your current network can reach it. A login page, error page or empty response can't be parsed as a valid subscription. Ask your service provider to confirm that the link supports Shadowrocket and that your account is active. For comparison tests, change only one thing at a time; don't switch networks, replace the link and delete configurations all at once. Hide URL parameters and server credentials before sharing an error report.

When should I update a subscription, and what changes when I do?

Update the relevant Subscribe entry when your service provider changes a server, port or credential. If the subscription hasn't been updated for a long time and connections are failing, try a manual update. Updating fetches the server details returned by the link, so existing entries may be replaced or removed. Note the entries you're using and any parameters you've changed manually first. A successful update only means the content was retrieved and parsed; it doesn't guarantee that every server can connect. Select an entry again and test it after updating. If errors persist, don't keep updating repeatedly—you may obscure the original error.

What's the difference between importing a QR code and entering details manually in Add Server?

Scan QR Code reads connection details already encoded in a QR code. Add Server lets you enter each parameter manually. Both methods depend on accurate source information. Before scanning, confirm the code comes from your own server details. After scanning, check Type, Address, Port and any credentials required by the protocol. When entering details manually, match the Trojan password, TLS and SNI settings to the server configuration; don't guess the other fields from the address and port alone. A QR code may also contain a subscription link, so check whether the import created a subscription group or a single server.

Can I delete duplicate entries that appear across multiple subscriptions?

Start by adding distinct labels for each subscription source. Then compare server address, port, protocol and required parameters; don't judge duplicates by display name alone. Entries with the same name may use different transport settings, while differently named entries may point to the same server. Once you've confirmed what's duplicated, remove subscription groups you no longer use and keep a secure backup of the original links. If you delete only an individual entry created by a subscription, it may return on the next update. Before cleanup, note the selected entry and check whether Config references it by name, so rules don't point to a missing target.

Follow the steps for importing and making your first connection →

Rules & Routing

Test your underlying network, server connection, DNS and rules separately. Keep the error message and change one thing at a time.

The connection switch on Home won't turn on or switches back off immediately. What should I do?

Read the current error message first. Confirm that you've selected a working server and authorized the system VPN configuration. Then check whether another VPN connection is active or device management and restrictions prevent adding a configuration. Try disconnecting the conflicting VPN and connecting again; if that fails, restart the device and test once more. Don't start by deleting the app, as you could lose configurations that aren't backed up. Only consider removing the relevant VPN configuration and reopening Shadowrocket to authorize it again after backing up and confirming the issue is related to the old configuration.

It says connected, but webpages won't load. What should I check first?

Disconnect and test the underlying network first. Make sure Wi-Fi or cellular data works, then reconnect in Shadowrocket and check the selected server and Global Routing. Use Connectivity Test as a reference and compare several websites; one test doesn't represent all traffic. If Proxy works but Config doesn't, check rules, policy targets and DNS first. If both fail, check the server details and service status. Direct can help compare the direct connection path, but switching to it doesn't fix a server problem.

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

Config applies the policies selected by the rules in your current Config. Use it for everyday routing once you've checked the rules. Proxy sends the relevant connections through the selected proxy and can help isolate rule issues. Direct uses the normal connection path and can help test your underlying network. To route specific websites through a proxy, select Config and check rules such as DOMAIN-SUFFIX and the FINAL fallback instead of leaving Global Routing on Proxy. Rules are usually matched in order, so put specific conditions before broader ones. Reconnect to verify any changes.

The interface is in English. Which labels should I learn first?

This guide keeps interface labels in English so you can match them directly: Home is where you manage connections and servers; Add Server adds connection details; Subscribe indicates a subscription; Config is for configurations; Settings contains preferences; and Global Routing controls routing behavior. Protocol names and rule keywords also remain in their original form. Don't enter translated terms in configurations. The interface language and server connectivity are separate issues. To change the display language, check your system's app-language settings and use the options available for your device and app.

Battery use seems higher. What should I check?

Compare battery statistics across similar periods of everyday use, and check background downloads, cellular signal strength and screen time. A VPN indicator alone doesn't identify the source of battery use. If connections keep retrying, address an unstable server or network switching first. If you enabled continuous diagnostics or detailed logging, restore your usual settings when troubleshooting is done. Check whether the On Demand triggers match your needs to avoid unnecessary reconnects. Change one setting at a time and observe the effect; don't disable essential system security settings to save battery.

Only some domains fail. How can I tell whether it's DNS or a rule issue?

Note the failing domain, network and time of the issue, then check which rule and policy the current Config applies to that domain. DNS resolution failures and server connection timeouts happen at different stages; use the error message and logs to tell them apart. On the same network, compare Config and Proxy to see whether only the rule-based route fails. Before changing DNS, save the original settings and confirm that the DNS request uses the intended route and policy. Don't replace all settings at once. If the issue occurs on only one network, check whether DNS is reachable on that network. Hide credentials and personal browsing details before sharing logs.