SHADOWROCKET / OFFICIAL MANUAL

Shadowrocket FAQ
Installation, subscriptions, and troubleshooting

Start with the symptom, then follow the relevant checks. Connection setup assumes you already have subscription or server details. Keep a working configuration before making changes, and adjust one setting at a time.

Availability & accounts

Verify the app & purchase

Understand app availability, store accounts, and connection details. Check your platform first, then confirm your purchase history.

See how to verify the app →
Can I use Shadowrocket on a computer or Android, and how much does it cost?

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. Visit the all-platform download page and choose your device. Installers for computers, Android, and Linux are available on this site at /dl/shadowrocket/. For iPhone and iPad system requirements, see the App Store listing. For first-time installation permissions on other platforms, see the installation section on this page.

How can I verify Shadowrocket in the App Store?

On the product page, check the name Shadowrocket, the official rocket icon with a white background and blue-purple outline, the developer name Shadow Launch Technology Limited, and app ID 932747118 in the product URL. Don’t rely on the name shown in search results 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. Download computer, Android, and Linux installers from this site’s all-platform download page.

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

First check the country or region associated with the Apple ID you use for the App Store. The app isn’t available in the mainland China storefront. You can open the product page linked here to check availability, but the link won’t change your account’s region. If you need to change it, go to Settings → Apple ID → Media & Purchases → View Account → Country/Region, and follow Apple’s instructions for your balance, subscriptions, and payment details. Your device language does not determine your storefront region.

Do I have to buy Shadowrocket again if I get a new iPhone, reinstall it, or switch to an 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. On an iPhone or iPad, sign in with the same Apple ID used for the purchase, then find and redownload the app in your App Store purchase history. Your device must still meet the system requirements shown on the product page. If you see a price again, check your store account and purchase history before paying again. Redownloading the app does not restore its configuration, so keep your subscriptions, rules, and server details separately.

Does buying the app include access to servers?

No. A one-time app purchase does not include a server plan. Shadowrocket imports and manages subscriptions or server details you already have. The iPhone and iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free. Neither option includes server access. This site does not provide, sell, or recommend servers or subscriptions. Before setup, have your own valid connection details ready and check their validity period and settings.

System & permissions

Install

Check the download source, chip, and architecture before responding to system warnings. Follow administrator settings on managed devices.

See installation permission steps for all platforms →
Which Mac version should I choose: Apple Silicon or Intel?

Open About This Mac from the Apple menu and check whether it shows Chip or Processor. Choose the Apple Silicon version for an Apple chip and the Intel version for an Intel processor. The download page has a separate DMG button for each; there’s no need to guess based on your Mac’s appearance. If macOS says it can’t verify the developer on first launch, confirm the installer came from this site, then choose Open Anyway under Privacy & Security in System Settings. Company-managed devices may also require administrator approval.

Windows SmartScreen warns about risk. How can I continue installation?

First confirm that the installer came from this site’s download page and matches your device architecture. The Windows version is a 64-bit installer. It isn’t code-signed, so SmartScreen may appear on first launch. If you’ve verified the source and choose to continue, select More info, then Run anyway. Don’t leave system protection disabled just to run one app. If there’s no option to continue, or your device is managed by an organization, contact your administrator. If malware is explicitly detected, stop and verify the file before proceeding.

Mac says it can’t verify the developer or that the app is damaged. What should I do?

First check the download source and chip version, then move the app to Applications before opening it. If macOS can’t verify the developer, go to System Settings → Privacy & Security, find the relevant notice, and select Open Anyway. If macOS says the app is damaged, confirm it’s intact and came from this site, then run xattr -cr /Applications/Shadowrocket.app in Terminal and try again. This command removes extended attributes from the specified app. Don’t run it on software from unknown sources or across other directories.

Android blocks installation. Which permission should I change?

