Skip to content

Official Manual · All Platforms

Shadowrocket Guideand Subscription Management

An all-platform rule-based proxy client for importing existing subscriptions and routing traffic by rules. iPhone / iPad: $2.99 one-time through the App Store; Mac, Windows, Android and Linux versions are free.

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

  • Subscribe
  • Global Routing
  • On Demand
Official Shadowrocket Home screenshot showing the connection switch and Global Routing settings
Shadowrocket · Home

Configuration & Connectivity / Feature Index

From Existing Configuration to Rule-Based Routing

First distinguish servers, subscriptions and Config: a server provides the parameters needed for a connection, Subscribe updates server entries, and Config determines how connections match rules. Choose guidance below by task. Examples illustrate syntax only and do not include a usable service.

Choose Config in Global Routing to match connections against the rules in the active configuration. DOMAIN-SUFFIX is useful for grouping by domain suffix, IP-CIDR describes address ranges, and FINAL handles connections that did not match earlier rules. Rule order affects the result: put specific conditions first, followed by broader ones. Keep a copy of the original configuration before making changes, adjust one group of rules at a time, and check the connection log to confirm the policy actually matched. After switching to Proxy or Direct, the same test results no longer indicate whether Config is correct.

Read the relevant manual section →

Rules are matched in order

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

Illustrative snippet, not a complete configuration ready to use. PROXY, DIRECT and REJECT are policy keywords; REJECT refuses requests based on their connection destination, not page content.

Check Global Routing first, then rule order, and finally the connection path for each policy. Avoid changing servers, DNS and rules all at once, or it will be difficult to identify what caused the change.

On Demand triggers connections when specified conditions are met; it does not mean every request goes through a proxy. First connect manually from Home and confirm that an existing server works. Then check the On Demand conditions in Settings to avoid confusing automatic-trigger issues with server issues. Once enabled, test on your usual network environments and observe the connection state when networks change. To temporarily stop automatic connections, check On Demand as well as the connection switch on Home. Available conditions depend on what the current app version displays.

Read the relevant manual section →

Shadowrocket can manage servers using different protocols, including Shadowsocks, VMess, VLESS, Trojan, WireGuard and Hysteria2. When using Add Server, choose Type based on your existing server details, then fill in the fields shown for that type. Host, Port, authentication details, TLS and transport parameters must correspond to one another; do not apply fields from one protocol to another. If you have a complete share link, import it first and check each field, especially since the address and certificate name may differ. Do not lower verification requirements arbitrarily to troubleshoot a connection.

Read the relevant manual section →

If you already have your own subscription link, select Subscribe in Add Server, paste the complete address, save it, then update the corresponding subscription group. Query parameters in the link may contain access credentials: do not remove them casually or include them in screenshots or public records. After updating, check the group and entries before selecting a server to test. If an update fails, check separately whether the subscription address is reachable and whether existing entries can connect. Use identifiable notes for multiple subscriptions and confirm ownership before deleting anything, so manually added servers are not confused with subscription-generated entries.

Read the relevant manual section →

Config manages rules and other settings; it is not the same as using Subscribe to update the server list. Before importing or editing Config, keep a copy of the currently working file and confirm which configuration will be selected for use. When editing sections such as General, Rule or Hosts, preserve the correct section names and syntax; do not infer a file’s purpose from its name alone. Options related to iCloud sync are shown in the app. Check the contents on both devices before syncing, and keep a separate backup of important configurations. To revert, switch back to the original file and test the same destination to compare results.

Read the relevant manual section →

Connectivity Test shows the results of test requests, Data can help you view traffic changes, and Diagnostics in Settings provides further troubleshooting options. Test values depend on the method, destination and network conditions; they are not a measure of sustained download speed. If a connection fails, first determine whether the subscription update failed, the server connection failed, or only a request to one destination failed. Then check the mode and rules. When reproducing an issue, record the network, Global Routing and error message. Remove subscription addresses, authentication details and unnecessary personal data before sharing records.

Read the relevant manual section →

App Downloads / 2 Ways to Get It

Choose Shadowrocket for Your Device

iPhone / iPad: $2.99 one-time through the App Store; Mac, Windows, Android and Linux versions are free. Desktop and Android installation packages are available from this site's download page under /dl/shadowrocket/. Confirm your platform and architecture before following the download instructions. Do not rely on an installation file name alone to decide whether it is compatible.

iPhone / iPad

$2.99 one-time through the App Store. Other platforms are free. Both devices can be obtained using the same purchasing account; check the App Store page for system requirements.

On the store page, confirm the developer and app ID before completing payment. If you have a previous purchase, check your purchased items first; changing devices does not necessarily mean you need to buy again.

Mac

Free · Apple Silicon / Intel. Open About This Mac and choose the matching version based on the chip or processor information. Do not guess the architecture from the device's appearance.

The download page provides matching entry points for both chip types. If a system security prompt appears when opening the app for the first time, confirm the file came from this site, then follow the installation guidance to review the steps.

Windows

Free. Use the Windows option on the download page and confirm your system architecture and installation requirements first.

If SmartScreen blocks the app, check the source, then review the available options under More info. You do not need to leave system protection disabled. See the download page for detailed installation instructions.

