Shadowrocket Mac Setup and Rule Routing

A cross-platform rule-based proxy client. Choose the installer for your Mac chip, then import an existing subscription and configure routing. iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android, and Linux: free.

Current version v2.2.92 · Free for Mac, Windows, Android, and Linux

  • Shadowsocks
  • WireGuard
  • Global Routing

Shadowrocket settings

Rules, subscriptions, and connection checks

The examples below use the iPhone / iPad interface. First confirm that the server connects, then check whether rules route requests to the intended policy. A successful connection and correct rule routing are separate outcomes; verify each one.

Choose a routing mode with Global Routing

Open Global Routing in Home. Choose Config for rule-based routing, Proxy to temporarily troubleshoot the proxy path, or Direct to compare with your local network. In Config mode, the client checks requests against rules in order and applies the policy for the first match. Put rules for a single domain before broader rules, then check the fallback policy at the end. The example below routes a sample domain and its subdomains to PROXY. It shows the three parts of a rule: match type, match value, and policy.

  • Global Routing
  • Config
  • Proxy / Direct
DOMAIN-SUFFIX,example.com,PROXY

First connection

Add a server, choose a mode, and check the connection

After installation, prepare existing server details or a subscription address. For the first setup, connect to one server and then check routing. Importing multiple sets of details, switching modes, and enabling automatic connections at once makes it harder to identify the cause of a failure.

  1. Add a server or import a subscription

    Open Add Server in Home. For a single server, choose the Type specified in its details, then enter Host, Port, and the required authentication fields. For a subscription, choose Subscribe and enter the full address provided by your service provider. After saving, return to Home and select the entry you want to connect to under SERVER. If names are similar, distinguish entries by group and address rather than display name alone.

    If no entry appears after saving, first check whether you entered a subscription address or a single-server link. These use different import methods, and pasting one into the wrong place may not create a list. For an existing subscription, check that the copied address is complete, then confirm the current network can access it. Avoid repeatedly adding the same source when retrying.

  2. Choose a mode in Global Routing

    If you already have a rule file and want requests routed by rules, choose Config and check which file is active. To temporarily test whether the proxy server can handle requests, keep the same server and switch to Proxy. To compare with your local network, switch to Direct. This setting controls how traffic is handled; it is separate from the server selected under SERVER.

    Before testing, note the original mode and configuration name. If a site works in Proxy but not Config, first check for an earlier matching entry in Rule or see whether the request reaches FINAL at the end. Do not replace the whole configuration at the first sign of a failure. Reproduce the difference with the same URL, then change the relevant rule.

  3. Turn on the connection and verify it

    Return to Home and turn on the connection switch. The first time the system asks to add a VPN configuration, confirm that the prompt was triggered by the Shadowrocket app you just opened, then follow the system prompts. Once connected, use Connectivity Test to check the selected server, then visit a familiar address. A test result only shows whether that particular test completed; it does not replace a real browsing check.

    If the system switch does not stay on, check VPN configuration permissions and the selection under SERVER. If the switch is on but only some addresses behave unexpectedly, keep the server unchanged and compare routing modes. When describing an issue, note the device system, current mode, test method, and error message. Do not include passwords, full subscription addresses, or QR codes containing credentials.

2 ways to get the app

Choose a device and installer

iPhone / iPad: $2.99 one-time via the App Store; check the App Store listing for system requirements. Mac, Windows, Android, and Linux versions are free, with installers available from this site at /dl/. For desktop and Android devices, check the system and architecture before choosing a download. A file for one system cannot be used across different systems.

Mac: check the chip, then move the app to Applications

Open About This Mac from the Apple menu in the upper-left corner. If it shows Apple Silicon (M series), choose the Apple Silicon version; if it shows an Intel processor, choose the Intel version. Do not infer the processor from the model name or appearance: a product line may include both types. Open the corresponding DMG, drag Shadowrocket.app to Applications, and eject the disk image after copying finishes. Then open the app from Applications.

If a first launch says the developer cannot be verified, check the download source and selected architecture. If the source is confirmed and device policy allows it, open System Settings › Privacy & Security and look for the Open Anyway option for this app. If a message says the file is damaged, the filename does not match, or system policy prevents continuing, stop and investigate instead of treating every message as a first-launch block. See installation instructions for each platform.

Before reinstalling, quit the running client and make sure any configuration or subscription you need to keep is saved. After installation, open the replacement app from Applications and confirm it launches before importing or restoring configuration. If a system window points to a file on the old disk image, close it and make sure you are opening the copy in Applications. Otherwise, an old copy may be mistaken for a failed update.

Purchase, verification, and recovery

Verify the genuine Shadowrocket app

  • Developer: Shadow Launch Technology Limited
  • App ID: 932747118

Check the developer, icon, and app ID

Open the product listing in the App Store. First confirm the developer is Shadow Launch Technology Limited, then compare the official icon at the top of this page: a blue-purple outlined rocket on a white background. Finally, check that the app ID in the product page URL is 932747118. Similar icons and names can appear; if any of these details do not match, return to the genuine app verification guide instead of purchasing that listing.

If it does not appear in search, check the storefront region

The App Store catalog varies by the country or region of your account. If the app is not listed in the mainland China storefront, the product link may still open a US storefront description on the same device. Seeing the listing on the web does not mean your current account can buy it in its storefront. Check your account region under Media & Purchases in system settings. If you need to change it, follow Apple’s official process and review conditions such as account balance and existing subscriptions. Check the App Store listing for system requirements.

Purchase and restore with the same account

iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android, and Linux versions are free. A purchase made with the same Apple Account can be shared between eligible iPhone and iPad devices that meet the system requirements. On a new device or after reinstalling, first look in the store’s purchased items. If the listing still shows a purchase button, check the signed-in account, storefront region, and purchase history rather than treating a new purchase as a restore step. Restoring the app does not restore local configuration; check configuration and server lists separately.

Update the app by platform

Update the iPhone / iPad app through the App Store. For Mac, Windows, Android, and Linux, get the appropriate installer for your device from this site’s download page. Check the chip, architecture, and package format each time; files with the same extension are not necessarily interchangeable between devices. Shadowrocket is a closed-source commercial application. Client updates, rule-file changes, and server subscription refreshes are separate operations. If routing behaves unexpectedly after an update, first check that the intended configuration is still selected, then decide whether to refresh the subscription.

More from the official guide

Recent articles