APP STORE · RULE-BASED PROXY CLIENT

Shadowrocket User Guide Rules & Routing, Subscription Import

Download on the App Store View the Guide

A rule-based proxy client for iOS / iPadOS, purchased through the official App Store as a one-time purchase. Prepare your existing subscription or server details, then follow the steps to import them and connect.

DEVELOPER: SHADOW LAUNCH TECHNOLOGY LIMITED · AVAILABLE ONLY ON THE APP STORE

Check rules and connection settings separately

Server details determine where you connect; the configuration determines how requests are handled. Check both before adjusting automatic connections or day-to-day settings.

Rules & Routing: Route by Domain

To route specific websites through a proxy, open Config and check the active configuration. Place the relevant rules before FINAL. DOMAIN matches an exact domain, while DOMAIN-SUFFIX matches the domain and its subdomains; don't treat them as interchangeable just because their names look similar. Rules are generally evaluated in order, and the first match determines the policy. After editing, save the configuration and make sure it's selected, then visit the target site and check the request log. Adding a rule without switching to the intended Config may not produce the routing you expect.

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

Global Routing: Choose How Traffic Is Handled

Global Routing on Home selects how traffic is handled overall. Config routes traffic according to the active configuration's rules, Proxy handles traffic through a proxy, and Direct sends traffic directly. These modes are not server protocols and do not fill in server details. To check whether a rule matches, select Config first. To determine whether an issue is with a rule or the proxy connection, compare modes only when you know what each test is meant to establish. The interface option Proxy is distinct from PROXY in a rule; read settings and rules accordingly.

Global Routing

ConfigProxyDirect

On Demand: Connect Based on Conditions

On Demand starts connections when configured conditions are met. Set it up only after you've verified a manual connection. In Settings, review the On Demand options and decide which network conditions should trigger a connection, then check what happens after enabling them. On Demand controls when to connect; it doesn't replace the Global Routing choice or fix invalid server details. If the connection behaves unexpectedly after a network change, check the trigger conditions and the system VPN status first. Avoid changing several settings at once, so you can identify what affected the result.

Settings → On Demand

Multiple Protocols: Import Using Existing Details

Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard use different parameter formats. When entering details manually through Add Server, select the correct Type first, then check the address, port, and any authentication or transport parameters required by that protocol. Don't reuse fields from one protocol for another. An existing subscription can import multiple server entries, but successful import only means the content was recognized; it doesn't guarantee that every entry can connect. Choose the protocol to match your existing server configuration rather than guessing from its name or a test result.

ShadowsocksVMessVLESSTrojanHysteria2WireGuard

Subscriptions, Data & iCloud: Manage Sources, Usage & Sync Separately

Subscription updates and configuration updates serve different purposes. A subscription update usually refreshes server entries, while a configuration update may change rules and policy assignments. Treat existing subscription URLs as private connection details; don't post a full link publicly when troubleshooting. After an update, check what changed and confirm that the selected server still meets your needs. Before updating, also check whether your manual edits could be overwritten.

Data shows traffic information recorded by the app. It can help indicate whether requests were made, but traffic totals alone can't confirm that a website was routed as intended. For iCloud sync, check the enabled status and sync scope in the app, then review each item after switching devices rather than assuming purchase history restores all settings. Purchases, sync, and connections are separate processes; checking each one can prevent repeated work. For more detail, see Features & Settings and the Rules Manual.

iPhone & iPad: Start on the App Store

Get the app only from the App Store. Check the App Store listing for system requirements and supported universal purchases.

iPhone

Verify the app on the App Store before purchasing. The first time you open it, import your existing server details, then follow the system prompts to authorize the VPN configuration when you connect. System authorization lets the app establish the required connection; it doesn't enter server details for you or confirm that a website is reachable. When finished, return to Home and check the selected server, Global Routing, and connection switch in that order.

View iPhone setup instructions →

iPad

On the App Store, check your purchases using the Apple ID used for the original purchase. Check the listing for information on universal purchases for iPhone and iPad. The larger display doesn't change the basic order for importing and routing; follow the English setting names shown in the current interface. If you have a configuration on another device, check that sync has completed and verify this device's system authorization and connection status again.

