Shadowrocket interface terms: what Home, Config, Proxy, Direct, Data, and Settings do
Look up terms by location and purpose. Find where to switch connection modes, choose a configuration file, and check traffic in Data.
A cross-platform rule-based proxy client. Choose the installer for your Mac chip, then import an existing subscription and configure routing. iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android, and Linux: free.
Current version v2.2.92 · Free for Mac, Windows, Android, and Linux
Already installed? Follow the quick-start steps
Shadowrocket settings
The examples below use the iPhone / iPad interface. First confirm that the server connects, then check whether rules route requests to the intended policy. A successful connection and correct rule routing are separate outcomes; verify each one.
Open Global Routing in Home. Choose Config for rule-based routing, Proxy to temporarily troubleshoot the proxy path, or Direct to compare with your local network. In Config mode, the client checks requests against rules in order and applies the policy for the first match. Put rules for a single domain before broader rules, then check the fallback policy at the end. The example below routes a sample domain and its subdomains to PROXY. It shows the three parts of a rule: match type, match value, and policy.
DOMAIN-SUFFIX,example.com,PROXY
First connect successfully by hand, then open Settings and check On Demand. Set automatic connection conditions using the available options. Test one change at a time, such as switching from Wi-Fi to cellular and back, then check the connection status in Home. On Demand controls when a connection starts; it does not choose a policy for a particular website. If a connection starts but certain sites behave unexpectedly, check routing rules in Global Routing and Config rather than changing automatic connection conditions.
DOMAIN,example.com,DIRECT
For a single server, choose Type in Add Server first. Shadowrocket supports Shadowsocks, VMess, VLESS, Trojan, WireGuard, Hysteria2, HTTP, and SOCKS5. Each protocol requires different fields. Even when the address is the same, authentication fields and transport options are not interchangeable. Check the address, port, and parameters supplied by your provider before saving. If the connection fails, verify Type and required fields first, then troubleshoot the network; there is no need to fill in every protocol in turn.
ss://
Get subscriptions from your provider. In Add Server, choose Subscribe and paste the full address. After saving, return to Home and check that the corresponding group appears under SERVER. Updating a subscription fetches the server list again, and old entries may be replaced. If a server no longer appears after an update, select an entry from the new list before testing. Subscription addresses may contain credentials: do not post them publicly or leave them visible in screenshots. The address below is for format illustration only.
https://example.com/sub
Before editing rules, check which configuration file is selected in Config. To test a change, keep the original file and add or adjust one rule in a copy under Rule. Switch to the copy and retest the same address. Updating a server subscription and changing a configuration file are separate actions; refreshing the server list will not rewrite your rules. If you sync configurations with iCloud, also check which file is selected on the other device. If results still differ, compare rule order and the fallback policy.
FINAL,DIRECT
Run Connectivity Test for the current server in Home, then open a familiar website to check an actual request. If the test returns a result but the page will not load, check the current Global Routing option first, then see whether an earlier rule matched. Use Data to observe traffic changes before and after the action, but do not infer which policy a request used from total traffic alone. Change one thing at a time while troubleshooting: keep the server unchanged and compare Proxy with Config to see whether the rules are involved.
DOMAIN,example.com,PROXY
First connection
After installation, prepare existing server details or a subscription address. For the first setup, connect to one server and then check routing. Importing multiple sets of details, switching modes, and enabling automatic connections at once makes it harder to identify the cause of a failure.
Open Add Server in Home. For a single server, choose the Type specified in its details, then enter Host, Port, and the required authentication fields. For a subscription, choose Subscribe and enter the full address provided by your service provider. After saving, return to Home and select the entry you want to connect to under SERVER. If names are similar, distinguish entries by group and address rather than display name alone.
If no entry appears after saving, first check whether you entered a subscription address or a single-server link. These use different import methods, and pasting one into the wrong place may not create a list. For an existing subscription, check that the copied address is complete, then confirm the current network can access it. Avoid repeatedly adding the same source when retrying.
If you already have a rule file and want requests routed by rules, choose Config and check which file is active. To temporarily test whether the proxy server can handle requests, keep the same server and switch to Proxy. To compare with your local network, switch to Direct. This setting controls how traffic is handled; it is separate from the server selected under SERVER.
Before testing, note the original mode and configuration name. If a site works in Proxy but not Config, first check for an earlier matching entry in Rule or see whether the request reaches FINAL at the end. Do not replace the whole configuration at the first sign of a failure. Reproduce the difference with the same URL, then change the relevant rule.
Return to Home and turn on the connection switch. The first time the system asks to add a VPN configuration, confirm that the prompt was triggered by the Shadowrocket app you just opened, then follow the system prompts. Once connected, use Connectivity Test to check the selected server, then visit a familiar address. A test result only shows whether that particular test completed; it does not replace a real browsing check.
If the system switch does not stay on, check VPN configuration permissions and the selection under SERVER. If the switch is on but only some addresses behave unexpectedly, keep the server unchanged and compare routing modes. When describing an issue, note the device system, current mode, test method, and error message. Do not include passwords, full subscription addresses, or QR codes containing credentials.
2 ways to get the app
iPhone / iPad: $2.99 one-time via the App Store; check the App Store listing for system requirements. Mac, Windows, Android, and Linux versions are free, with installers available from this site at /dl/. For desktop and Android devices, check the system and architecture before choosing a download. A file for one system cannot be used across different systems.
App Store · $2.99 one-time
Check the developer and app ID on the store listing before purchasing or downloading again. On a new device, first confirm that you are signed in with the account used for the original purchase.
Free · Apple Silicon / Intel
Check the chip or processor in About This Mac, then choose the corresponding DMG. During installation, drag the app to Applications rather than running it from the disk image.
Free
Check the system type under About in Settings and choose the 64-bit installer if compatible. For managed work devices, contact your administrator if policy restrictions apply.
Free
Confirm that your device supports arm64, then download the corresponding installer in a browser. If the system requests permission, check which source initiated the installation; you can revoke that permission afterward.
Free · deb / rpm / AppImage
Check both the processor architecture and distribution. Prefer a format supported by your distribution’s package manager. For AppImage, follow the download page instructions to grant execute permission.
Open About This Mac from the Apple menu in the upper-left corner. If it shows Apple Silicon (M series), choose the Apple Silicon version; if it shows an Intel processor, choose the Intel version. Do not infer the processor from the model name or appearance: a product line may include both types. Open the corresponding DMG, drag Shadowrocket.app to Applications, and eject the disk image after copying finishes. Then open the app from Applications.
If a first launch says the developer cannot be verified, check the download source and selected architecture. If the source is confirmed and device policy allows it, open System Settings › Privacy & Security and look for the Open Anyway option for this app. If a message says the file is damaged, the filename does not match, or system policy prevents continuing, stop and investigate instead of treating every message as a first-launch block. See installation instructions for each platform.
Before reinstalling, quit the running client and make sure any configuration or subscription you need to keep is saved. After installation, open the replacement app from Applications and confirm it launches before importing or restoring configuration. If a system window points to a file on the old disk image, close it and make sure you are opening the copy in Applications. Otherwise, an old copy may be mistaken for a failed update.
Purchase, verification, and recovery
Open the product listing in the App Store. First confirm the developer is Shadow Launch Technology Limited, then compare the official icon at the top of this page: a blue-purple outlined rocket on a white background. Finally, check that the app ID in the product page URL is 932747118. Similar icons and names can appear; if any of these details do not match, return to the genuine app verification guide instead of purchasing that listing.
The App Store catalog varies by the country or region of your account. If the app is not listed in the mainland China storefront, the product link may still open a US storefront description on the same device. Seeing the listing on the web does not mean your current account can buy it in its storefront. Check your account region under Media & Purchases in system settings. If you need to change it, follow Apple’s official process and review conditions such as account balance and existing subscriptions. Check the App Store listing for system requirements.
iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android, and Linux versions are free. A purchase made with the same Apple Account can be shared between eligible iPhone and iPad devices that meet the system requirements. On a new device or after reinstalling, first look in the store’s purchased items. If the listing still shows a purchase button, check the signed-in account, storefront region, and purchase history rather than treating a new purchase as a restore step. Restoring the app does not restore local configuration; check configuration and server lists separately.
Update the iPhone / iPad app through the App Store. For Mac, Windows, Android, and Linux, get the appropriate installer for your device from this site’s download page. Check the chip, architecture, and package format each time; files with the same extension are not necessarily interchangeable between devices. Shadowrocket is a closed-source commercial application. Client updates, rule-file changes, and server subscription refreshes are separate operations. If routing behaves unexpectedly after an update, first check that the intended configuration is still selected, then decide whether to refresh the subscription.
More from the official guide
Look up terms by location and purpose. Find where to switch connection modes, choose a configuration file, and check traffic in Data.
Learn what each rule matches, how rule order works, and how to assign a policy with PROXY, DIRECT, or REJECT.
Check each detail on the store listing instead of relying on a search result name or thumbnail. Includes download information for desktop and Android.