Verify the app · All platforms

ShadowrocketSetup and Usage Guide

A rules-based proxy client for all platforms with subscription import and rule-based routing. The iPhone / iPad version is a one-time $2.99 App Store purchase; Mac, Windows, Android, and Linux versions are free.

Current version v2.2.92 · Mac, Windows, Android, and Linux versions are free

  • Shadowsocks
  • Hysteria2
  • On Demand

Official guide · 2 ways to get the app

Verify the app and restore purchases

App Store developer
Shadow Launch Technology Limited
App ID
932747118
Official app icon
Rocket with blue-purple outline on a white background

View store regions and purchase restoration

Check three details on the product page

When Shadowrocket appears in search results, open its product page and verify that the developer is Shadow Launch Technology Limited. Confirm that the icon matches the official icon on the left, and check that the product page URL ends in id932747118. Similar names and icons are not a substitute for checking the developer and App ID. System requirements are as listed on the App Store page; if you plan to use two devices, check compatibility for each one.

Search results depend on your store region

The App Store catalog varies by the country or region of the Apple Account used for purchases. The device's interface language and your current location do not determine its store region. If you cannot find the app, open the product page from the download guide and determine whether the message indicates unavailability, system incompatibility, or a page that did not load. Check the store region in the settings of the account used for purchases. If the page opens but the download does not start, check available storage and any download restrictions.

Use one purchase on iPhone and iPad

The iPhone / iPad version costs $2.99 as a one-time purchase in the US App Store; currency and price in other storefronts are shown on their local product pages. Mac, Windows, Android, and Linux versions are free. The same purchase can be used on an eligible iPhone and iPad with the same purchasing account. When switching devices or reinstalling, first confirm that you are using the original App Store account, then look for Shadowrocket in purchased items. If a price button appears, check the account and purchase history before deciding whether to proceed.

Manage purchases, configuration, and servers separately

Shadowrocket is closed-source commercial software. A client purchase does not include a server plan: purchase history lets you download the app again, but does not restore servers, subscriptions, or configurations. Get subscriptions from your own service provider; this site does not provide, sell, or recommend servers or subscriptions. Before moving to a new device, make sure you have your own subscription or server details and any necessary configuration backups. After restoring the app, check your configuration, servers, and connection mode one by one.

Use the original source when updating

Get iPhone and iPad updates through the App Store. For Mac, Windows, Android, and Linux, use this site's download guide to select your platform; installers are provided on this site under /dl/. Before updating, confirm the platform and architecture, then back up any rules and configuration you have edited. If connection problems occur after an update, first check whether the original configuration is still selected and the server is still available; there is no need to clear all settings immediately.

Connections, routing, and diagnostics

The server determines where you connect; Global Routing determines the path traffic takes; On Demand determines when a connection is made. Check these separately to avoid changing several settings while troubleshooting one issue.

Rule priority and fallback behavior

In Home > Global Routing, select Config for the client to match traffic against the Rule order in the current configuration. Place entries for individual sites before broader entries to avoid matching an overly broad rule first. FINAL handles connections that did not match earlier rules. If only a particular website behaves unexpectedly, check the domain you actually accessed and the rule order before reviewing the fallback. Use Proxy and Direct for comparison tests, then switch back to Config.

See how to route traffic for specific websites
  • DOMAIN-SUFFIX,example.com,PROXY
  • GEOIP,CN,DIRECT
  • FINAL,PROXY

Three steps to your first connection

These steps use the iPhone and iPad interface. For your first connection, use a known working server and a familiar test website. Establish a repeatable test setup before adjusting rules or automatic connections.

  1. Add an existing server or subscription

    Open Home and go to Add Server. If you have individual server details, enter the Type, Host, Port, and required authentication fields from those details. If you have a subscription, select Subscribe. Get subscriptions from your service provider; paste the complete address and do not share it publicly as if it were an ordinary webpage link.

    After saving, return to Home and check SERVER for an available server. If there is a subscription entry but no server entry, refresh the subscription first. If the list contains entries, select the server you want to connect to before continuing.

  2. Choose Global Routing

    Config uses the current configuration to decide which connections use a proxy, connect directly, or follow another specified policy. Proxy sends traffic handled by the client through the proxy; Direct provides a direct-connection comparison. To route traffic by website, select Config and first confirm in Config that the intended file is enabled.

    To determine whether an issue comes from rules or the connection, keep the server unchanged and temporarily select Proxy to test the same website again. If it works only after changing modes, check the rule order and FINAL first rather than re-entering the server details.

  3. Connect and verify the result

    Return to Home and turn on the connection switch. When establishing a VPN connection for the first time, the system may ask to add a VPN configuration. Confirm that the prompt corresponds to the Shadowrocket connection you just started, then follow the system instructions. Wait for the connection status to stabilize and use Connectivity Test to check the selected server.

    Finally, visit the website you want to check. If the client shows that it is connected but the site still will not open, test other destinations on the same network first. If only one destination has a problem, check routing; if several fail, check the server details, current network, and system connection permission.

Choose a download for your device

The iPhone / iPad version is a one-time $2.99 App Store purchase. Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free; installers are available on this site under /dl/. Each link below opens the platform guide, where you can choose the version for your device.

Common installation and connection questions

Why is the server list missing after switching devices?

Purchased items and server lists are managed separately. After restoring the client, check whether your configuration has synced and whether the correct file is selected. If the server list is still empty, re-import it from your saved server details or subscription. Do not buy the client again just to restore the list.

Why does a website still not open even though the test succeeds?

Connectivity Test checks its test destination, not every domain visited by your browser. Compare with other websites, then check whether the request uses a different domain and whether Global Routing is set to Config. If only one rule causes a problem, adjust the match order first and test again.

What should I check first after switching from Wi-Fi to cellular?

First confirm that the device can access the network. Then manually test again using the same server and mode. If manual connection works but automatic connection does not, check the On Demand conditions in Settings. Change one condition at a time and note the result on each network.

Usage notes

Choose an article for your issue: troubleshoot background battery use, write routing rules for specific websites, or interpret test results for an existing server.