Download the installer for your arm64 device from this site’s download page. If Android says installation from this source isn’t allowed, open Allow installation of unknown apps in System Settings and authorize only the browser or file manager you’re using to open the installer. Return to the installer and continue. You can revoke that permission afterward. Settings names may vary by device. If parsing fails, check that the download completed, the device architecture matches, and no work profile or parental control policy is blocking installation.

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

Debian and Ubuntu users generally choose deb; Fedora users generally choose rpm. Choose AppImage if you want to run a standalone file. Download the package that matches your system architecture from this site, then install it with your distribution’s package manager. AppImage files need execute permission; run chmod +x on the downloaded file before launching it. Some distributions also require FUSE runtime support. Check the package manager’s dependency prompts before installing; a file extension alone doesn’t guarantee compatibility with every distribution.

What should I do when Shadowrocket first asks for VPN permission on iPhone or iPad?

Have your own subscription or server details ready, import them by following the tutorial, then start the connection. When iOS asks to add a VPN configuration, confirm the request is from Shadowrocket and follow the prompts to allow it and authenticate your device. If you previously denied the request, start the connection again and check the system’s VPN settings. Managed devices may block personal VPN configurations; contact your administrator and don’t remove organizational configurations. Allowing a VPN configuration grants permission to create a local connection, but you still need a valid server and correct settings to access the network.

Subscriptions & configuration

Import subscriptions & servers

Import success, server reachability, and rule behavior are separate checkpoints. Verify each in order.

See the subscription import tutorial →
How do I import an existing subscription link into Shadowrocket?

Copy the full subscription link from your own provider’s details. Open Home, go to Add Server, set Type to Subscribe, paste the link into URL, and save. You can add a name to identify it. Return to the list, wait for the content to load, then select a server to test. Check for extra spaces or line breaks and make sure no query parameters are missing. Subscription links often contain access credentials, so don’t include them in public screenshots, chat logs, or feedback. See the subscription import tutorial for the relevant screens.

A subscription import failed. How can I tell whether the link or network is the problem?

First check that the URL is complete, the subscription hasn’t expired, and the link returns subscription data the app can recognize—not a login or error page. Then try once over Wi-Fi and once over mobile data to see whether the error changes with the network. For an HTTP error, note the status code. For a timeout, check your current network and whether the subscription address is reachable. Don’t repeatedly delete existing working entries or share the full link publicly. If the cause is still unclear, send your provider a redacted error and the steps that triggered it.

How do I update a subscription, and why did the server list change afterward?

In Home, find the relevant subscription group and use its update action. Wait for the request to finish, then check the list. The update refreshes entries using the content returned by the subscription URL, so server names and available options may change if the provider removes or modifies servers. Before updating, note the entry you’re using and any custom settings; save manually added servers separately. If the list is empty or an error appears, check that the link is valid instead of retrying repeatedly. Updating a subscription does not update rule files managed separately in Config.

How should I configure protocols such as VLESS, and why might a connection still fail after import?

Set Type according to the protocol details for your own server. Don’t mix up fields for VLESS, VMess, Trojan, or Shadowsocks. Importing can reduce manual entry, but it doesn’t guarantee that every setting is correct. Check the address, port, authentication details, TLS, transport method, and related hostnames one by one. If the connection fails, compare the settings with the original details, then test one entry at a time. Don’t disable certificate verification just to clear an error, and don’t post a full connection link containing credentials in public feedback.

What do subscriptions, servers, and Config files each manage?

A server entry stores specific connection settings. A subscription URL retrieves and refreshes a group of servers. Config files manage rules, policies, and related network settings. These work together, but they aren’t interchangeable backups. Before making changes, note which Config is active, and separately save manually added servers and existing subscription details. After importing a new rule file, make sure its policy names correspond to options that are actually available. Updating a subscription alone doesn’t mean your local rules have been updated.

What should I check after scanning a QR code or adding a server manually?

After using Scan QR Code or Add Server, check Type, server address, port, and authentication fields. Then confirm that TLS and transport settings match your original details. A QR code may contain only some of the information, and a successful scan doesn’t mean the server is usable. Save the entry, select it, and run Connectivity Test before trying to connect and visit the target website. If you need to send feedback, cover the QR code, authentication fields, and subscription URL. Include only the error and setting names that don’t contain credentials.

