Shadowrocket Official Manual Access · Setup · Connection

Shadowrocket User GuideAll-Platform Access & Rule Setup

Cross-platform rule-based proxy client with subscription import and rule routing.
iPhone / iPad: $2.99 one-time purchase from the App Store; Mac, Windows, Android, and Linux versions are free.

Current version See the download page · Mac, Windows, Android, and Linux versions are free; iPhone / iPad: $2.99 one-time purchase from the App Store

First-time setup: import and connect →
Global Routing / Config · Proxy · Direct Subscribe / Import and update [Rule] / Match from top to bottom
How to read the configuration

Rules in sequence: from servers to connection policy

Add a working server first, then choose rules and connection conditions. Select a topic to view its settings.

Rule order determines where connections go

In Global Routing, select Config mode to process connections according to the rules in the active configuration file. Rules are checked from top to bottom; processing stops at the first match. PROXY routes through a proxy, DIRECT connects directly, and REJECT blocks the connection. Put specific domain rules before broad rules, and place FINAL at the end to handle everything else. The example on the right blocks a specified subdomain before matching the parent-domain suffix, so a broad rule above cannot override the exception below. After editing, save the file, confirm it is enabled, and verify the actual result.

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

App purchase ≠ service plan; get nodes and subscriptions from your own provider.

First connection

Shadowrocket: a quick-start sequence

The steps below use the iPhone / iPad interface labels. Complete the basic connection flow first, then add custom rules. Avoid changing servers, modes, and DNS at the same time before diagnosing a problem.

  1. Add Server / Subscribe: enter existing details

    Prepare your existing server parameters or subscription URL; get subscription URLs from your provider. Add an individual server through Add Server: select Type first, then check Host, Port, and authentication fields. Import subscriptions through Subscribe. When importing with Scan QR Code or the clipboard, check the result for any additional parameters required by the protocol. A successful import only means the details have been saved; it does not guarantee that the server is currently reachable.

    Label multiple subscriptions separately rather than identifying them only by server name. After the first import, test one entry before organizing the list. If the list is empty, return to Subscribe and check whether the URL was copied in full and the update request succeeded. The server management manual also covers updating, sorting, deleting, and backing up entries; it is useful to read after the first connection.

    Subscription and server management →
  2. Global Routing: choose Config / Proxy / Direct

    Config mode uses the active configuration file to determine where connections go. Proxy mode routes connections through the selected proxy. Direct mode uses a direct connection. For everyday rule routing, select Config and check which file is active. If you temporarily switch to Proxy to troubleshoot a rule, note the original mode and restore it when testing is complete. Changing modes does not fill in missing passwords or change the protocol supported by the server.

    When reading rules, check specific exceptions first, then broad matches, and FINAL last. If a subdomain should be REJECT, put that rule before a parent-domain PROXY rule that could match it. The configuration shown on this page demonstrates keywords and line structure; it is not a general-purpose file to replace your existing configuration. Adjust the match order for your own destinations before use.

  3. Home: connect and verify access

    Return to Home, confirm the selected server and Global Routing mode, then turn on the connection switch. When the system prompts you to add a VPN configuration for the first connection, review the system notice and grant permission. Run Connectivity Test, then visit a destination you actually need. The VPN status shown by the system and whether a destination is accessible are separate checks; an enabled switch alone does not mean troubleshooting is complete.

    If all servers fail, first check whether the device itself can access the internet, then verify the system time and shared parameters. If only one entry fails, compare its protocol fields. If the test succeeds but a particular destination fails, check the active rules and DNS. Narrowing down the scope is more effective than repeatedly importing all your data. Before sharing diagnostic information, remove subscription URLs, passwords, and other sensitive details.

Read the complete user guide →
2 access options

Choose a device to visit the all-platform download page

iPhone / iPad: $2.99 one-time purchase from the App Store; Mac, Windows, Android, and Linux versions are free. Desktop, Android, and Linux installers are available from this site's download page at /dl/shadowrocket/.

These links go to the section for each platform, where you can check the device architecture, access method, and installation notes before choosing a file. Your current device is listed first; you can also select another platform manually.

iPhone / iPad

App Store: $2.99 one-time; other platforms are free.

Get the app from its App Store product page. Check the system requirements listed on the App Store page. Before buying, verify the store account, developer, and app ID. If you have already purchased it, check your purchases before reinstalling. iPhone and iPad can share a purchase under the same account.

Mac

Free · Apple Silicon / Intel; iPhone / iPad: $2.99 one-time purchase from the App Store.

Check About This Mac for the chip or processor, then choose the matching installer. Do not guess the architecture from the device's appearance. If macOS blocks the first launch, follow the download page instructions in Privacy & Security. Confirm the file is from this site before continuing. Keep your current configuration data before updating.

Windows

Free; iPhone / iPad: $2.99 one-time purchase from the App Store.

