Official ManualGet the App & Configure

ShadowrocketUser Guide

Shadowrocket is a proxy client for multiple platforms. Import existing servers or subscriptions, then use rule-based routing to choose which connections use a proxy and which connect directly.

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

See the first-use steps

  • VLESS
  • Trojan
  • Global Routing

01Platform Downloads

Get Shadowrocket for Your Platform

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

Installation prompts and connection permissions are separate. The system may prompt when installing a file or opening a program for the first time; connection permission appears when the client is about to connect. If installation is blocked, first confirm that the address points to this site’s download path, then check each item in the installation and security prompt instructions for your system. If the file came through a forwarded link, the system prompt differs from the instructions, or the device is managed by an organization, stop and verify the source or device policy. Do not disable device-wide security protections.

02First Connection

Three Steps: Import, Configure, Test

The steps below use the iPhone / iPad interface as an example. Before you begin, have an existing subscription link or server settings ready. Check the result after each step before moving on.

  1. Add a Server or Subscription

    For a single server, open Add Server from Home. Choose Type, then enter the address, port, and fields required by that protocol. To import an existing subscription link, use Subscribe and confirm that an entry appears in the SERVER list.

    A successful save only means the client accepted the settings; it does not confirm that the server is available. For the first test, select one entry. Avoid changing the subscription, settings, and network at the same time, or it will be difficult to identify the cause if the test fails.

  2. Choose Global Routing

    Config routes traffic according to the current configuration’s rules; Proxy sends connections handled by the client through a proxy; Direct connects those requests directly. For everyday rule-based routing, choose Config and confirm which configuration is active on the page with the same name.

    For troubleshooting, compare the results of Proxy and Config for the same test destination. If proxy mode works but rule-based routing does not, first check whether the rules send that destination along the expected route instead of immediately changing server settings.

  3. Connect and Verify

    Return to Home, confirm the server and mode, then turn on the connection. When the system first asks to add a VPN configuration, verify that the request comes from the app you just opened before deciding whether to allow it. If you denied the request, address the system permission first, then try connecting again.

    Use Connectivity Test to check the selected server, then open a test destination you can already access and verify that it follows the expected route. An enabled switch, a server test response, and successful access to the destination are three separate results to check.

03Feature Index

Rules, Configurations, and Diagnostics

Find settings by the issue you want to address. The examples below use the iPhone / iPad interface; check each device’s download and installation steps separately.

Rule-Based Routing

To use different connection paths for different destinations, choose Config in Global Routing, then open the active configuration in Config and review Rule in order. A matched rule can apply PROXY, DIRECT, or REJECT; connections that do not match a preceding rule are handled by FINAL. A broad rule near the top may match before a rule for a specific destination. If the result differs from what you expect, check the destination, rule order, and fallback action before changing the configuration. Retest just one destination after making a change to identify which change took effect.

  • Global Routing
  • DOMAIN-SUFFIX
  • FINAL

04Product Verification

Verify the App and Purchase History

Shadowrocket is a closed-source commercial application. This official site’s manual explains how to get and use the client. When checking the store listing, verify the developer, icon, and app ID together rather than relying on the name in search results alone.

  • App ID: 932747118
  • 2 ways to get it
Official Shadowrocket app icon
Compare with the App Store icon
  1. Check the Developer, Icon, and App ID

    Open the product page from the App Store link on the download page. Confirm that the app is named Shadowrocket and the developer is Shadow Launch Technology Limited. Check that the page icon matches the one shown alongside this text and that the URL ends in id932747118. The icon can help you identify the app, but the name or icon alone is not enough; check the developer and app ID as well.

    The same checks apply if you open the page from search results or history. If any detail differs, return to this site’s download page and open the product page again; there is no need to try installing similar listings. Confirm device and system compatibility on the same verified product page. Refer to the App Store listing for system requirements.

  2. Check Your Account Region and Store Availability

    App Store search results depend on the country or region of the Apple ID used for purchases. The app is not listed in the mainland China storefront. If you cannot find it, open your Apple Account in system settings, go to Media & Purchases account settings, and check Country/Region. The device’s display language and system region are separate settings; changing the language alone does not change the storefront.

    If you already need to change your account region, first check unused balance, active subscriptions, pending items, and the payment requirements for the new region. Do not keep switching regions based on search results before checking these items. Purchase details, purchase history, and product availability are separate and should be verified individually.

  3. Check Your Original Purchase When Reinstalling

    The iPhone / iPad version costs $2.99 as a one-time purchase in the US App Store; prices in other storefronts are shown on their product pages. Mac, Windows, Android, and Linux versions are free. One purchase can be used on both iPhone and iPad with the same purchase account; there is no need to buy separately for each device. When changing devices, first confirm the App Store purchase account, then search for Shadowrocket in your purchased items.

    When you find the listing, reinstall it using the download icon. If the page still shows a purchase button, check that you are signed in to the correct purchase account, opened the same product page, and can access it in the current storefront. After downloading the app, check your configuration, servers, and VPN permission. Restoring the app provides access to the app; it does not restore connection settings.

  4. Separate the App Purchase from Server Access

    Buying the client does not include a service plan. A purchase of the iPhone / iPad version provides the client; the Mac, Windows, Android, and Linux versions are free to get. Neither option includes server details to import. This site does not provide, sell, or recommend servers or subscriptions, or arrange service access.

    If you already have server details or a subscription, import them using the manual. If the app is installed but SERVER is empty, first check whether you completed the add-server steps rather than buying the app again. If the connection has issues after importing, check server availability, your local network, system permissions, and routing selection separately. Identify which layer failed before following the relevant troubleshooting steps.

  5. Get Updates Through the Original Channel

    Check the App Store updates list for available updates on iPhone / iPad, or use the system’s automatic update settings. Download new Mac, Windows, Android, and Linux installers from this site’s download page. For Mac updates, continue to distinguish Apple silicon from Intel; for Linux, choose the package format used by your current distribution. Do not replace an installation with a package for a different platform just because its system name looks similar.

    Before updating or reinstalling, make sure you have kept any configuration and subscription details you need, with a backup in a location you control. After updating, check the active configuration, selected server, and routing mode, then test a destination that worked before the update. Only compare against your pre-update notes if an issue occurs; there is no need to start by clearing system permissions or app data.

05Further Reading

Guides and Practical Tips

Continue with the issue you are facing: check storefront availability first, then work through initial setup. If you already have Trojan settings, go directly to the guide for those fields.