Official User Manual

Shadowrocket
Guide & Downloads

Shadowrocket is a client for every platform. Import an existing server or subscription, then route traffic using configuration rules.

Current version 2.2.92 · iPhone / iPad: $2.99 one-time; other platforms are free

01 Client Features

Connections, Routing, and Diagnostics

After importing existing server details, test the connection first. Then configure which requests use a proxy and which connect directly. To connect automatically, set up On Demand.

Settings and Checks

Browse by task

How Requests Are Handled

Global Routing

Open Global Routing in Home and select Config, Proxy, or Direct. Config uses the rules in the current configuration; Proxy routes requests through the proxy and can be used temporarily to test a server; Direct provides a direct-connection comparison. For troubleshooting, change only this setting and retest the same destination. If Proxy works but Config does not behave as expected, return to Config and check the matched rule and default policy. Restore your usual mode after testing.

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

First-Time Setup Checks

If you have details for only one server, use the available information to identify its actual protocol, such as Shadowsocks, VMess, VLESS, Trojan, Hysteria2, or WireGuard. Different protocols may use an address and port, but their authentication, transport, and encryption parameters differ. Similar-looking fields are not interchangeable. Import one entry first, confirm that the selected server in the app is the one you intend to test, then turn on the connection switch. If another VPN configuration is already in use on the device, first determine which one is active. A system VPN-connected status only means a connection tunnel has been established; it does not show that a particular request followed the expected rule. Troubleshoot connection and routing issues separately to get reliable comparison results.

Import, connect, and test step by step →

02 Installation

Shadowrocket Downloads for Every Platform

iPhone / iPad: $2.99 one-time purchase on the App Store. Mac, Windows, Android, and Linux are free; get their installers from this site's download page.

iPhone / iPad

App Store · $2.99 one-time

Both devices share the same purchase record. Before installing, check the developer and app ID in the store. When changing devices, first check the account used for the purchase, then see whether a redownload button is available. System requirements are as listed on the App Store page. The first time you turn on the connection switch, watch for the system prompt to add a VPN configuration.

Mac

Free · Apple Silicon / Intel

Open About This Mac from the Apple menu and choose the matching dmg based on the listed chip or processor. Do not guess the architecture from the computer's release date, or assume a package for one chip works for all models. If a verification prompt appears the first time you open the app, check the source and follow the download page instructions.

Windows

Free · 64-bit installer

Check the system type on the About page in Settings, then choose the 64-bit installer. If SmartScreen displays a warning, first confirm that the installer came from this site's download page, then review the specific warning for that file. Devices managed by an organization may have separate installation restrictions; check with the device administrator first.

Android

Free · arm64

Confirm that your device supports arm64, then open the download page in the system browser. The system may ask you to temporarily grant permission to the app opening the installer. Follow the installation instructions, then turn that permission off if you wish. Before updating, check the configuration on the device; deleting the app is not a required update step.

Linux

Free · deb / rpm / AppImage

Confirm the processor architecture first, then choose a format for your distribution: Debian and Ubuntu can use deb, while Fedora can use rpm. To open a file directly, check whether your system meets AppImage runtime requirements. If the package manager reports a missing dependency, read the specific error before trying to reinstall.

View all platforms →

03 Product Verification

Purchases, Redownloads, and Installation Sources

Confirm the right way to get the app for your device, then verify the product identity. If you have already purchased it, check the original purchase record instead of choosing an app from search results again.

  • 2 ways to get the app
  • App ID 932747118
  • Shadow Launch Technology Limited