The download page provides a 64-bit Windows installer. If SmartScreen appears, confirm the file is from this site, then select “More info → Run anyway” to continue. Import your own server details after installation. Installing the app and configuring a subscription are separate steps; reinstalling does not replace checking the parameters.

Android

Free · arm64; iPhone / iPad: $2.99 one-time purchase from the App Store.

Use the Android installer provided on this site's download page. If Android requires permission to install unknown apps, allow it only for the browser or file manager you are using, and turn it off again afterward if desired. If the in-app browser cannot download the file, open the download page in your system browser and follow the instructions.

Linux

Free · deb / rpm / AppImage; iPhone / iPad: $2.99 one-time purchase from the App Store.

Choose a package format based on your distribution and usual software management method. Avoid mixing commands from different package systems. AppImage needs executable permission before it can run; installation methods and commands for deb and rpm are listed on the download page. Verify a basic connection before moving more complex rules into your setup.

View all platforms →
Product verification and usage notes

Verify the product before getting it; prepare details before connecting

Shadowrocket is a closed-source commercial app. This is the official site and manual, with separate guidance for platform access, system permissions, and subscription management so that app purchases, server details, and network connections are not confused.

01 / Verify three details in the App Store

Open the product page and check the name Shadowrocket, the developer Shadow Launch Technology Limited, and app ID 932747118. Compare the official icon as well; do not rely only on a name or similar image in search results. The app ID is shown in the product page URL, and developer details should be checked on the product page. System requirements are as listed on the App Store page; confirm your device meets them before purchasing.

Mac, Windows, Android, and Linux use a different access method from mobile app stores: choose the relevant platform on this site's download page. Installers are provided through /dl/shadowrocket/. If the system blocks the first launch, read the prompt and follow the platform-specific instructions; do not disable all system protections as an installation step.

02 / Store visibility depends on account region

If Shadowrocket does not appear in the mainland China App Store, first check the country or region for the Apple ID used for Media & Purchases. Device language, the region shown in system settings, and the store account region are separate settings; changing the device language does not change the store account. Before changing the account region, follow the system prompts about account balance, active subscriptions, and payment details. The requirements shown on your account page determine whether you can change it.

Do not install a similarly named listing just because search returns no results, and do not treat store visibility as a client connection issue. Store access comes before installing the app; connection troubleshooting applies after the app, server settings, and network are in place. The blog article about store regions explains where to check and what to consider before making changes.

Store regions and visibility →

03 / Two price tiers and restoring a purchase

In the US App Store, iPhone / iPad costs $2.99 as a one-time purchase; other storefronts show local currency. Mac, Windows, Android, and Linux versions are free. On iPhone and iPad using the same purchase account, you can restore the app from your purchase history. If the product page still shows a price after changing devices, check the account and purchase history before paying again.

Handle app updates and server updates separately. Update the iPhone / iPad app through the App Store; get new desktop, Android, and Linux versions from this site's download page. Subscribe updates subscription contents, not the app. Before reinstalling or updating, keep local configuration and necessary server details. Afterward, confirm the current selection instead of only checking whether the app opens.

Device migration and restore steps →

04 / App purchase ≠ service plan

The client stores servers, establishes connections, and applies rules; destinations depend on your existing server details. Get subscription URLs from your provider. This site does not provide, sell, or recommend nodes or subscriptions, and an app purchase is not proof of a network service. If the server list is empty after purchase, that does not mean the purchase failed; use the manual to import your own details.

Subscription URLs may contain access credentials. Remove the full URL, passwords, and identifying details before sharing screenshots, configuration files, or diagnostic records. A reproducible description of the error, selected mode, and testing sequence is enough to help narrow down the issue. Read rule files as well: check for unwanted routing or blocking conditions before enabling them rather than treating the entire configuration as an attachment that needs no review.

05 / Choose the next section by symptom

If you have a subscription but do not know where to add it, start with Subscribe and import in server management. If the switch is on but sites remain inaccessible, follow the verification steps in the user guide. If only some destinations fail, check Config match order and Global Routing. This separates three issues—nothing imported yet, an unavailable server, and different rule handling—without requiring you to delete and reinstall the app each time.

When reporting an issue, include the network type, whether all servers fail, the Connectivity Test result, and the adjustments already tried. Change one condition at a time during testing, then restore the original setting. The FAQ groups guidance by product verification, downloads and installation, subscription import, and rule troubleshooting. For specific fields, use the current app interface and your existing server details as the reference.

Troubleshoot by issue →
Developer Shadow Launch Technology Limited App ID 932747118 iPhone / iPad $2.99 one-time · Mac / Windows / Android / Linux free
Topic guides

Connection permissions, protocols, and advanced rules

After your first connection, explore these guides as needed. The three articles below explain the system VPN configuration prompt, Hysteria2 transport characteristics, and custom rule order. Each focuses on one question and does not replace checking your active configuration field by field.

View all articles →