Official Manual · All Platforms

Shadowrocket Setup Guide

Shadowrocket is an all-platform client with rule-based routing. Learn how to import and manage your existing subscription or add a server manually using its protocol.

Current version $2.99 one-time for iPhone / iPad; free on other platforms

Setup and connect step by step →

Shadowsocks WireGuard Global Routing
01 Setup and verification

Import subscriptions and route by rules

A subscription determines which servers are available; configuration determines the route a connection takes. Check in this order to tell whether an issue comes from importing, route selection or the connection itself.

Subscribe: import an existing subscription

In Add Server on Home, choose Subscribe, enter your complete subscription URL in the corresponding field, then save and return to SERVER to view its groups. Keep the query parameters when copying the URL; do not use a single server's sharing link as a subscription URL. If you only have the details for one server, choose Add Server and select the matching protocol, such as Shadowsocks or WireGuard, then fill in the fields for that protocol. After updating a subscription, compare the group contents and check that the previously selected server is still listed.

https://example.com/sub?token=xxxx
03 First connection

Three steps for iPhone / iPad

Prepare your subscription URL or server details. For the first connection, test with just one server and one destination you know is accessible. Once the basics work, add rules or enable On Demand.

  1. Add a server or subscription

    Open Add Server from Home. If you have a complete subscription URL, choose Subscribe. If you only have details for one server, select the matching Type first, then fill in the fields using the information you have. Different protocols require different fields; do not reuse another protocol's port, key or other parameters.

    After saving, check the item on SERVER and select the one you want to test. If the list has not changed, check the information type and whether it was saved successfully. Do not repeatedly import while also changing the routing settings.

  2. Choose Global Routing

    Return to Home and check Global Routing. Choose Config to apply different policies by domain, then confirm in Config that the expected file is active. Proxy uses the selected server and can temporarily remove routing rules from the troubleshooting variables; Direct provides a direct-connection comparison.

    If you have changed rules, note the current file name and prepare a destination that should match a specific rule. Seeing Config selected does not show which rule a domain ultimately matched.

  3. Connect and test access

    Turn on the connection switch on Home. If a system VPN configuration request appears on the first connection, confirm it was triggered by the action you just took before responding in the system interface. When the status changes to connected, run Connectivity Test, then open the prepared destination and record both results.

    If the test returns a result but access fails, first check DNS resolution for the destination domain, then check the matching rule and connection records. For a retest, keep the network and destination unchanged, and change only one setting at a time.

04 Verification and purchase

Verify the app and restore a purchase

Shadowrocket is a closed-source commercial application. Check the product page before purchasing and the original purchasing account when changing devices. Keep subscriptions and local configuration files separately.

Official Shadowrocket app icon
App Store developer
Shadow Launch Technology Limited
App ID
932747118
  1. Check the developer, icon and App ID

    Open the product page using the store button on the download page. Check the developer name, Shadow Launch Technology Limited, then compare the icon with the white-background rocket outlined in blue and purple shown here. Finally, check that the store URL ends with id932747118. Names and icons can look similar; the App ID helps confirm that the current URL points to the same product rather than a search result with a similar name.

    After confirming the product, check device compatibility in the store. See the App Store page for system requirements. The display may differ between a web preview on a phone and the store itself. If you cannot find a purchase option on the web page, check the product and account region in the store.

  2. Check the store region and availability

    App Store search results and purchase options depend on the store region of the current Apple Account, not the device's interface language. If the product page says it is unavailable in your region, check the country or region under Media & Purchases in your account settings. Repeatedly changing search terms will not remove this restriction.

    If you need to change your own account region, first follow Apple's process to check requirements such as account balance, existing subscriptions and payment methods. Before changing devices, confirm which account holds the purchase record, then handle any region change to avoid confusing store availability with using the wrong account.

  3. One-time purchase and restore on a new device

    The iPhone / iPad version costs $2.99 as a one-time purchase in the U.S. App Store. The same Apple Account can use the purchase on compatible iPhone and iPad devices; Mac, Windows, Android and Linux versions are free. In other store regions, see the local price on the product page. App updates are provided through the respective distribution channels.

    When changing devices or reinstalling, first confirm the purchasing account in the App Store, then look for Shadowrocket under Purchased. If the record is available, tap to download it again; there is no need to pay again for the same purchase. If nothing appears, compare the purchase record with the signed-in account, then check the store region and device compatibility. Restoring the app does not restore local servers, rule files or subscriptions.

  4. Separate the app purchase from connection details

    A one-time app purchase is not a connection plan. Purchasing the client provides a license to use the app. To connect, import your existing subscription or enter your existing server details. This site does not provide, sell or recommend proxy servers, subscriptions, or network services.

    Before migrating, keep a separate copy of your configuration and identify which items were added manually and which are updated through subscriptions. Subscription URLs may contain access credentials. Do not include the complete URL, password or private key when sharing troubleshooting details. If you only need to describe an error, include the interface name, time and error text.

  5. Downloads and updates for desktop and Android

    Mac (Apple Silicon and Intel), Windows, Android and Linux versions are free from this site's download page; the iPhone / iPad version is a $2.99 one-time App Store purchase. Before updating the desktop or Android version, back up any configuration you want to keep, then return to the relevant platform page to download the installer again. Do not reuse old links from chat attachments or cached files.

    These installers are not code-signed, so the system may show a prompt on first installation or launch. First confirm the file came from this site's /dl/shadowrocket/ path and that its format matches your device, then follow the platform-specific instructions for handling the prompt for that file. If the source or purpose of the file is unclear, do not proceed; there is no need to disable security checks for the entire device.

05 Topic articles

Installation, DNS and protocol settings

After your first connection works, read the article that matches the issue you are experiencing. If a parameter is unclear, keep your working configuration and check each field against the article.

Protocol guide

Shadowrocket WireGuard Setup: How to Enter PrivateKey, Endpoint and AllowedIPs

Learn how to add WireGuard in Shadowrocket, what PrivateKey, PublicKey, Endpoint, AllowedIPs and MTU mean, and which input mistakes to avoid. If the address is reachable but the destination is not, first check whether the network specified by AllowedIPs includes the destination, then compare both sides' configuration.