View the App Store guide →

  1. Check Store Region and App Availability

    Which apps the App Store displays depends on the country or region selected for the Apple Account used to make purchases, not the phone's system language. The product link on this page opens the US storefront; opening it in a browser does not mean the current account can purchase the app from its own storefront. Open Media & Purchases in the account settings and check the current country or region, then review the store's message. If the app does not appear in search results, open the specified product page to see whether it displays product details, says the app is unavailable in your region, or asks you to sign in. These are different situations, not the same issue.

    If you need to change your country or region because of a long-term move, first check your remaining balance, subscriptions, and whether your payment method meets Apple's requirements for the new region. You do not need to change your account just to check a product page. If the product page opens but installation is unavailable, check the purchase account, device storage, and compatibility. System requirements for iPhone / iPad are as listed on the App Store page.

  2. Verify the Developer, Icon, and App ID

    First check that the developer on the product page is Shadow Launch Technology Limited, then compare the official icon: a rocket with a blue-purple outline on a white background. Finally, check that the page address contains id932747118. A similar name or icon alone does not confirm that it is the same app. The device language, storefront, and currency may differ, but the App ID identifying this product should match.

    If you start from a bookmark, search result, or saved screenshot, verify all three details on the product page you open. After viewing the name in a browser, check that the same listing appears when you are redirected to the system store. A similarly named product with a different developer and App ID is not the purchase record described here. Confirm the details before proceeding; search ranking and placement do not establish authenticity.

  3. One-Time Purchase and Redownloading on a New Device

    The iPhone / iPad version costs $2.99 as a one-time purchase on the US App Store; prices on other storefronts may vary. The Mac, Windows, Android, and Linux versions are free. The iPhone and iPad share this purchase under the same Apple purchase account. When changing devices, reinstalling, or downloading on a second device, use the account that originally purchased the app. Open Purchased or the equivalent app list for your current system version on the App Store account page, find Shadowrocket, and download it again.

    If you see a price button instead of a redownload button, first check that the account under Media & Purchases matches the purchase record. Then check that you are viewing the right app record and that the current storefront and device still meet the download requirements. Restoring a purchase retrieves the app; it does not restore in-app configuration, server entries, or connection permissions. Before changing devices, make sure you have saved the configuration you need, then check that it is active on the new device.

  4. Manage App Purchases and Network Services Separately

    App purchase ≠ network service plan. Shadowrocket is a closed-source commercial app that reads configurations, establishes connections, and applies rules. This site does not provide, sell, or recommend nodes, subscriptions, or network services. Use your own existing subscription or server details to connect. Purchasing the app does not include a network service or extend the term of an existing service.

    When troubleshooting, first distinguish whether the app can be installed, the configuration imported, and the server reached. If the app opens normally but a subscription will not refresh, check whether your existing subscription URL is still valid, then check whether the current network can access it. Check server account or permission issues with the relevant service provider; purchasing or reinstalling the app cannot change server-side status. When recording an error, keep the time and error type, but do not include actual credentials.

  5. Installation and Updates for Computers and Android

    Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. The iPhone / iPad App Store version costs $2.99 one-time; this is a separate way to get the app. Computer and Android installers are available through this site's download page at /dl/shadowrocket/. To update, return to the download page and select the package for your device. Do not use a package for another chip architecture or distribution as an update.

    Updates for iPhone / iPad are provided through the App Store. For computers and Android, check the package format and existing configuration before installing a new version. If the system blocks a file, consult the installation and permission instructions and check its source, file type, and reason for the warning. Stop if the source is unclear or the warning differs from the instructions. On organization- or school-managed devices, follow the installation policy rather than changing global device protection settings for one app.

04 Technical Notes

Installation, Permissions, and Reinstallation

Choose an article based on the issue: first identify whether the problem involves the installer, system permission, or purchase record, then follow the relevant steps.

Downloads

Installing Shadowrocket on Linux: Choosing deb, rpm, or AppImage

Filter files by distribution and architecture before choosing an installation method. The article explains installing deb with apt, rpm with dnf, and granting execution permission to an AppImage, as well as where to check when the package format does not match.

If double-clicking the download does nothing, first check whether you downloaded a package for the package manager or an AppImage that can run directly. Once you know which one it is, review the specific system error; you do not need to switch distributions or repeatedly download the same file.

Read the Linux installation guide →

View all articles →