Shadowrocket Official Site · Official Manual

Shadowrocket for Mac Guide

Shadowrocket is a cross-platform client with rule-based routing. Import existing server details or subscriptions.

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

View the first-time setup steps

  • Shadowsocks
  • VMess
  • VLESS
  • Trojan
  • Hysteria2
  • WireGuard

01 Where to get it

Shadowrocket downloads for all platforms

The iPhone / iPad app is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android, and Linux versions are free; installers are available from this site's download page.

iPhone / iPad

One-time App Store purchase: $2.99. Check the listing for compatibility. Use the same Apple Account to redownload on a compatible iPhone or iPad.

Mac

Free · Apple silicon / Intel. Open About This Mac on the Mac you plan to install on. Match the installer to the chip or processor listed there.

Windows

Free · x64 installer. Check System type under Settings → System → About. On a managed device, ask your administrator about installation restrictions.

Android

Free · arm64 APK. Check your device’s architecture first. If an in-app browser can’t save the file, download it in your device’s browser.

Linux

Free · deb / rpm / AppImage. Choose one x86_64 package for your distribution. The download page explains how to install or run it.

View all platforms → Read installation and system notices →

02 First connection

Get started with Shadowrocket

The examples below use the iPhone and iPad interface. Have existing server details or a subscription URL ready, then check the import, routing mode, and connection in order.

  1. Add Server: add an existing configuration

    Open Add Server from Home. To add a server manually, choose the matching protocol under Type, then enter the provided Host, Port, and any fields required by that protocol. Enter the address and port in their separate fields; don't paste a complete subscription URL into Host. Save, return to SERVER, and check that the entry appears. Select the entry you want to test.

    If you already have a subscription, select Subscribe under Type and enter the complete URL. After saving, check that the group appears and contains selectable entries. If the group has a name but no entries, check the URL and update result first. Toggling the connection switch repeatedly will not restore content missing from the import.

  2. Global Routing: choose how traffic is handled

    Return to Home and check Global Routing. Config applies the active configuration's rules; Proxy uses the selected proxy; Direct sends connections directly. To apply different policies by domain or address, choose Config and confirm on the Config page that the intended file is enabled.

    When troubleshooting, change one condition at a time. On the same network, test a direct connection first, then test the same destination through the proxy, and finally compare the result under Config. If only Config behaves unexpectedly, check which rule matches the destination instead of changing the server, network, and configuration file at the same time.

  3. Home: connect and test

    Turn on the switch at the top of Home. On the first connection, the system may ask to add a VPN configuration. Confirm that the prompt corresponds to this action, then grant permission. A connected switch indicates that the system has established a client connection. This is a different check from whether a server is reachable or a website opens.

    Use Connectivity Test to check the selected entry, then open one destination expected to connect directly and another expected to use the proxy. If the test passes but access still fails, note the current mode, network type, and destination, then compare them with Troubleshooting. Remove server credentials and subscription URLs before sharing your notes.

View the full guide →

03 Settings reference

Routing rules and connection management

Find the relevant setting for your needs. The connection switch enables the client, the server determines where proxy connections go, and the routing mode and configuration rules determine which connections use it.

Choose a connection policy by condition

Set Global Routing to Config on Home for the client to match traffic against the enabled configuration's routing conditions. Rules are checked from top to bottom; the first matching entry determines whether a connection uses a proxy, connects directly, or is rejected. When debugging, put narrower conditions before broader ones, then check which policy FINAL points to. If an example domain correctly matches a proxy rule but other connections behave unexpectedly, check the default policy instead of repeatedly rewriting the example domain's rule.

  • DOMAIN-SUFFIX,example.com,PROXY
  • FINAL,DIRECT

Example: domains ending in example.com use the proxy; other connections default to direct.

04 Download and verification

Verify the app and restore purchases

Shadowrocket is a closed-source commercial app. Check how to get it for your device, and distinguish App Store purchase history from app configuration and connectivity services.