Connections & comparison

Troubleshooting

Compare local network, server, and rules results separately to avoid conflating different kinds of problems.

Open the full troubleshooting guide →
How do I choose Config, Proxy, or Direct in Global Routing?

Config routes connections according to the rules in the active configuration file, making it useful for checking rule-based routing. Proxy helps test traffic through the selected proxy. Direct lets you compare against your local network. Change only one mode at a time and record the result for the same destination. Proxy won’t make an invalid server work, and Direct doesn’t prove that a proxy connection is working. After testing, restore the mode you need and check that the right Config is selected and its policies reference a valid server.

Home won’t turn on, or the connection drops as soon as it starts. What should I do?

First make sure a valid server is selected. Then check whether the system is waiting for you to add a VPN configuration or authenticate the device. If the switch turns off immediately, look for conflicting connections in the system VPN settings and check whether your device is restricted by organizational policy. If you need to switch connections, stop the other one normally first. Note the error, restart the app, and try again; don’t start by deleting all configurations. If the connection still can’t be created, use the troubleshooting page to record your system version, steps to reproduce the issue, and redacted logs. This helps distinguish a permissions problem from a server connection failure.

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

First disconnect and confirm that your local network can reach websites that normally work. Reconnect, then run Connectivity Test for the selected server. Next, temporarily compare Proxy and Config against the same destination. If Proxy works but Config doesn’t, focus on rules, policies, and DNS. If both fail, check server status, authentication settings, and network reachability. A connected status only means the local connection is established; it doesn’t mean every destination is reachable. Change one setting at a time and keep the original configuration so you can restore it.

Connectivity Test times out, but websites sometimes load. How should I interpret that?

Connectivity Test results depend on the test destination, method, and network at the time; they don’t represent access from every app. First confirm the selected server, then test a website you actually need to use. Repeat the test on a different network. If only the test fails while your apps work, check whether the test destination is reachable. If real-world access also keeps failing, check the server, port, and DNS. Don’t treat one reading as a long-term speed result or change several settings at once to improve a single test.

Only some domains fail to load. Should I change DNS?

First compare the domain’s matched rules with the active policy. Check whether a DOMAIN-SUFFIX or GEOIP rule is routing the connection somewhere unsuitable. Then look for DNS resolution errors and compare results on another network. Save your current Config before changing DNS, adjust one setting at a time, and retest the same domain. Don’t change the server and all DNS settings at once. If the domain resolves but the connection fails, check TLS, server reachability, and the destination itself rather than repeatedly changing DNS.

Background battery use has increased. Should I turn On Demand on or off?

First check system battery usage for the time period, background activity, and actual data use. Then see whether the logs show frequent reconnections. On Demand starts connections when its conditions are met, so whether it’s appropriate depends on how you use the app. If networks change frequently or rules keep matching, check the trigger conditions first. Temporarily turn On Demand off under similar usage conditions and note whether battery use improves. Sustained data transfers and activity from other apps also affect battery life; the VPN icon staying visible alone doesn’t identify the cause.

The interface is in English, or settings moved after an update. What should I do?

This manual keeps interface labels such as Home, Config, Settings, Global Routing, and Add Server in English so you can find them by name without guessing from translated equivalents. Layouts can vary across platforms and app updates. Find the relevant setting by what you want to do, then follow the corresponding tutorial steps. Save a working configuration before updating. If something goes wrong afterward, check whether the selected server, Global Routing, and Config are still set as before, then test one item at a time. Don’t clear all data just because a setting moved.

Continue with the relevant steps

For a start-to-finish walkthrough, read the tutorial; if you already know the symptom, go to Troubleshooting. When reporting an issue, include your device OS, the steps you took, the exact error message, and results on another network. Remove subscription links and authentication details before sending feedback.