A rule-based proxy client for all platforms: import your existing configuration, set up rule-based routing and test your connection. iPhone / iPad require a one-time $2.99 purchase on the App Store; Mac, Windows, Android and Linux versions are free.
First distinguish whether the server can connect from which route a request should take. The former depends on your existing server details and current network; the latter is determined by Global Routing and Config. The examples below use interface terms from iPhone / iPad. Start with what each feature does, then compare it with your settings. For other platforms, refer to the interface in the app.
CAPABILITYPurpose and examples
Global Routing: Choose a connection mode
Open Global Routing from Home to choose between Config, Proxy and Direct. Config routes traffic according to the rules in the current configuration; Proxy sends intercepted connections through the selected proxy; Direct connects directly. After importing for the first time, use Proxy to check whether the server is available, then switch back to Config to check routing. After changing modes, run a new test request. Do not assume the rules are working just because an old page still opens.
Global Routing → Config / Proxy / Direct
On Demand: Trigger connections by condition
On Demand is in Settings. It can trigger a connection when the system meets specified conditions, reducing repeated manual steps. First complete one successful manual connection, then adjust the conditions; otherwise, automatic triggers add variables during troubleshooting. After setup, test behavior when entering and leaving the target network, and check the connection status on Home. When temporarily stopping a connection, also check whether an On Demand condition will trigger it again rather than mistaking reconnection for a faulty switch.
Settings → On Demand
Subscribe: Manage an existing subscription
To add an existing subscription, choose Subscribe from Add Server. The link should come from your own service provider. After saving, confirm that the node list appears, then select an entry to test. Updating a subscription reloads its remote list; it does not extend the service period or fix a server-side problem. Before updating, note the existing groups and selection. Check for changes afterward. If the list is empty, first check that the link is complete. Avoid repeated imports that create confusing duplicate groups.
Add Server → Type → Subscribe
Config: Separate rules from server details
Config manages settings related to connection policies. The node list, which stores server addresses, ports and authentication details, serves a different purpose. Before applying a configuration, check that its rule policies match an available proxy, select the configuration, and set Global Routing to Config. Keep a copy of the original file before editing, then verify each change. Before using iCloud sync features, check your system account and sync status, and keep a separate backup. A successful sync does not guarantee identical settings on every device.
DOMAIN-SUFFIX,example.com,PROXY
Rule keywords: Type, match value and policy
A rule usually consists of a match type, match value and action policy. DOMAIN matches a complete domain, DOMAIN-SUFFIX matches a domain suffix, and IP-CIDR matches an IP range; DIRECT, PROXY and REJECT specify different actions. Rule order affects the result. Put specific conditions first, then broader matches, and check FINAL last. When troubleshooting a website, check domain resolution, the matched rule and its policy separately. Avoid using a broad rule to override existing logic.
IP-CIDR,192.168.0.0/16,DIRECT
Multiple protocols: Choose Type from your existing details
Shadowrocket supports Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, Hysteria2 and other protocols. When adding a server, check Type in Add Server, then enter Host, Port and the required authentication fields using your existing details. Similar protocol names do not mean their parameters are interchangeable. Transport and TLS options should also match the server. After importing a link, check the type and address. If the connection fails, verify the required fields first rather than switching protocols at random.
Add Server → Type
Diagnostic tools: Check connections and traffic separately
Connectivity Test on Home checks connection performance. Test Method in Settings affects how to interpret the results. Data can show traffic changes recorded by the app, while Diagnostics helps locate request failures. A latency figure is not the actual download speed, and total traffic is not a server-side bill. Record the current mode and selected server, make a specific request, then use traffic and diagnostic records to investigate. Remove addresses, authentication details and subscription links before sharing records.
Connectivity Test / Data / Settings → Diagnostics
From import to verification: Change one variable at a time
For your first setup, prepare your own subscription link or server details. Save them through Add Server, check the node type and required fields, then select an entry to connect. When the system first asks to add a VPN configuration, confirm that the request came from the Shadowrocket app you just opened, then follow the authorization prompt. A connected status does not mean every request uses a proxy; check the actual route with Global Routing.
To verify the setup, start with a specific access task, then review Connectivity Test, Data and related records. If Proxy works but Config does not, focus on the relationship between rules, DNS and policies. If both modes fail, first check the server details, service status and current network. Change one item at a time and keep the original value and test result. This makes the cause easier to identify than resetting everything at once.
For routine maintenance, follow this sequence: update your existing subscription, check the selected node, confirm the current configuration, and observe actual requests. Data is for monitoring usage on the client side; check your own service details for remaining service allowance. For step-by-step instructions, read Quick Start. For DNS, configuration editing and ongoing troubleshooting, read the Complete Manual.
PLATFORM / TWO ACCESS TIERS
Shadowrocket Downloads for All Platforms
iPhone / iPad require a one-time $2.99 purchase on the App Store; Mac, Windows, Android and Linux versions are free. Choose a device here; the download packages and system installation steps are on the download page. Desktop and Android packages are provided through this site's /dl/shadowrocket/ path. You do not need to guess a download address from a filename.
Get the app from its App Store product page. Check the App Store page for system requirements. Before purchasing, verify the app ID and developer. Both devices share the purchase when using the same purchasing account.
App Store · Verify the product page and restore purchases
Apple Silicon and Intel packages are available. Check your chip in About This Mac before choosing the corresponding option. Both architecture options are shown side by side on the download page.
Use the Windows 64-bit installer. After downloading, verify the file source and follow the download page instructions for system prompts. Add your existing connection details after the first launch.
An arm64 package is available. Grant installation permission to the browser or file manager that starts the installation, then revoke it afterward if needed. The first connection also requires confirmation of the system VPN request.
Choose deb, rpm or AppImage according to your distribution and package manager. Check which format suits your system before following the relevant commands. AppImage files require executable permission before use.
Desktop and Android packages are not code-signed, so the system may block them on first launch. After confirming the file came from this site's download page, Windows users can choose “More info” in SmartScreen, then select “Run anyway.” If Mac reports that the developer cannot be verified, go to “System Settings → Privacy & Security” and choose “Open Anyway.” If the prompt differs, first check the relevant download page instructions rather than disabling every security option.
On Android, allow installation from the source you are using in the system setting “Install unknown apps.” On Linux, use the package manager or grant executable permission according to the package format. Installing the app and authorizing a VPN connection are separate steps; after installation, import your own configuration. For detailed steps, Mac file attribute instructions and Linux commands, see Installation and system prompts.
Shadowrocket is a closed-source commercial app. This site is the official website and manual, with access information and operating instructions maintained here. Verify the app using product details rather than relying only on search ranking, similar names or icon colors.
Shadow Launch Technology Limited
App ID 932747118
iPhone / iPad $2.99 one-time · Other platforms free
App Store: Verify three details
On the iPhone / iPad App Store product page, check the name Shadowrocket, developer Shadow Launch Technology Limited and app ID 932747118, then compare the listing with the official icon shown at the top of this site. The app ID at the end of the product page URL helps distinguish listings with the same name. Seeing only a search result name or thumbnail is not enough to verify the app. Check the App Store page for system requirements, and confirm compatibility on your device before purchasing.
English interface terms such as Home, Config and Settings help locate features in the app; they should not be used alone to verify its identity. If the store listing has a different developer or app ID, stop the purchase process and reopen the product page from the download page. Get the desktop and Android versions from this site's download page, using only packages provided through this site's /dl/shadowrocket/ path.
Store visibility: Check the account's region
The app is generally not searchable in the mainland China App Store. If it does not appear in search, first check the store region for the Apple ID used for “Media & Purchases,” then review age restrictions, account status and device compatibility. The device's system language, physical location and store account region are separate settings. Changing the system language alone will not change which store content is visible.
If you need to change your account region, follow the official account settings process and check requirements for your balance, existing subscriptions and payment information. If you have a previous purchase, check your purchased items first. Being unable to open the product page does not mean the app has been removed from every region. For a detailed troubleshooting sequence, see App Store search troubleshooting checklist. Avoid repeated purchase attempts before checking your account details.
Two price tiers: App purchase and connection service are separate
On the US App Store, the iPhone / iPad version costs $2.99 as a one-time purchase. Other storefronts show local currency; the displayed price on the product page is the actual price. Mac, Windows, Android and Linux versions are free. iPhone and iPad share the purchase under the same purchasing account. When changing devices, first look up the original purchase rather than paying again just because the device type changed.
The client stores connection parameters, applies rules and displays connection records. Remote server availability, subscription validity and server-side usage measurement are separate matters. Updating a subscription reloads the contents of an existing link; it does not renew the service for you. If a connection fails, first distinguish a client configuration issue from a problem with your own service rather than treating the app purchase and connection service as the same thing.
Restore on a new device: Start with the original purchasing account
After changing iPhone / iPad devices or reinstalling the app, first confirm that you are signed in with the Apple ID used for the original purchase. Then find the purchased app in the App Store account page and download it again. The purchase can be restored under the same purchasing account without paying the app fee again. Mac, Windows, Android and Linux versions are free; download the package for the relevant platform again. Store listing names may vary with the system interface, so refer to the current account page.
Downloading the app again and restoring its configuration are separate tasks. Being able to download the app again does not mean locally stored servers, rules and preferences will be restored automatically. Before changing devices, organize a backup of your own configuration. After restoring, check the selected server, Global Routing and Config, then run a connection test. If you use iCloud, check the relevant sync status as well; signing in does not mean all content has been restored.
Updates and backups: Keep a working configuration
Manage app updates for iPhone / iPad through the App Store. For Mac, Windows, Android and Linux, download the package for the relevant platform again from this site's download page. Do not infer the current app version from an article's publication date; the dynamic version field on the page reads download information. Before updating, finish any important tasks and keep a verified working configuration. Afterward, check connection authorization and current settings again.
Subscription links, authentication parameters, configuration files and diagnostic records may contain private information. When asking for help, describe only the failing step, current mode, protocol type and prompt. Hide sensitive fields before sharing screenshots or records. Do not post a complete subscription link in a public discussion. Keep your own backups, especially before deleting node groups, replacing Config or removing duplicate subscriptions.
Selected FAQs
Connected, but a website still will not open. What should I check first?
Note the selected server and Global Routing, then check the request and matched rule separately. If Proxy works but Config does not, focus on rules and DNS. If both fail, check the server details and current network first. Follow the Complete Manual step by step instead of changing multiple settings at once.
Why did the list change after a subscription update, and why should I check my previous selection?
The remote subscription may add, remove or rename entries. After updating, check groups, the selected node and policy references in the configuration, then test a request again. Importing the same link repeatedly will not fix changes to its remote contents. See Managing multiple subscriptions for an organization sequence.
Is the entry with the lowest latency always best for the current task?
Not necessarily. The test method, current network and destination service all affect the result. Latency is one data point, not a measure of throughput or sustained connection performance. Compare results under the same conditions, then test with your own task. For more account, installation and connection questions, see the FAQ.
TECHNICAL NOTES
Shadowrocket Technical Notes
These three articles start with existing connection details and cover list management, test results and protocol fields. Choose one based on your current issue. You do not need to change the protocol, node and configuration all at once to troubleshoot a single problem.