Android

Free. The download page provides an arm64 installation package. Confirm your device architecture first; do not use files for other platforms on Android.

If installation requires permission to install unknown apps, check authorization only for the app used to open the package and revoke it afterward if desired. If an in-app browser cannot download the file, open this site in your system browser instead.

Linux

Free · deb / rpm / AppImage. Choose a format based on your distribution's package manager and device architecture. You do not need to download all three.

AppImage requires execute permission; use the relevant system tool for deb or rpm. The download page includes instructions for each format. Use the actual downloaded file name when running commands.

Pricing in this section: iPhone / iPad costs $2.99 one-time through the App Store; Mac, Windows, Android and Linux versions above are free. Installation prompts and step-by-step guidance are provided on the download page to keep instructions consistent across pages.

Quick Start / Steps

Import, Choose a Mode, Test the Connection

The basic sequence below uses the in-app steps for iPhone / iPad. Before you begin, prepare your existing subscription or server details; downloading the client does not generate a usable server. For your first setup, keep the defaults and original configuration, establish a repeatable connection, then adjust rules gradually.

Add Server / Subscribe: Import Existing Details

Find Add Server in Home. If you have a subscription link, select Subscribe, paste the complete address, save and update it. If you have details for a single server, fill in Host, Port and the relevant authentication fields according to Type. For an existing QR code or share link, use Scan QR Code or the clipboard import option provided in the app.

Do not make multiple changes immediately after saving. First check that the expected group and entries appear in the list, then verify the notes, protocol and address. Subscription links often contain access credentials and should be kept on your own device. When describing an issue to someone else, replace the complete link with an example address to avoid exposing its parameters in screenshots.

Global Routing: Choose Config / Proxy / Direct

Config routes connections according to the rules in the active configuration file; Proxy uses the proxy route; Direct sends connections directly. These three modes control routing and do not fix a server password, an expired subscription address or mismatched protocol parameters.

For everyday rule-based routing, first confirm the intended file is selected in Config, then check Global Routing in Home. To troubleshoot a destination, you can temporarily switch modes when there is a clear test goal. Restore the original setting afterward and note the difference before and after switching instead of changing several options at once.

Home / Connectivity Test: Connect and Verify

Select the server you want to use, turn on the connection switch in Home, and confirm VPN configuration permission when prompted by the system. Then run Connectivity Test and visit the destination you need to check. A connected status means the local connection process has reached the corresponding state; it does not by itself prove that every destination is accessible.

If the test fails, first check whether your regular network is available, then verify the server entry, Global Routing and selected Config. If only some requests fail, focus on rules and DNS; if a subscription update fails, check the subscription address separately. Keeping the network, entry and test destination fixed usually makes diagnosis easier than switching several settings repeatedly.

Verify the Official App / Availability & Purchase Details

Developer, Icon and App ID

Shadowrocket Download is the official Shadowrocket site and manual. Shadowrocket is a closed-source commercial app. To verify the product, check the developer name, official icon and app ID in the store; do not rely on search-result ranking, similar names or promotional images.

Before purchasing, check each product detail

Open the Shadowrocket product page in the App Store. Confirm the name, then check the developer, Shadow Launch Technology Limited. Compare it with the official icon on the left and confirm the app ID in the product link is 932747118. Similar names and icons cannot replace these three checks. If search results are unclear, open the specified product page from the download page and review the store information.

Store availability depends on the account's storefront

This app is currently unavailable in the mainland China App Store. Whether it can be found or its product page opened depends on the storefront associated with the Apple ID, not just the device language or current location. Also check content and privacy restrictions, age ratings and account status. If you need to change the account region, review the balance, subscription and payment requirements in the system account settings; do not repeatedly change device settings to affect search results. Check the App Store page for iPhone / iPad system requirements.

Two price tiers, with different ways to get the app

The iPhone / iPad version costs $2.99 one-time in the US App Store; other storefronts display local currency. Mac, Windows, Android and Linux versions are free. iPhone and iPad can use the same purchasing account's purchase history; the price is not based on the number of servers, and importing a subscription does not require another purchase. Check the final amount on the store's payment confirmation screen. This site does not handle App Store payments or refunds.

Handle device restoration separately from app updates

When replacing or redownloading on iPhone / iPad, first confirm the App Store is signed in with the original purchasing account, then find Shadowrocket in purchased items. If the store still shows a purchase button, check the account and purchase history first. Check for app updates through the App Store. Mac, Windows, Android and Linux users can return to this site's download page for updated installation packages. Keep your configuration and read the relevant platform installation instructions first. App updates and Subscribe updates are separate: one updates the app, the other updates the server list.

Before troubleshooting, answer three questions: Which download source did the app come from? Are the existing server details complete? Does Global Routing match the selected Config? Keep these fixed before investigating an individual request to avoid switching repeatedly between purchase, import and connection issues. If a term is unclear, see the glossary. For a specific error message, see questions and troubleshooting.

Articles / Setup & Troubleshooting

App Store Access and Rule Guides

The full manual explains operation sequences; focused articles address specific issues. The three articles below cover App Store search, the scope of REJECT rules and the purchase process. First identify whether your issue concerns availability, rules or server connectivity.