iPhone / iPad on the App Store $2.99 one-time · Mac / Windows / Android / Linux free

All platforms →

Official guide · All platforms

Shadowrocket Guide

Rule-based proxy client for all platforms. Start by importing an existing subscription, then learn Global Routing and rule-based routing, and check the configuration against the connection results.

Current version · iPhone / iPad $2.99 one-time; Mac, Windows, Android and Linux versions are free

First-time setup: import and connect step by step →
ShadowsocksTrojanConfig

How to get it / 2 options

Shadowrocket for all platforms

Choose a device to see the relevant access and installation instructions. iPhone / iPad costs $2.99 once in the App Store; Mac, Windows, Android and Linux versions are free, with installers available from this site's download page.

iPhone / iPad

App Store: $2.99 one-time.Both devices share one purchase; other platforms are free. Check the developer, icon and app ID in the store. System requirements are as listed on the App Store page. Once you have your own subscription or server details, continue to the first connection steps.

Mac

Free · Apple Silicon / Intel.Check the chip information in “About This Mac,” then choose the matching installer. If the system blocks the first launch, follow the download page's “Allow installation” steps and review the privacy and security prompts. Avoid repeatedly downloading different architectures to troubleshoot.

Windows

Free.Use the 64-bit installer provided on this site. If SmartScreen appears, check the file source first, then follow the installation instructions to view the run option under “More info.” If the connection fails, also check for conflicts with the system proxy or an existing VPN.

Android

Free.Get the arm64 installer from the download page. On first installation, follow the system prompt to allow the browser or file manager in use to install unknown apps; you can revoke this permission afterward. Read the system VPN authorization prompt carefully when connecting.

Linux

Free · deb / rpm / AppImage.Choose the package format for your distribution; do not mix formats. AppImage files need execute permission before the first run. The download page lists package-manager installation and related commands; confirm the filename and directory before running them.

Features and settings

Rules, subscriptions and connection diagnostics

Server parameters determine where to connect; Global Routing determines how connections are handled; rules in Config determine which requests use a proxy. The sections below explain each part by task.

Rule: match connections in order

Rule-based routing is useful when only specified domains should use a proxy. In Config, check the active configuration and Rule order, then set Global Routing to Config. Rules are typically evaluated from top to bottom, and the first match determines the policy. Put specific domains before broad conditions and leave FINAL at the end. This example only shows domain matching and fallback behavior; example.com is a documentation domain. If a rule does not take effect, first confirm that this configuration is enabled instead of adding more copies of the same rule. Also check whether the actual request uses a different domain.

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

The basic Global Routing options are Config, Proxy and Direct. Scene organizes selections by scenario; it is not a rule policy. For website-specific routing, check Config first. To determine whether a rule is the issue, compare different modes using clear test conditions. View proxy mode details →

First connection / steps

From subscription import to connection test

These steps assume you already have a subscription or server details. Establish a basic working connection before adding rules or automatic connection conditions; check the result at each step.

  1. Add Server / Subscribe: import details

    For a single server, use Add Server and enter Host, Port and the authentication fields required by its Type. To import an existing subscription, follow the Subscribe steps. Get the subscription link from your service provider. Copy it in full and check that no trailing parameters are missing. A QR code and manual entry are just different input methods; neither changes the remote server's status.

    After saving, return to Home and confirm that the expected entry appears in the SERVER group, then select the server to test. If no entry appears after import, check the input format and subscription update result before editing rules. Add clear notes to multiple subscriptions to make later updates, migration and removal easier. For entries with the same name, compare their addresses and groups, not just their display names.

  2. Global Routing: choose how connections are handled

    To route traffic using a configuration, select Config and check which Config file is active. Proxy sends connections handled by the client through a proxy, while Direct connects directly; these modes serve a different purpose from matching individual Rule entries. To proxy only specified websites, you generally need specific domain rules and an appropriate FINAL fallback, rather than simply changing servers.

    For your first setup, use a clear, understandable configuration and avoid importing multiple rulesets from unknown sources at once. Before making changes, back up the configuration and check the match order one rule at a time. PROXY, DIRECT and REJECT in the example are policy keywords and must not be translated. example.com is a documentation domain used to explain syntax, not a connection service address.

  3. Home / Connectivity Test: connect and check

    Return to Home and turn on the connection. When the system first asks to configure a VPN, review the prompt and follow the system authorization flow. Authorization does not mean the remote connection is working: run Connectivity Test, then visit the website you want to test. Keep the test network and target consistent to see whether a change had an effect; record Wi-Fi and cellular results separately.

    If the toggle will not stay on, check the system VPN configuration or conflicts with other connections. If the server test fails, check the parameters and service status. If the test passes but a particular website does not open, check DNS, the matched rule and the domain actually used by the site. Change one condition at a time and compare with the original settings. Do not treat automatic reconnects, subscription updates and traffic routing as the same issue.