View iPad setup instructions →

Shadowrocket is also available from the same App Store on Mac and Apple TV; check the listing for compatibility details.

View setup steps →

First Connection: Three Checks

These steps assume you already have your own subscription or server details. Change one setting at a time to help pinpoint any failure.

01 · Import an Existing Subscription or Add a Server

Get your subscription link from your service provider. Check that it's complete and still valid, then use the supplied details to select the correct Type in Add Server and save. When entering details manually, check Host, Port, and authentication parameters one by one. If you have a QR code, use Scan QR Code if its contents are supported. Don't confuse a configuration URL with a server subscription URL; they may contain different information and use different import options.

After saving, return to Home and check that the expected entry appears in the SERVER group and that the correct server is selected. A name is just a label for identification; it doesn't prove that the protocol is correct or the connection works. If no entries appear after import, check the link and import type first rather than immediately changing Global Routing. See the subscription import guide for the full steps.

Read the full guide →

Verify the App Store listing and purchase details one by one

Shadowrocket Reviews & Official Manual is the official website and manual for Shadowrocket. Check the App Store for purchase details and the app's current settings for configuration behavior.

  • Developer: Shadow Launch Technology Limited
  • App ID 932747118
  • One-time purchase on the App Store

Check the developer, icon, and App ID

A similar app name in search results doesn't mean you've found the same app. Open the product page and check the developer, Shadow Launch Technology Limited; the official icon, matching the one in this site's header; and id932747118 in the URL. The app name helps you find it, while the App ID identifies the specific product; check all three. Before purchasing, review the current listing's compatibility and price rather than relying only on search snippets or an old page.

Shadowrocket is a closed-source commercial app. Refer to the App Store product description and details available in the app for information about features, protocol support, and settings. This site doesn't list version numbers or release dates; check the App Store listing's update history for current release information. Updates are also delivered through the App Store. If a setting moves after an update, look for it by its English name in the interface.

The purchase covers the app, not a connection service

Buying the app ≠ buying a service plan. The US storefront price is about $2.99 as a one-time purchase. Prices are shown in each storefront's local currency; check the App Store listing for the amount you'll pay. The purchase grants the right to use the app; it doesn't create a server, subscription link, or working connection details. This site doesn't provide servers or subscriptions; it explains how to import and configure information you already have.

Before purchasing, make sure you already have the connection details you need. You can still read the manual to learn about the app, but installing it doesn't mean all the requirements for connecting are in place. Subscription validity, server details, and connection availability are managed separately from the app purchase. When troubleshooting, first identify whether the missing piece is the app purchase record, configuration, or working server details.

Check App Store Availability and Account Region Separately

Whether the app appears in the App Store, which currency is shown, and which payment methods are available depend on your current store account and storefront. On the product page, confirm that the signed-in account is the one you intend to use or used for the purchase. If search results differ from the product link, check the storefront and compatibility first; a missing search result alone doesn't mean your purchase record is invalid.

Check the App Store listing for universal purchases on iPhone and iPad, compatibility with other devices, and system requirements. This manual doesn't assume that availability on one device means the same on every device. Before changing your account region or payment details, read the system prompts and consider how the change could affect existing purchases and account balance.

Restore Your Purchase, Then Your Configuration

After getting a new device or reinstalling the app, use the Apple ID from the original purchase to open App Store purchase history, find Shadowrocket, and download it again. The name or location of the purchased-items section may vary by system interface; follow what you see on your device. If you see a price instead of a redownload option, check the account and purchase history before paying again. See how to restore a previous purchase.

Redownloading the app doesn't restore your servers or rules. After installation, check iCloud sync or reimport a configuration you saved, then verify the server, Global Routing, and system VPN authorization. Test a manual connection before restoring automatic behavior such as On Demand. Handling purchase restoration and configuration restoration separately makes it easier to find what's missing.

Browse by task: Find the right guide

Follow the full workflow for a specific task, from restoring a purchase and choosing a mode to routing selected websites.

View all articles →

Download Shadowrocket from the App Store