Cross-platform client · Official manual

Shadowrocket Setup guide

Cross-platform rule-based proxy client: import an existing subscription and route traffic by destination with rules. iPhone / iPad: $2.99 one-time purchase through the App Store; Mac, Windows, Android, and Linux versions are free.

Current version Loading · iPhone / iPad: $2.99 once; Mac, Windows, Android, and Linux: free

VLESSHysteria2Global Routing

Choose a device to get Shadowrocket

Two ways to get it: iPhone / iPad via the App Store for a one-time $2.99 purchase; Mac, Windows, Android, and Linux versions are free. Check your system and processor, then follow the matching installation steps on the download page.

Desktop and Android installers are available from this site at /dl/shadowrocket/. A mobile-store purchase record is not an installation credential for a computer. Mac Apple Silicon and Intel use separate installers; check the processor information shown by your device, not the browser name. For Linux, check your distribution's package management system before choosing deb, rpm, or AppImage.

If the system blocks the first launch, Windows may offer “More info → Run anyway” after you verify the source; on Mac, check “Privacy & Security” and select “Open Anyway”; on Android, check which app has permission to “Install unknown apps.” The installation guidance table covers other prompts and commands, so installation permissions can be handled separately from connection configuration.

Read the installation guidance · See all platforms →

Configure Shadowrocket
with rules and connections

First, distinguish server details, configuration files, and the connection switch. They determine where to connect, how requests are routed, and when to enable a connection.

[Rule]
DOMAIN-SUFFIX,ad.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

Rule routing assigns different policies to different destinations. In Home, select Config under Global Routing. Requests are checked against the active configuration from top to bottom, and processing stops at the first match. PROXY sends the request through the proxy, DIRECT connects directly, and REJECT blocks the request. Put specific domains before broader matches and place FINAL at the end for requests with no earlier match. When troubleshooting, first confirm which configuration is active, then check request records; editing a file alone does not switch to it.

What Global Routing and the connection switch control

The three common Global Routing modes are Config, Proxy, and Direct: Config follows configuration rules, Proxy routes applicable requests through the proxy, and Direct connects without the proxy. The connection switch determines whether the client's network connection is enabled. Selecting Proxy does not mean the server is reachable, and selecting Config does not mean a rule will match; check the current server, active configuration, and destination request. Other options depend on what the app displays.

Before making a change, identify the goal: to use a different policy for one domain, check the rules; if all proxy requests fail, check the server and protocol parameters first; if the connection resumes automatically after a network change, check On Demand. Following this order makes it easier to identify the cause than changing several settings at once. For keyword definitions, read the glossary; for a specific symptom, follow the steps in the troubleshooting manual.

First-time setup

From an existing subscription to a verified connection

The steps below use interface terms such as Home, Add Server, and Config. Entry points may differ by platform. Identify the information type first, then find the matching action; do not treat subscription updates and configuration switching as the same step.

  1. Add a server or import an existing subscription

    Prepare subscription or server details from a service you already use. For a single connection, select Type in Add Server and enter the details manually, or use Scan QR Code or clipboard import as appropriate. Check that copied content is complete, especially its beginning, end, and authentication parameters. A webpage URL entered as a subscription URL usually will not produce the expected server list. After importing, check the entries and groups, then select a server to test.

    When entering details manually, check Host, Port, Password, and the transport and TLS parameters for the relevant protocol; confirming only the address and password is not enough. If a subscription update fails, keep the current working configuration and check whether the link has expired, whether the network can access it, and whether the response has the expected format. This site does not provide, sell, or recommend nodes or subscriptions; importing always relies on information you already have.

  2. Select Global Routing and the active configuration

    For everyday rule-based routing, select Config and confirm the active file on the Config page. Rules run in order, so the placement of domain rules, IP rules, and the final policy can affect the result. If a destination that should connect directly is routed through the proxy, first check whether an earlier rule matched instead of immediately adding another broad rule. Record temporary test changes and restore the original settings when finished.

    Proxy and Direct can help narrow down an issue, but they do not replace a long-term rule design. For example, if the server is reachable but only some destinations behave unexpectedly, compare results in different modes, then check destination resolution and rule records. example.com in the examples is only for explaining syntax; it is not your server or a subscription source. If you are unsure about a policy name, read its definition before changing FINAL.

  3. Enable the connection and verify real requests

    For the first connection, allow the VPN configuration when prompted by the system, then return to the client and check its connection status. Run Connectivity Test with the selected server, then visit a destination you actually need and confirm that its page loads. A VPN status shown by the system only indicates that a related connection has been established; it does not by itself confirm that the server, DNS, rules, and destination website are all working.

    If a request times out, check the current network, server parameters, system time, and service status in order. If only some sites fail, check the rules and DNS first. When switching between Wi-Fi and mobile data, keep other settings unchanged so you can compare results. Diagnostic records may include domains or personal configuration details; remove subscription authentication parameters, passwords, and unrelated personal information before sharing.

