Official site and guideRule-based proxy client for multiple platforms

ShadowrocketSetup Guide

Available across platforms, Shadowrocket uses your existing subscription or server details to configure rule-based routing. iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android and Linux: free.

Current version v2.2.92 · iPhone / iPad: $2.99 one-time; Mac, Windows, Android and Linux: free

ConfigVLESSDOMAIN-SUFFIX

Settings and configuration reference

Confirm the connection method before adjusting rules

Shadowrocket manages server details, configuration files and connection controls separately. For first-time use, import your existing details, select an available entry in Home, then check Global Routing. Config routes traffic according to configuration rules, Proxy sends matching traffic through the selected proxy, and Direct connects directly. These modes are separate from server protocols and should not be confused.

The six sections below explain where to find each feature and how to verify it. Keep the current working configuration, change one item at a time and retest the same destination. This makes it easier to identify whether a difference comes from server parameters, DNS resolution or rule order.

Rules are matched from top to bottom

In Config, check the currently selected configuration and set Global Routing to Config. Rules are matched from top to bottom. Specific domains generally go before broad conditions, with FINAL at the end. DOMAIN-SUFFIX matches a domain and its subdomains; IP-CIDR matches an address range. PROXY, DIRECT and REJECT specify different actions. Save changes, then check the result against the same destination. The example on the right demonstrates syntax only; it is not a complete configuration for every network.

Global RoutingConfig
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

Two ways to get the app

Choose Shadowrocket for your device

iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android and Linux: free. Desktop and Android installation packages are provided on this site under /dl/shadowrocket/. Choose your device and architecture on the download page; do not use a package for another platform just because its filename looks similar.

Whether the same subscription or server details work across devices depends on the protocol, parameters and device limits of your existing service. How you get the client and your service account are separate matters. When moving to another device, save the original details first, then run a separate connection test on the new device.

iPhone / iPad

App Store · $2.99 one-time

Both devices share the purchase. Use the same purchasing account to view your purchase history. Open the App Store product page and verify the developer, official icon and app ID before confirming your purchase. Check the App Store page for system requirements. Mac, Windows, Android and Linux versions are free.

When connecting for the first time, allow the VPN configuration when prompted by the system. After installation, import your own subscription or server details. Seeing the app icon in Home or a VPN status on the system does not replace an actual access test.

Mac

Free · Apple Silicon / Intel

Check the chip or processor in About This Mac, then choose the matching version. Separate installation packages are available for Apple Silicon and Intel. The download page provides two consistently labeled options; do not infer the chip from browser detection.

If macOS blocks the first launch, verify the source and follow the installation instructions to use “Open Anyway” under “Privacy & Security.” If you see a “damaged” warning, read the relevant steps on the download page rather than repeatedly moving or renaming the app to bypass the warning.

Windows

Free · 64-bit

Use the Windows installation package provided on this site's download page. Save your existing configuration first and confirm the system architecture. After updating the client, check the selected configuration, proxy status and access results in your usual apps.

If SmartScreen appears, first confirm that the package came from this site, then select “More info → Run anyway.” Detailed instructions are on the download page. If your device is managed by an organization, follow its administrator's restrictions.

Android

Free · arm64

Get the arm64 installation package from this site's download page, import your existing details and check connection permissions. The folder where your browser saves files may vary by system. Open the relevant file from the current download history to avoid using an older package by mistake.

If the system asks you to “Allow installing unknown apps,” enable the permission only for the browser or file manager used for this installation. You can restore the setting afterward. A separate VPN permission prompt appears on the first connection; installation and connection permissions must be confirmed separately.

Linux

Free · deb / rpm / AppImage

Choose deb, rpm or AppImage according to your distribution's package management method. Check the architecture and file format first, then refer to the corresponding commands on the download page. Do not apply an installation command for one distribution to a different package format.

AppImage requires execute permission, while deb and rpm packages are installed using their respective package managers. The download page includes examples for permissions and installation. After installing, check user permissions, desktop launch behavior and the configuration path before testing the connection.

Verify the app and understand the prerequisites

Verify the app identity and distinguish purchase from connectivity services

Shadowrocket is a closed-source commercial app. This is the official site and guide, providing access to the client and configuration instructions. App Store manages iPhone / iPad purchases; get desktop and Android packages from this site's download page. Check the details for the relevant source.

Check three details on the App Store

Do not identify the app by name alone in search results. Open its product page, check the developer, then verify the icon and app ID. The developer name must exactly match Shadow Launch Technology Limited, and the app ID must be 932747118. Use the official icon shown alongside as a reference.

After verification, check the store price and compatibility. The US App Store price for iPhone / iPad is $2.99 one-time; other storefronts display local currency. Mac, Windows, Android and Linux versions are free. If a search result has a similar name but a different developer or app ID, return and verify the product page again.

Read the app verification and store account guide →
Official Shadowrocket icon
Developer
Shadow Launch Technology Limited
App ID
932747118
How to get it
iPhone / iPad: App Store
Mac / Windows / Android / Linux: this site's download page

Check your account region if the app is not listed

