Rule-based proxy client for all platforms

Shadowrocket
Setup, configuration & rule-based routing

One client for multiple platforms. Import existing subscriptions and manage connection paths with Global Routing and rules.

Current version Loading · iPhone/iPad are $2.99 once on the App Store; Mac, Windows, Android and Linux versions are free.

First-time setup: add a subscription and connect →
  • Global Routing
  • On Demand
  • Subscribe

Shadowrocket features and configuration tools

Rule: route traffic by match criteria

  • Match by domain, keyword or IP range
  • Choose between PROXY, DIRECT and REJECT
  • Check matches against the current Config

Rules determine which path a destination should use; they do not replace server settings. Check which file is enabled in Config, then select Config in Global Routing so its rules can take effect. Rules are usually evaluated from top to bottom, so put specific conditions before broader ones and check the fallback policy in FINAL. After editing a rule, make a new request to the destination, then check the policy in the connection log. Existing connections may continue to use the previous path. The example domain is for syntax illustration only and is not a recommended configuration.

Read about Rule and routing
default.conf · [Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-KEYWORD,ads,REJECT
FINAL,PROXY
Policy meaning
  • PROXYUse the proxy policy
  • DIRECTConnect directly to the destination
  • REJECTReject matching connections
2 ways to get the app

Get Shadowrocket for your device

View all platforms →

iPhone/iPad are a one-time $2.99 purchase on the App Store; Mac, Windows, Android and Linux versions are free. The links below lead to the download page. Desktop and Android installers are provided on this site at /dl/shadowrocket/. Check your device system and processor before choosing an installer, then read the relevant installation instructions.

iPhone / iPad

One-time $2.99 purchase on the App Store. Mac, Windows, Android and Linux versions are free.

Both devices can get the app using the same purchasing account. Check the App Store listing for system requirements. Before downloading, verify the developer, official app icon and app ID; check your purchase history before reinstalling or changing devices.

Mac

Free · Apple Silicon / Intel.

Check the chip or processor in About This Mac, then choose the matching installer. If macOS blocks the first launch, verify the source, then follow the steps under “Privacy & Security” on the download page.

Windows

Free · 64-bit installer.

The download page provides the Windows installer and guidance for SmartScreen prompts. Confirm the file is from this site. If a protection prompt appears, select “More info → Run anyway” to continue; managed devices should follow administrator policies.

Android

Free · arm64 package.

Open the download page in your system browser. If installation requires it, enable “Allow from this source” only for the browser or file manager you are using. After installation, you can turn off installation permission for that source in device settings.

Linux

Free · deb / rpm / AppImage.

Choose a package format that matches your distribution. Do not install multiple formats to troubleshoot the same issue. AppImage requires executable permission; installation commands and first-launch instructions are on the download page.

Permission prompts and menu locations vary by system. Feature descriptions on this page use iPhone/iPad interface terms as examples. On other systems, complete the download page’s installation steps first, then check existing settings against the options shown in the client.

First connection: check in order

Add details → Select a mode → Verify the connection

Read the full guide →

Before you start, prepare your own existing subscription URL or server details, and make sure the device can access the network. The steps below summarize the iPhone/iPad workflow. Confirm the result at each step before moving on. This site explains client configuration and does not provide servers or subscription services.

  1. Add Server: enter your existing details

    Open Add Server from Home. If you have an existing subscription, enter the URL according to its type. If you have an individual server, choose Type first, then enter Host, Port and the required authentication details. You can also use Scan QR Code to import information you already have; review the fields after importing.

    After saving, return to the SERVER group, confirm the entry appears and select the server you want to test. If the list is empty, check the subscription URL and update result. If fields are missing, complete the details instead of changing the routing mode to work around a parameter issue.

  2. Global Routing: choose a routing mode

    Config routes traffic according to the current configuration; Proxy handles general connections through the proxy path; Direct primarily accesses destinations directly. These modes select how traffic is handled. They are not protocols and do not fill in server parameters.

    For everyday rule-based routing, first check which file is enabled in Config, then select Config. When troubleshooting, record the original setting before temporarily switching modes and comparing results for the same destination. Restore the original setting when testing is complete so a temporary troubleshooting state is not left in place.

  3. Connection switch: grant permission and verify

    Turn on the connection switch at the top of Home. The first time the system asks to add a VPN configuration, review the prompt, allow it and complete any confirmation required by the device. Once the switch shows a connected state, make a real request to a destination and check the response and connection log.

    A Connectivity Test result only shows that the relevant test completed under the conditions at that time; it does not verify access to a destination. If the test and actual access differ, check the current server, Global Routing, Config and DNS-related settings in order. Keep the result of each step to help isolate the issue.

App identity and purchase information

Verify the app, then import your own configuration

View verification steps →
  • Developer: Shadow Launch Technology Limited
  • App ID: 932747118
  • 2 ways to get the app: App Store purchase / site installer

Check three identity details on the product page

Verify the app by its product name, Shadowrocket; developer, Shadow Launch Technology Limited; and app ID, 932747118. Also check the official app icon on the product page. A similar name or image is no substitute for checking all three details.

Open the App Store product page linked from the download page. Check the developer field first, then the app ID in the link, and finally the app icon and name. Search results may include listings with similar names, so do not rely on ranking alone. Check the App Store listing for system compatibility, currently displayed features and store details.

App Store visibility depends on account region

If the app does not appear in App Store search, first check the region of the Apple account used for purchases, rather than relying only on the device language or location. Product availability and local currency display can vary between storefronts. Screen Time age-rating restrictions and account status can also affect search or downloads.

Check whether the product page opens, the account region and content restrictions, then review payment methods and account prompts. If changing the account region, follow the process in Apple Account settings and review balance, subscriptions and payment requirements. There is no need to repeatedly change the device region just to troubleshoot search. The download page lists these checks in order.

Two ways to get the app and restore purchases

iPhone/iPad are a one-time $2.99 purchase on the App Store, with both devices sharing purchase history under the same purchasing account. Mac, Windows, Android and Linux versions are free. The store displays local currency and the actual price for the current storefront. Review the payment confirmation before purchasing, and distinguish the app purchase from fees for other services.

When changing devices or reinstalling, sign in to the original purchasing account and find Shadowrocket in your purchases. Restoring the app and restoring configuration are separate steps: after downloading the app again, check whether subscriptions, server details and Config are still available. For other platforms, get the installer from this site’s download page; back up existing configuration before updating.

Manage the client and connection details separately

Buying the app does not include a service plan. The app purchase provides access to the client; it does not include servers, subscription URLs or a usable connection service. You need your own existing subscription or server details to use it. This site does not provide, sell or recommend servers or subscriptions; it explains how to import, update and troubleshoot details you already have.

Check subscription validity, server authentication details and connection limits in your own service information. If the app opens normally but a subscription update fails, check the URL, permissions or service status. Conversely, an updated list does not prove that every server can reach a destination. Separating these issues helps avoid unnecessary repurchases or repeated reinstalls.

Get desktop and Android installers from this site

Mac installers are available for Apple Silicon and Intel. Windows, Android and Linux files are provided for their respective systems. Installer links are on this site’s download page, and the files use the /dl/shadowrocket/ path. Do not assume a file with the same name from another page matches your device and processor.

If the system blocks installation the first time, verify the source before following the relevant instructions. On macOS, check “Privacy & Security”; on Windows, review the specific SmartScreen prompt; on Android, check installation-source permissions; and on Linux, choose the package format for your distribution. On managed devices, follow administrator requirements rather than bypassing organizational policies.

Keep a recoverable configuration before updating

Shadowrocket is a closed-source commercial application. App updates, subscription updates and rule-file updates are separate: the first changes the client, subscription updates maintain the server list, and Config stores routing and related settings. If behavior changes, first identify which part changed instead of replacing everything at once.

Manage iPhone/iPad app updates through the App Store; get installers for other platforms from this site’s download page. Export important Config files and keep existing subscription details before updating. After recovery, check Global Routing and the current configuration. Before sharing troubleshooting screenshots or logs, conceal subscription credentials, server authentication fields and personal access records.

Practical guides

Configuration, rule syntax and server selection

View all articles →

After your first connection, continue with the guide that fits your task. Back up before migration, check match order before editing rules, and consider latency tests and real access results when choosing from your existing servers. Each article covers a specific issue; there is no need to change every setting at once.

Download Shadowrocket for all platforms