Choose a mode, then review the rules
Config routes traffic according to the configuration; Proxy and Direct switch routing modes explicitly.
Cross-platform rule-based proxy client for importing an existing subscription, setting up rule-based routing and checking connections. iPhone / iPad: $2.99 one-time on the App Store; Mac, Windows, Android and Linux: free.
Current version · iPhone / iPad: $2.99 one-time; Mac, Windows, Android and Linux: free
First steps: import and connect →Config routes traffic according to the configuration; Proxy and Direct switch routing modes explicitly.
Get subscriptions from your service provider. After importing server details, select a default server and test the connection.
Keep servers, configurations and connection status distinct. A server determines the connection in use; a configuration determines how requests are handled; diagnostics help locate an issue. Establish a basic connection first, then add automation settings one at a time.
Rule-based routing distinguishes requests that use a proxy, connect directly or are rejected. View Rule in Config and set Global Routing to Config for rules to apply to everyday traffic. Put specific domain conditions first and FINAL last. When troubleshooting, check which rule matched, then confirm that its policy points to the expected server. The example below shows the syntax; PROXY must refer to a policy available in your configuration. example.com is for demonstration only and cannot replace your own configuration.
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
On Demand can trigger a connection when network conditions match; it does not repair an unavailable server. First make a manual connection from Home, then open On Demand in Settings and review Wi-Fi, cellular and domain conditions. If a Wi-Fi network is specified, its name must match the current network; check the order of multiple conditions individually. Switch networks to observe the result after making changes. If the connection starts again after you turn off the main switch, check the trigger conditions here before concluding that the switch is malfunctioning.
Settings → On Demand
Wi-Fi / Cellular
Shadowrocket supports Shadowsocks, VMess, VLESS, Trojan, WireGuard and other protocols. In Add Server, first choose the Type that matches your provider's details, then fill in the corresponding fields. Matching addresses and ports do not make parameters interchangeable between protocols. Match TLS, SNI, transport method, keys and other details individually; do not copy only the password. For subscription imports, keep the imported result and check the original details if an issue occurs. Do not loosen certificate verification settings just to make a connection work.
Add Server → Type
Host / Port / Password
Subscribe imports and updates a group of server details. Get the subscription link from your service provider. In Add Server, select Subscribe, enter the link and save. Then return to Home and check the SERVER group. A successful update only means the content was retrieved; it does not mean every server can connect. After updating, check that your previous default selection is still available, then run a test. A token in the link acts as an access credential. Hide the full link in screenshots and diagnostic reports to avoid exposing your subscription.
Add Server → Type → Subscribe
Home → SERVER
Config stores rules and related settings; it is not the same as the server list in Home. Keep a working copy before editing, then check which configuration is actually selected. Importing a file without selecting it may leave the previous settings in effect. Check General, Rule, Hosts and other sections individually, and verify the result after changing one setting at a time. To use iCloud sync across devices, first check your account and the in-app sync options, then confirm which file is selected on the target device. A completed sync does not confirm that a connection works.
Config
General / Rule / Hosts
Connectivity Test checks whether a server is reachable; Data displays traffic records. Neither replaces the other. Turn on the connection switch, confirm that the system has allowed a VPN configuration to be added, test the current default server, then open the destination you actually need. Test results may differ from real requests, so continue by checking DNS, matched rules and the destination service. Diagnostics can help locate the failing stage. When preparing a report, include the error description and network environment, but remove server credentials and personal subscription links.
Home → Connectivity Test
Settings → Diagnostics
Data
iPhone / iPad: $2.99 one-time on the App Store; Mac, Windows, Android and Linux: free. Desktop and Android packages are available from this site's download page under /dl/shadowrocket/. Check your operating system and processor before choosing a package format to avoid mistaking an incompatible package for a connection issue.
App Store: $2.99 one-time. Mac, Windows, Android and Linux versions are free. The app can be redownloaded on both mobile devices with the same purchasing account. Check the App Store page for system requirements.
Store listings vary by account region. If you cannot find the app, check the store region, then confirm the app ID on the product page. Do not judge authenticity by search-result ranking.
Free · Apple Silicon / Intel. iPhone / iPad costs $2.99 one-time on the App Store; Windows, Android and Linux versions are also free. Open About This Mac to check the processor, then use the corresponding download option.
If you see a message that the developer cannot be verified on first launch, check the download source, then select Open Anyway in Privacy & Security. Follow the download page's instructions for handling other system prompts.
Free. Like Mac, Android and Linux, the Windows version is free; iPhone / iPad costs $2.99 one-time on the App Store. The download page provides a 64-bit Windows installer.
If SmartScreen appears during installation, first confirm that the file came from this site, then select More info → Run anyway. System permissions and server connectivity are separate stages and should be checked separately.
Free · arm64. Mac, Windows and Linux versions are also free; iPhone / iPad costs $2.99 one-time on the App Store. Check your device architecture on the download page before getting the package.
If system settings require permission to install unknown apps, grant it only to the browser or file manager used to open the package. On the first connection, confirm the system VPN authorization; do not skip the prompt and repeatedly reimport a subscription.
Free · deb / rpm / AppImage. Mac, Windows and Android versions are also free; iPhone / iPad costs $2.99 one-time on the App Store. Choose the format that matches your distribution's package system instead of trying every file.
AppImage requires execute permission; handle deb and rpm packages using your distribution's package manager. The download page lists commands and system permission steps. If the app launches but cannot connect, check permissions, server parameters and rules instead of switching package formats.
The steps below use iPhone / iPad as an example. You must already have your own subscription or server details; get subscriptions from your service provider. Establish a manual connection first, then configure automatic updates, On Demand or more detailed rules.
Read the full guide →Open Add Server from Home. For an individual server, fill in the fields for its Type. For an existing subscription, select Subscribe and paste the complete link. After saving, check the entry in the SERVER group, then tap the circle beside a server to set it as the default. Scan QR Code is another way to import existing details; confirm the QR code's source before scanning.
If import fails, check whether the link was truncated, whether spaces were added at either end, and whether your provider requires an updated subscription URL. Do not enter a subscription link in Host or use a configuration file URL as a server subscription; these types of information serve different purposes.
In Global Routing, Config uses configuration-based routing, Proxy routes through the proxy and Direct connects directly. For rule-based routing, select Config and check which file is active in Config. If you temporarily select Proxy to check the proxy path, remember to switch back afterward. Direct may still provide internet access, but that does not prove the proxy server is available.
If only some destinations fail, compare results across modes, then check rule order and DNS. Change one setting at a time and record its original value so you can identify what caused the difference. Changing the server, configuration and network together makes troubleshooting harder.
Return to Home and turn on the connection switch. On first use, follow the system prompt to allow a VPN configuration to be added. Confirm the default server, run Connectivity Test, then open the destination you need. A connected switch indicates tunnel status; it does not replace end-to-end testing. If the test succeeds but the destination does not work, check the matched rule and destination service.
If the connection fails, check the current network, subscription validity, server fields and system authorization in turn. Keeping the exact error text is more useful than repeatedly deleting and reinstalling the app. For error types, see troubleshooting. Remove link tokens, passwords and keys before sharing diagnostic information.
Shadowrocket is a closed-source commercial app. This is the official website and manual. Use the platform links listed on the download page, and manage store purchases, client settings and service-provider connection details separately.
Check three details in the App Store
Open the product page and confirm the name Shadowrocket, developer Shadow Launch Technology Limited and official icon. Finally, verify that the app ID in the product page URL is 932747118. Similar names or colors do not replace these checks, and a promoted search result is not proof of identity.
These checks confirm the app's identity, not the source of a subscription. Purchase records, system download progress and the server list in the client are separate matters. Even after a successful store download, you still need to import your own connection details.
The app is currently unavailable on the mainland China App Store. If the product page does not appear, check the country or region for your Media & Purchases account in system settings. Device language, current location and network connection alone do not indicate which storefront you are using. Any account-region change must follow store requirements and account for balance, subscriptions and family-related restrictions.
For iPhone / iPad system requirements, check the App Store page. Review compatibility before purchasing to avoid mistaking an unsupported system version for an account issue. See the app verification guide for the full process.
iPhone / iPad costs $2.99 one-time on the App Store, and both devices can use the same purchasing account. Mac, Windows, Android and Linux versions are free. The store displays the amount in the local currency for your storefront; check the product page and confirmation dialog before purchasing.
Mac uses a separate download process: choose the package for Apple Silicon or Intel. Desktop and Android users do not need to purchase the mobile version before using the download page on this site. Check platform, price and access method together.
After changing iPhone or iPad, make sure Media & Purchases is signed in to the original purchasing account, then look for Shadowrocket in your purchased items. Redownloading the app and restoring its configuration are separate steps. After reinstalling the app, check whether your server details, subscriptions and current configuration were retained or synced.
If the app is missing from purchase history, first check the account and storefront records before deciding what to do next. Family Sharing availability depends on the store's current listing and family settings. Do not confuse redownloading with the same account with access for family members.
Purchasing the client provides a license to use the app; it does not create a server, subscription or usable connection. This site does not provide, sell or recommend nodes or subscriptions. Get subscriptions from your service provider; importing and connecting requires your own existing server details.
A subscription expiry, changed server parameters or temporary provider-side outage cannot be fixed by purchasing the client again. Check the subscription status with the provider first, then return to Home to update it and check the default server before running another connection test.
Update the iPhone / iPad app through the App Store. For Mac, Windows, Android and Linux, get the corresponding package again from this site's download page. Keep a working configuration before updating; afterward, check the selected server and Global Routing, then test a real request.
Subscribe updates server details; Config changes rules and related settings. Neither is an app update. Traffic shown in Data does not mean every request used a proxy; interpret it alongside the current mode and matched rules.
Continue with the guide that matches your current task: understand access and purchasing first, then establish your first connection. When entering server details manually, check each protocol field. Articles retain the English interface labels so you can find the corresponding settings in the app.
iPhone / iPad costs $2.99 one-time on the App Store; Mac, Windows, Android and Linux versions are free. Learn what redownloading with the same purchasing account means and why an app purchase and a service plan are separate, so missing connection details are not mistaken for an incomplete purchase.
Read about pricing →After importing, tap the circle beside a server in Home, turn on the connection switch and allow the system to add a VPN configuration. Follow the steps to distinguish the default server, tunnel status and actual access results—a practical guide to resolving first-connection issues after import.
Read the connection steps →Before entering details manually, confirm that your existing server information is complete, then check the address, port, password and SNI in Add Server. Learn what TLS verification and Allow Insecure do; for certificate errors, check the parameters first rather than routinely relaxing verification.
Read about the fields →