Official Site & Manual

ShadowrocketDownloads & User Guide

Shadowrocket is a rule-based proxy client for every platform. Import existing server details or a subscription and route traffic by rule. The iPhone / iPad app is a one-time $2.99 purchase on the App Store; the Mac, Windows, Android, and Linux versions are free.

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

View the getting started guide

Global Routing Shadowsocks On Demand

Rule matching

Put the condition and policy on the same line.

RULE

Subscription URL

Use an existing link; the example below is fictitious.

SUBSCRIBE

On-demand connection

Configure when to connect separately from how to route traffic.

ON DEMAND

CONFIGURATION

Routing, connections, and configuration management

Start by distinguishing three things: server details determine where to connect, a configuration file determines the route for each request, and the connection switch determines whether the client handles traffic. When troubleshooting, check them in that order. Changing several settings at once makes it harder to identify the cause.

RULE ROUTING

Choose request routes with rules

In Home, select Config under Global Routing to have the client check rules in the active configuration file one by one. Put exceptions for specific domains before broader rules. Requests that do not match earlier conditions are handled by the final FINAL rule. To compare connection behavior temporarily, switch to Proxy or Direct and compare the results. When finished, switch back to Config and confirm which file is selected. Otherwise, your test may not be using the rules you just saved.

DOMAIN-SUFFIX,example.com,PROXY GEOIP,CN,DIRECT FINAL,PROXY

ON DEMAND

Start connections based on network conditions

Open On Demand in Settings and check which network conditions should trigger a connection. On-demand settings control when to connect; they do not replace Global Routing, which determines whether requests use a proxy or go direct. First confirm that a manual connection works on your current network. Then switch to the network you want to test and check whether the trigger works. If manual connections work but automatic connections do not, check whether the conditions cover the current network and which VPN configuration is enabled in the system. Do not start by changing server settings.

On Demand Global Routing

PROTOCOLS

Choose a protocol for an existing server

In Add Server, set Type first, then fill in Host, Port, and the fields required by the selected protocol using your existing server details. Authentication requirements vary by type. If a field disappears after you change the type, that does not mean its value was lost; the selected type may not use it. If the connection fails after you copy the details, check the protocol, host, port, and credentials one by one, and remove any extra spaces at the beginning or end. Do not guess the server configuration by repeatedly switching protocols.

Shadowsocks VMess VLESS Trojan HTTP/SOCKS5 WireGuard Hysteria2

SUBSCRIBE

Import an existing subscription and check for updates

If you already have a subscription URL, choose Subscribe in Add Server, paste the full URL provided by your service provider, and save it. Return to Home and check that the group appears and the entries you intend to use are still listed. A successful subscription update means the client retrieved the list; it does not mean every server is reachable. If an update fails, first check that the URL is complete, the network is available, and the link has not been replaced. Before sharing a screenshot of the problem, hide query parameters and credentials in the URL.

Add Server → Subscribe https://example.com/sub?token=xxxx

CONFIG & DIAGNOSTICS

Check the active file and traffic records

In Config, confirm which configuration file is selected and save a recoverable copy of the original before editing. If you use multiple devices, check which items can sync under the app's iCloud settings; do not treat syncing as a configuration backup. If the connection is unstable, use Connectivity Test in Home to check the server, then review traffic statistics in Data and Diagnostics in Settings. An increase in traffic only shows that requests passed through the client; it does not tell you which rule matched a particular destination.

Config Data Diagnostics

Check settings based on the symptom

First check whether Global Routing is set to Config, then check the currently selected item in Config. If both are correct, note the hostname you actually visited; do not rely only on the domain shown at the end of the address bar, as the page content may come from another host. Check for broader matching rules before the target rule, and confirm which policy handles unmatched requests. Change one thing at a time and retest the same destination on the same network to verify that the rule, rather than a network change, caused the result.

PLATFORM DOWNLOADS

Choose a download method for your device

The iPhone / iPad app costs $2.99 as a one-time purchase on the App Store. Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free; download their packages from the /dl/shadowrocket/ path on this site's download page. The links below show options for the relevant device first; opening a card does not start installation.

FIRST CONNECTION

Three steps to your first connection

The steps below use the iPhone / iPad interface as an example. Have your existing server details or subscription URL ready, and confirm the device can access the internet before enabling the proxy. If the first connection fails, this helps rule out the device's basic network connection as the cause.

1. Add a server or import a subscription

