A cross-platform rule-based proxy client for importing existing configurations and routing traffic by rules. iPhone / iPad: $2.99 one-time purchase in the App Store; Mac, Windows, Android and Linux: free.
Distinguish servers, rules and connection status before changing specific options. A successful import does not mean the connection works, and a successful connection does not mean every request uses the same policy.
Rule routing determines which policy handles a particular request; it does not provide a server connection. In Home, select Config under Global Routing, then confirm which file is enabled in Config. Rules are checked in order: more specific domain or address conditions usually come first, with FINAL at the end to handle unmatched requests. Proxy and Direct are routing modes with different decision paths from Config. When troubleshooting, check the current mode first, then inspect the matched rule and policy name to avoid mistaking an inactive rule for a server failure.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
On Demand starts a connection when preset conditions are met. Configure it after verifying that a manual connection works. Find On Demand in Settings and adjust the available network conditions, retaining the VPN configuration permission required by the system. It controls when a connection starts; it does not replace request routing in Config or fix invalid server parameters. For first-time setup, connect manually and run Connectivity Test, then observe behavior when switching networks. If connections repeatedly start, temporarily turn off On Demand and check the manual toggle and network link separately.
Settings → On Demand
Home → Connectivity Test
The protocol must match the configuration of your existing server. In Add Server, select Type first, then enter Host, Port and the relevant authentication fields using the information provided. Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard and Hysteria2 use different fields; changing only the type while reusing all other parameters will not work. Transport, TLS and the protocol itself are separate settings. If you already have a complete subscription, import it using the supplied information. For manual setup, check each field and ask your own service provider about missing values rather than guessing from the protocol name.
Add Server → Type → Host → Port
TLS / Transport / Authentication
Subscribe imports and updates your existing server information in one place, which is useful when you do not want to maintain each entry individually. Before importing, confirm the link is complete. After updating, check that the expected entries appear in the group, then select a default server in Home. A successful subscription update only confirms that the data was retrieved and parsed; it does not mean every server can connect. Test connectivity separately. Subscription links may contain private access credentials, so do not post them publicly in screenshots or feedback. If an update fails, first check that the original link is valid and the network is available, then investigate formatting issues. Avoid repeatedly deleting entries that still work.
Subscribe → Update
Home → SERVER → Connectivity Test
Config stores rules and related network settings, while server subscriptions mainly provide connection information. Keep their roles distinct. After importing or editing a file in Config, confirm which file is enabled, then return to Home and check that Global Routing is set to Config. Save the original file before making changes, and adjust one condition at a time so you can compare results. For iCloud sync, check device sign-in, sync scope and the actual file contents; sync completion does not mean the configuration is enabled on another device. Store files containing credentials separately and remove personal information before sharing.
Config → General / Rule / Hosts
Home → Global Routing → Config
Troubleshoot in layers: network, server, rules and the target request. First confirm that the device can access the network, then check the default server and connection toggle. Next run Connectivity Test, and finally inspect the policy used by the specific request. Diagnostics in Settings can help collect clues. Traffic statistics in Data show transmission activity but cannot, by themselves, prove that a website has fully loaded. Results depend on the test target, method and current network, so do not judge a protocol from a single number. When reporting an issue, include the error text and steps taken, but remove private credentials from addresses.
Home → Connectivity Test
Settings → Diagnostics
Data
02 / FIRST CONNECTION
First connection: test before tuning rules
These steps assume you already have your own subscription or server information. Installing the client, obtaining connection parameters and enabling rules are separate tasks; verify each one independently.
01
Import existing information in Add Server
A complete subscription is convenient for importing multiple entries. For a single server, select Type in Add Server and fill in each field. If you import with Scan QR Code, check the type, address and port afterward. A name is only a label for identification; identical names do not mean the parameters are identical. Before saving, check for spaces copied into fields or missing values.
Server entries and Config files are managed separately. If you received a rules file, handle it in Config rather than repeatedly importing it as a server subscription. Keep the original information, and do not change the protocol, DNS and rules at the same time before confirming the connection works; otherwise, it will be harder to isolate the cause.
02
Select a server and Global Routing in Home
After importing, select a default server in the SERVER group in Home, then check Global Routing. Config uses the current file to evaluate requests; Proxy and Direct are modes for different routing needs. To apply rules, confirm both the Config mode and the correct configuration file—neither alone is sufficient.
Next, turn on the connection toggle and approve the VPN configuration permission requested by the system. A connected status only confirms that the relevant connection has been established; it does not guarantee that the remote service or every destination is working. If the system does not allow the configuration to be added, resolve the permission prompt first, then test in the client. Do not keep importing duplicate servers.
03
Verify the connection with Connectivity Test
Run Connectivity Test first, then open the destination you actually need. If the test fails, check the device network, selected server, authentication parameters and service status in that order. If the test passes but a particular request fails, inspect rule matching and DNS resolution. These cases have different troubleshooting starting points; do not begin by replacing the entire configuration.
Record behavior before and after each change, and modify one setting at a time. Restoring a saved configuration is more reliable than trying to remember every previous value. Once the basic connection works, configure On Demand, sync or more specific rule conditions. The full guide explains each step in interface order and covers common issues with permissions, imports and testing.
Two ways to get it: iPhone / iPad is a one-time $2.99 App Store purchase; Mac, Windows, Android and Linux are free. Desktop and Android installers are served from this site at /dl/shadowrocket/. The download guide covers the available files and system security prompts.
iPhone / iPad
$2.99 one-time purchase in the App Store; Mac, Windows, Android and Linux are free. iPhone and iPad share the same app purchase record. Check the App Store page for system requirements.
Before getting the app, check the developer and app ID. For a reinstall, check your purchases first. App availability in the store also depends on the account region; the device or browser language does not change the account's storefront.
Free, with separate Apple Silicon and Intel installers. Open About This Mac before downloading and choose based on the Chip or Processor information, not appearance, purchase year or browser detection.
If the system blocks the first launch, confirm the download came from this site, then follow the Privacy & Security steps in the download guide. If you see an “app is damaged” alert, use the guide's instructions for this app.
Free, with a 64-bit installer. After downloading, confirm the file came from this site's download page before installing. Keep your existing files before importing a configuration so you can check servers and rules during migration.
If SmartScreen appears, confirm the source, then select “More info → Run anyway” to continue. Do not disable system-wide protection just to install the app. Handling installation and the first connection separately makes issues easier to diagnose.
Free, with an arm64 installer. Download it from this site's download page. During installation, follow the system prompt to allow the current download app to install unknown apps. You can revoke that permission afterward.
Installation permission and the VPN permission needed for a connection are separate steps; review each prompt. If the in-app browser cannot start the download, follow the page prompt to open it in the system browser, then download and install.
Free, available as deb, rpm and AppImage. Choose a format supported by your distribution's package manager rather than installing all three. Keep your current configuration before updating so you can continue using your existing rules.
AppImage requires execute permission before its first run; install deb and rpm packages with the relevant package manager. The download guide lists the steps. Use the actual downloaded file name in commands.
Shadowrocket is a closed-source commercial application. This is the official website and manual. Check the acquisition channel, app identity and network service separately; a name or search result alone is not enough.
DeveloperShadow Launch Technology Limited
App ID932747118
iPhone / iPad $2.99 one-time · Mac / Windows / Android / Linux free
01
Check the developer, official icon and app ID
On the App Store product page for iPhone / iPad, check the app name Shadowrocket, the developer Shadow Launch Technology Limited and app ID 932747118 in the product URL. The official icon is a white image with a blue-purple outlined design; compare it with the icon in this site's header. A similar name or prominent search result is no substitute for checking all three details. Confirm the icon together with the developer and app ID.
For desktop and Android, use the installer for the relevant platform from this site's download page. Files are served via /dl/shadowrocket/. Once the browser shows the download is complete, follow that platform's installation instructions to handle system prompts. Do not confuse similar store listings or app names on webpages with the actual source of an installed file.
02
Check your account region to understand App Store availability
This app is currently unavailable on the mainland China App Store. If you cannot find it, first check the region associated with the Apple ID used for Media & Purchases, then see whether the product page opens in that storefront. The device's system language, location and webpage language are not storefront settings; changing those options alone does not determine whether the app can be purchased.
If you need to change your region, follow the country or region process in your system account settings, and review requirements for balance, existing subscriptions and payment methods first. This guide only explains how app access relates to account settings. For iPhone / iPad system requirements, refer to the App Store page rather than inferring compatibility from the device model.
03
Use purchase history to restore the app; save configuration separately
iPhone / iPad requires a one-time $2.99 App Store purchase, shared by both devices through the same app purchase record. Mac, Windows, Android and Linux are free. Storefronts may show local currency; confirm the price on the product page before paying. When changing devices or reinstalling, use the original purchase account to find your purchase and restore the download. This helps avoid mistaking a different sign-in account for a need to buy again.
Restoring the app and restoring its configuration are separate tasks. Check subscription URLs, manually added servers, rule files and sync status independently. Save essential information before reinstalling; afterward, confirm imported content and the currently enabled Config before connecting. Even if files have synced to another device, check the default server and system permissions again.
04
A client purchase is not a network service plan
The client reads your existing server information, establishes connections and applies rules. Installing or purchasing it does not automatically provide a working connection. This site does not provide, sell or recommend nodes, subscriptions or network services. Information needed for import should come from your own service provider or a server you manage. An app purchase record is not a credential for a remote service.
If the list is empty, check your existing subscription or server information. If entries appear but connections fail, check the parameters, service status and device network. Ask your own service provider about an expired subscription, changed address or authentication failure. A rules file can route requests, but it cannot restore an unavailable remote server.
05
Update the app and subscription separately
Update the iPhone / iPad app through the App Store. Mac, Windows, Android and Linux users can get the installer for their platform from this site's download page, then follow the relevant update and system security instructions. The current version on the page is read dynamically from the download manifest; it helps identify an installer but does not mean the app on your device has been updated.
An app update does not update a subscription. Save your configuration before updating. Afterward, check whether your existing servers and rules are still selected, then run a connectivity test. If only one destination has an issue, inspect the matching rule and DNS result before reinstalling. Check the app, configuration, subscription and connection status separately to retain useful troubleshooting clues.
Once the basic connection works, explore protocol parameters, access and pricing, or connectivity testing as needed. Each topic uses interface terms as a guide, explains when the steps apply and provides a troubleshooting sequence.
Compare authentication and encryption, and see how UUID, alterId and transport parameters relate. Choose a Type in Add Server using your existing server information; do not infer speed from the protocol name.
Understand the two access options: a one-time $2.99 App Store purchase for iPhone / iPad, and free versions for Mac, Windows, Android and Linux. Learn how purchase history, restoring downloads and network services differ.
Start by selecting a server in Home, then check the connection toggle, VPN configuration permission and test results. Distinguish between “imported,” “connected” and “destination accessible.”