Read the complete guide →

Product and download details

Verify the product, distinguish the client from network service

Shadowrocket is a closed-source commercial application. This is the official website and manual. Download instructions vary by platform, while connection guidance is based on configurations you already have.

App ID 932747118 Two ways to get it iPhone / iPad: $2.99 once · Other platforms: free
Official Shadowrocket App Store icon

To verify the icon, also check the developer and App ID, not just the name.

On the App StoreView Shadowrocket

iPhone / iPad: $2.99 once; Mac, Windows, Android, and Linux versions are free.

Developer, official icon, and App ID

On the App Store product page, check the developer name Shadow Launch Technology Limited, then compare it with the official icon and App ID 932747118 on this page. The App ID in the product page URL is a more reliable way to identify the app than its position in search results; similar names do not mean the same app. Get the computer and Android versions from this site's download page; installers are available at /dl/shadowrocket/. Do not use same-name files from other pages as proof of identity.

Store availability and account region

Search results for iPhone / iPad depend on the store region associated with your Apple Account. The app may not appear in the mainland China store, and opening the product page directly may show that it is unavailable in your region. Check your account region and current store first; not finding it in search does not mean there is no version for your device. If you need to change regions, read the system notices about balance, subscriptions, and payment methods before proceeding. See the App Store page for system requirements.

Purchases, reinstalling, and restoring on a new device

iPhone / iPad: a one-time $2.99 App Store purchase covers both device types; Mac, Windows, Android, and Linux versions are free. The store may show local currency based on region; check the product page for the actual price. After moving to a new phone or tablet, use the original purchase account to check your purchased items, then download again. Restoring the app and restoring personal configuration are separate tasks: reinstalling does not automatically restore existing subscriptions, server parameters, or rule files. Check backups and sync content separately.

Buying the client does not include a network service plan

Purchasing the client grants the right to use the app; it does not automatically provide a connectable server, subscription link, or traffic allowance. Network availability, credential validity, and server parameters depend on the service you already use. If the app opens but the list is empty, return to the import steps. If an imported entry reports an authentication error, check your service details. This site does not provide, sell, or recommend nodes or subscriptions; the manual only explains how to import and manage information you already have.

Other platforms and future updates

Mac has separate Apple Silicon and Intel installers; Windows, Android, and Linux have their own formats. iPhone / iPad require a one-time $2.99 App Store purchase; the other platforms listed here are free. Do not mix up download methods between platforms. App updates for iPhone / iPad are handled through the App Store. Desktop and Android users can check dynamic version information and get new releases from this site's download page. Keep your current configuration before updating, verify the existing connection afterward, and then adjust any new settings.

For pricing, store regions, purchase restoration, or system installation prompts, see the download page's product verification guide. Configuration file sources, remote update behavior, and credential protection are separate parts of setup and should be handled independently from product verification. Confirming the installation source does not mean every imported file is suitable for your device.

How it works and how to use it

Shadowrocket topic guides

Choose an article based on the issue: start with importing and connections, then learn about transport requirements and rule priority. Protocol examples explain how fields relate; they do not provide usable server details or guarantee speed on any network.

View all articles →

Free download of Shadowrocket