If you have details for a single server, go to Add Server from Home, check Type, fill in each field, save, and return to the list. If you have a subscription URL, import it with Subscribe to populate the list from the subscription. There is no need to add the same entry twice. After saving, check the SERVER group and confirm that the selected server is the one you intend to test, not an entry left over from an earlier session. Manually added servers and subscription entries may have similar names, so check their source before choosing. You do not need to post URLs or credentials publicly to check the page.

2. Choose a Global Routing mode

To route requests by rules, first confirm the active file in Config, then return to Home and set Global Routing to Config. To see whether a problem is related to rules, compare Proxy and Direct on the same network. Change only the mode during the test; do not switch servers, configuration files, or networks at the same time. If the result differs only in rule mode, check the file and rule order first. Note the mode used before testing and restore your usual setting afterward so a temporary choice is not mistaken for the previous configuration.

3. Turn on the connection and test access

Return to Home and turn on the connection switch. When the system first asks to add a VPN configuration, confirm the request was triggered by the Shadowrocket app you just opened, then follow the system prompt to allow it. Once the connection status changes, run Connectivity Test, then visit one destination expected to go direct and another expected to use the proxy. If either result is unexpected, note the network type, current mode, configuration file, and error message. An enabled connection switch alone does not confirm that traffic is working as intended. If both destinations fail, disconnect temporarily and test the same destination again to see whether the basic network connection is affected too.

View the full guide

STORE VERIFICATION

Verify the app, purchase history, and updates

Developer Shadow Launch Technology Limited App ID 932747118 2 ways to get Shadowrocket

Check the developer, icon, and App ID

Open Shadowrocket's App Store product page. First confirm the developer is Shadow Launch Technology Limited, then compare the official icon, which has a white background and a blue-violet outlined rocket. Finally, check for id932747118 in the product page URL. Search results may show similar names and icons; the Chinese nickname for Shadowrocket is not proof that a listing is genuine. Check the product details, not just the search result summary. The developer name and App ID should appear on the same product page. If either does not match, do not treat that listing as the app described in this manual.

On the App StoreVerify the Shadowrocket product page

Distinguish the App Store storefront from your device's region

App availability depends on the App Store storefront used by your account, not just your device's language or system region. If you cannot find the app, first check the product page for availability in that storefront. Then open Media & Purchases in your Apple Account settings and check the account and country or region currently used to get apps. Shadowrocket is not available on the mainland China storefront. Opening the US product page is for reference only and does not change your account's storefront. If the app is available in your storefront but will not download, check device restrictions and compatibility. For iPhone / iPad system requirements, refer to the App Store listing. For help distinguishing store messages, see the App Store guide.

Get the app on another device using your original purchase

The iPhone / iPad app is a one-time $2.99 purchase on the US App Store; prices vary by storefront. The Mac, Windows, Android, and Linux versions are free. One purchase covers both iPhone and iPad; you do not need to buy it separately for each device. When switching devices or reinstalling, open the App Store with the account used for the original purchase, go to Purchased, find Shadowrocket, and download it again. If you see a price instead of a redownload option, check the account and storefront before purchasing again. Redownloading restores the app itself; check separately whether existing subscriptions, manually added servers, and local rules were synced or backed up.

Know the difference between the app and existing proxy services

The app opening normally does not mean your existing servers are still available. Likewise, a subscription update failing temporarily does not indicate a problem with your purchase. When troubleshooting a connection, first identify whether the issue occurs while getting the app, importing details, or accessing a destination. For app access issues, check the store or download page. For changes to an existing service, check its original service details. For routing mode and rules, review Home and Config one setting at a time.

Update through the original download channel

Check for updates to the iPhone and iPad app in the App Store; you can use the system's automatic update settings. For Mac, Windows, Android, and Linux, get the corresponding package again from this site's download page. Do not judge a package's version or source by a similar-looking filename. Before updating, note the current mode and configuration file, and keep any necessary local backups. After updating, test a manual connection, then check that subscription updates, rule-based routing, and On Demand still work as expected. If the system displays an installation prompt, verify the download source and consult the installation instructions for that platform. Do not allow files from unknown sources.

READING NOTES

Recent guides

Choose a guide based on the issue: if a domain sometimes fails to load, start with the DNS resolution path; if you have a link but are unsure where to enter it, identify the link type; if only the routing result is wrong, check rule conditions and order.

Download Shadowrocket free