Consider On Demand only after the connection works. First check whether a manual connection is reliable on the networks you use; then configure automatic conditions. This helps avoid confusion when a connection returns after being turned off or its status changes after switching networks. Before editing rules, keep a working configuration to use as a fallback.

Genuine app check / purchase and use

Shadowrocket facts and verification

Shadowrocket is a closed-source commercial app. This is the official website and guide, with access, setup and troubleshooting instructions by device. Check the app's identity, purchase record and network service separately.

  • Developer: Shadow Launch Technology Limited
  • App ID 932747118
  • iPhone / iPad $2.99 one-time · other platforms free
App identity

Check the developer, icon and app ID together

On the App Store product page, check that the developer is Shadow Launch Technology Limited, then verify the official icon and app ID 932747118. The official artwork has a white background with a blue-violet outlined rocket. A name or short label in search results alone does not confirm that you have the right listing. Use the product details page as your reference, not search ranking or similar keywords.

Descriptions, colors and icons for similarly named apps can look alike, so check all three details together. If the price or page information does not match what you expect, confirm the product identity and storefront. For computers and Android, start from this site's download page and select the matching platform and architecture; do not use a mobile store listing as the installer source for another system.

How to verify the genuine app →
Storefront and region

If it does not appear, check the account region first

App Store availability for iPhone / iPad depends on the storefront associated with your account. If the app is unavailable in the mainland China storefront, repeatedly trying Chinese or English keywords usually will not change the results. First check the region of the account used for the App Store, then review the system's requirements for changing regions. Device language, device region and App Store account region are separate settings.

Changing regions may affect your balance, active subscriptions and payment details. Review the specific conditions shown for your account before making a decision. Changing the device language does not change the account region, and search results alone do not mean the device is incompatible. Check the App Store page for system requirements and verify compatibility on your device before purchasing.

Storefront and region details →
Purchase and restore

Two access options; check purchases when changing devices

The iPhone / iPad version costs $2.99 as a one-time purchase in the US App Store storefront; other storefronts show local currency. Mac, Windows, Android and Linux versions are free. iPhone and iPad share one purchase. When changing devices or reinstalling with the same purchasing account, check your purchased items first rather than treating each device as a new purchase.

If the product page shows a purchase price again, first confirm that the current App Store account is the one used for the original purchase, then check your purchase history and the app identity. Your iCloud account may differ from the account used for App Store purchases, so do not rely only on the account name at the top of system settings. After restoring the client, check existing subscriptions, configuration files and required permissions again; purchase history does not restore connection details.

Device migration and reinstall instructions →
Client and network service

Buying the client does not include a network plan

The client reads server details, establishes connections and processes requests according to rules. Getting the client does not create server addresses, account credentials or subscription links; get subscription links from your service provider. This site does not provide, sell or recommend nodes or subscriptions. Before starting the guide, prepare connection details you are authorized to use.

The client purchase record, service provider account and remote server status are independent. For expired subscriptions, authentication failures or remote maintenance, check the relevant service information; buying the client again will not fix them. When troubleshooting, identify whether the issue occurs during import, connection or rule matching. Remove personal credentials from screenshots and logs before finding the relevant section by symptom.

Subscription and connection FAQ →
App updates

Update the client and subscription separately

Manage client updates for iPhone / iPad through the App Store. For Mac, Windows, Android and Linux, get the appropriate platform's latest installer from this site's download page. Keep your current configuration and essential connection details before installing, especially when changing architecture, system or device. App files are not configuration backups.

A Subscribe update only refreshes server content provided by that address. It does not update the client and may not change rules in Config. If something behaves differently after an update, check whether the selected server or configuration changed, then repeat a test you could previously reproduce. Recording the steps that led to the issue is more useful than simply saying “it stopped working after an update.” Remove sensitive information before sharing your notes.

Troubleshoot issues after an update →
Configuration and data

Check the source before importing; remove credentials before sharing

Subscription URLs may contain access parameters, and configurations may include server addresses and authentication details. Treat them as personal connection information before sharing. Even when sharing only a QR code or an error screenshot, check the address bar, group details and full logs to avoid disclosing usable credentials.

Rules affect how traffic is handled. Before importing a configuration, understand its main contents, especially FINAL, DNS and other settings that change connection behavior. Keep the original file before editing, use a recognizable name for backups and check which items are active after restoring. iCloud sync can transfer configurations between supported devices, but verify the sync result before changing devices; enabling sync does not guarantee that all information is available on the new device.

Configuration backup and migration →

Practical guides / scenarios

Configuration migration, subscription management and website-specific routing

Once the basic connection works, continue with the guide that matches your situation. Articles use actual settings and rule syntax, explaining the prerequisites before the steps and checks.

View all articles →