Read the App Store verification guide →

  1. Check your Apple Account's App Store region

    App Store availability depends on the store region currently used by your account. Device language, time zone, and physical location alone do not determine it. Opening the US product page in a browser only shows that the page is accessible; after opening the App Store, check whether the storefront for your current account offers the app. If you can't find it, check the account and country or region under Media & Purchases in system settings, then return to the product page and review its messages. If the issue is the device's system version, changing search terms or restarting the App Store will not change compatibility.

    If you are considering changing your account region rather than simply checking it, first check for account balance, active subscriptions, or pending purchases. Changing regions should not be the first step for every download problem. Region, system version, and payment prompts are separate issues; check them individually in the App Store download guide.

  2. Verify the developer, icon, and app ID

    Open the product page from the app verification section of the download page. Confirm the developer is Shadow Launch Technology Limited, compare the official white icon with its blue-purple outlined rocket, and check that the product page URL contains app ID 932747118. All three details should identify the same listing. A short name or icon in search results alone cannot confirm that it is the same app.

    A screenshot someone shared can help with identification, but it does not replace the current product page. Return to the download page, open the listing, and verify its name and URL. Even if another listing has a similar name, do not import existing server details into an app whose identity you have not verified. For Mac, Windows, Android, and Linux, use the platform sections and installer URLs on this site.

  3. Understand one-time purchases and device transfers

    The US App Store price for iPhone / iPad is a one-time $2.99 purchase; check the current App Store listing for the latest price. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. The same purchasing account can use this purchase on compatible iPhone and iPad devices. When changing devices or reinstalling, first make sure Media & Purchases uses the original purchasing account, then find Shadowrocket in App Store purchases. You do not need to pay again for the same purchase.

    If the new device still shows a purchase price, don't pay again just to verify the account. Check your purchase history, storefront, and app ID first. If the listing is in your history but won't download, check whether the system meets the requirements. After the app downloads, your original servers and configuration may not appear automatically; check backup or sync separately. See restore a previous purchase for details.

  4. App purchases do not include connectivity services

    App purchase ≠ connectivity plan. The one-time purchase is for the iPhone / iPad app; the Mac, Windows, Android, and Linux apps are free. This site does not provide, sell, or recommend nodes or subscriptions. To use proxy features, import an existing subscription or enter server details you already have. App Store purchase credentials cannot be used as a server password, subscription URL, or other connection details.

    Diagnose issues with connectivity services separately from app acquisition. For example, if you can restore the purchased app but a subscription update returns an empty list, check the existing URL and update result. If server authentication fails, check the connection details. Conversely, if you can't find the purchase in the App Store, changing servers or routing rules will not restore it. Identify which type of issue you have, then choose the appropriate troubleshooting steps.

  5. Get desktop and Android installers for each platform

    The Mac, Windows, Android, and Linux versions are free, with installers available at this site's /dl/shadowrocket/ path. The iPhone / iPad app is a one-time $2.99 purchase on the App Store. When moving to a new desktop device, check its system and architecture before downloading the matching installer. Do not use an installer from an old device to determine which version a new one needs, especially when moving between Apple silicon and Intel Macs.

    For iPhone or iPad app updates, check the App Store. For other platforms, return to the download page for the matching installer and keep a copy of your current configuration before updating. If the system blocks an installer whose source you have verified, distinguish source warnings from architecture mismatches and management restrictions, then read the installation guidance. Do not disable protection for the entire device to install one app. Contact the device administrator if a managed device displays a policy restriction.

05 Further reading

Shadowrocket technical notes

Choose an article for the issue at hand: identify the right installer before addressing system prompts; once connected, check On Demand triggers and background usage.

Installation basics

Install Shadowrocket for Mac and Windows: chip selection and system prompts

Use About This Mac to identify Apple silicon or Intel, then check the Windows system type. The article explains file sources, architecture selection, and first-launch blocks separately to help you identify where an issue occurs.

If the installer won't launch, note the exact system message first. If it launches but can't connect, check the server and routing mode in the guide. These issues require different steps.

Troubleshooting

Background battery use and On Demand connections

Start with battery usage in system settings, then compare the observation period with actual connection time to estimate background use. To compare two setups, keep the network and usage scenario similar and observe what changes after switching settings.

Troubleshooting

The “Add VPN Configuration” prompt on first connection

Learn why this prompt may appear when you first turn on the connection switch and how to check the corresponding configuration in system settings. If you previously declined or removed it, restore system permission first, then check server connectivity separately.

View all articles →

Download Shadowrocket for all platforms