If you cannot find the app in the iPhone / iPad App Store, first check the Apple Account used for “Media & Purchases” and its storefront region, rather than relying on the device language or your physical location. The app is not available in the mainland China storefront, and changing the device language will not switch storefronts automatically. Check “Country/Region” in account settings, then review age-rating restrictions, sign-in status and payment requirements.

If you need to change your storefront region, review the account requirements first and address any factors that may affect the change, such as account balance, existing subscriptions or Family Sharing. Do not confuse “not found in search” with “device incompatible”: for the former, check the storefront and account; for the latter, follow the system requirements shown on the App Store page. The app verification guide explains each case.

Purchases, device changes and restoring purchases

iPhone / iPad: $2.99 one-time via the App Store, shared by both devices; Mac, Windows, Android and Linux versions are free. Before changing devices or reinstalling, confirm the original purchasing account. On the new device, find Shadowrocket under “Purchased” in the App Store and download it again. If the page still shows a purchase button, check that you are using the same account, that the record is not hidden and that the current storefront displays the app.

Downloading the app again and restoring configuration are separate steps. A purchase record does not restore server passwords, subscription addresses or local rules automatically. Save your own original details before moving devices. For Family Sharing, refer to the sharing terms shown on the product page and in Family settings; availability is not necessarily the same for every account or storefront.

App purchase ≠ service plan

Getting the app only provides the client; it does not create a connectable server. This site does not provide, sell or recommend nodes or subscriptions. All import instructions assume that you already have your own subscription or server details. For expired subscriptions, authentication errors or device limits, first check the account and original parameters for your existing service.

So, a successful App Store purchase with no server entry in Home does not mean the purchase failed. Prepare valid details, then add or import them using the guide. If an existing entry cannot connect, check the protocol, address, port, authentication and network path. Repeatedly purchasing the client will not fix a server-side error.

Follow a consistent order for the first connection

In Home, first confirm that an entry appears in the SERVER group, select it and run Connectivity Test. Next, check Global Routing: for everyday rule routing, use Config and confirm that the intended file is selected in Config. After responding to the system's connection permission prompt, visit a specific destination in a browser and check the result rather than relying only on the connection toggle.

If the test succeeds but an app fails, keep the working server and continue by checking the rule matched by that destination, DNS resolution and the app's own network settings. Config, Proxy and Direct can help narrow down the issue, but note the result after switching modes and restore the intended setting. Changing several parameters at once makes the cause harder to identify.

Update the app and subscription separately

App Store manages client updates for iPhone / iPad. Mac, Windows, Android and Linux users can get the corresponding updated package from this site's download page. Before updating, save your current configuration and necessary authentication details. Afterward, check the selected server and rules file, then test the connection. Version details shown on the page are read dynamically from the download manifest; do not use an old article's version as a selection guide.

A subscription update fetches the server details provided by the subscription; a configuration update may change rules or DNS. Neither is an app update. If behavior changes after an update, first identify which layer changed, then check for removed entries, modified protocol fields or a different rule order. This helps preserve what still works and reduces repeated setup.

Keep diagnostic details to investigate DNS issues

If a domain cannot be accessed, first distinguish “domain could not be resolved” from “address resolved but connection failed.” Note the failed destination, network type, selected entry and Global Routing, then review Diagnostics and relevant logs. Save the original value before changing DNS and retest the same destination. Changing several DNS addresses at once usually does not reveal which one took effect.

Traffic in Data indicates that data is being transferred; it does not mean every request has completed. Connectivity Test results also depend on the test method and destination. Before sharing diagnostic details, hide full subscription addresses, passwords and personal browsing records. example.com in the rule examples is for syntax illustration only.

Frequently asked questions

Why can I still not connect after importing a subscription?

First confirm the entry appears under SERVER and that the intended server is selected. Then check the protocol, port, authentication and Connectivity Test. Finally, check Global Routing and the current configuration. A successful subscription download means the list was retrieved; it does not mean every server in it will work on your current network. Follow the first connection steps →

Should Global Routing be set to Config, Proxy or Direct?

For rule-based routing, choose Config and verify the selected configuration file. Proxy and Direct can help test the proxy or direct connection path. They do not change the server protocol or fill in missing authentication fields. Restore the intended mode after troubleshooting so temporary test settings are not left in place. See the modes and verification steps →

Can I use Shadowrocket on Mac, Windows, Android and Linux?

Yes. iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android and Linux: free. Mac packages are available for Apple Silicon and Intel; on Linux, choose the package format for your distribution. Get the relevant package from the download page and read the system permission instructions for first launch. Choose a platform →

Will my configuration return automatically after downloading the app on a new device?

App purchase records and configuration details are managed separately. Restore the client first, then check whether your original subscription, server details and rules files were backed up or synced. Even if you can see a file through iCloud, confirm that it is selected. For the first connection, check system permissions and actual access results again. Review import and connection checks →

Guides and topic references

Continue with a guide for your specific question

Choose a topic to verify the App Store listing, understand protocols or adjust rules. Each article explains its prerequisites, steps and checks separately. Connection instructions start with your own existing subscription or server details and do not replace the original parameters.