Official manual · App Store verification
Shadowrocket is a paid Apple-platform app for iPhone and iPad. Start by verifying the official App Store listing, then import your own server details and configure rule-based routing as needed. The app is sold as a one-time purchase.
INTERFACE / CAPABILITIES
Shadowrocket workflows usually start with server details you already have: import them, choose a connection mode, then verify the result with tests and logs. The six sections below follow the typical workflow. Select a section in the left-hand navigation to read more.
In Home, select Config under Global Routing to route requests according to the rules in the active configuration file. DOMAIN-SUFFIX matches a domain and its subdomains; IP-CIDR handles address ranges. Matching requests follow policies such as PROXY, DIRECT, or REJECT. Rule order affects the outcome, so check FINAL for requests that do not match another rule. If a site is routed unexpectedly, first confirm which Config is selected, then review its rules and policies. The connection toggle alone does not tell you whether routing is working as intended.
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN,blocked.example.com,REJECT
FINAL,PROXYOn Demand, in Settings, uses configured network conditions to determine when to connect. It can help maintain a consistent connection behavior as networks change, but it does not replace server details or routing rules. For initial setup, connect manually from Home and verify that your existing server works before enabling On Demand. If behavior changes unexpectedly when you switch networks, temporarily turn it off and check the regular connection, network conditions, and selected Global Routing mode separately. This helps distinguish trigger issues from server problems.
Settings → On Demand
Home → Global Routing → ConfigWhen choosing Type in Add Server, use the details for your existing server rather than guessing from the protocol name. Shadowrocket supports configurations for Shadowsocks, VMess, VLESS, Trojan, WireGuard, and other types. Each Type can require different Host, Port, credentials, and additional fields. If a manually entered server will not connect, compare each field with the original details, paying particular attention to the protocol type and field mapping. A protocol name describes the configuration format; it does not by itself confirm that a server is currently available.
Shadowsocks · VMess · VLESS
Trojan · WireGuardIf you already have your own subscription link, add it in Subscribe, update it, and check the server list. A successful import only means the link content was read; it does not guarantee that every server in the list can connect. If the list is empty, check that the link is complete, its format is recognized, and the source still returns valid content. Give each subscription a recognizable name to avoid confusion when updating. This guide explains importing and organizing configurations; it does not provide subscription content.
Subscribe → Add → Update
SERVER → Select an existing entryConfig organizes settings such as rules and DNS. Before editing, check which file is selected in Home; changes to an inactive Config will not affect connection behavior. After adding rules such as DOMAIN-SUFFIX or IP-CIDR, review their order and where unmatched requests go via FINAL. To compare two routing setups, keep separate configurations and test them one at a time. This makes differences easier to identify than changing several conditions at once. Managing Config files and importing servers are related but separate steps.
Config → Rule
DOMAIN-SUFFIX,example.com,PROXYOnce the connection toggle is on, use Connectivity Test and the Diagnostics and Data sections in Settings to check what is happening. Test results reflect network conditions at the time of the test and do not replace checking the request in question. Data can help show whether traffic is passing through the app. If a test fails, troubleshoot in this order: current network, server details, selected server, Global Routing, and Config rules. Change one thing at a time and test again to pinpoint whether the issue is with the connection or a rule match.
Connectivity Test
Settings → Diagnostics
DataConfig, Proxy, and Direct are three different Global Routing modes. Config routes requests according to configuration rules, Proxy sends requests through the selected proxy, and Direct connects without one. When troubleshooting, note the current mode and compare the same request across modes. Switching modes can help narrow down the cause, but it does not replace checking server details and rule contents. For the full workflow covering subscription updates, manual entry, and server organization, see the Server Management Guide.
DEVICES / APP STORE
This guide focuses primarily on iPhone and iPad. Before purchasing, open the App Store product page and verify the developer, app icon, and app ID. Check the App Store listing for system requirements and device compatibility.
After verifying the App Store product page, purchase and open Shadowrocket. When you connect for the first time, the system may ask permission to add a VPN configuration. Once authorized, import your own server details. If you have already purchased the app, check your purchases under the same Apple ID; availability and listing details are shown in the App Store.
View the iPhone guide →If you use the same Apple ID, first check whether the App Store shows the app in your purchase history, then follow the on-screen prompts. The iPad layout may differ from the iPhone layout, but the steps are the same: verify the listing, import your existing configuration, choose Global Routing, and test the connection. Check the App Store listing for purchase eligibility.
View the iPad guide →Mac and Apple TV are also listed under compatibility on the same App Store product page. Check the listing for system requirements and purchase eligibility.
QUICKSTART / THREE STEPS
The steps below assume you already have your own subscription link or server details. Establish and test one connection first, then add routing rules and On Demand conditions as needed. This makes troubleshooting easier than changing several settings at once.
Open Home and use Add Server to enter your existing Type, Host, Port, and other details. If you have a subscription link, add it in Subscribe and update it. Return to the SERVER list to confirm the entry appears, then select the one you want to test. An entry appearing in the list does not mean it can connect: verify the import first, then test the connection.
For an initial test, choose one routing mode explicitly. Config uses the rules in the configuration file; Proxy sends requests through the selected proxy; Direct lets you check direct connection behavior. If you plan to use custom rules, first check their order and FINAL in Config, then return to Home and confirm that Global Routing is set to Config.
Turn on the connection toggle in Home and approve the VPN configuration when prompted. Then use Connectivity Test to check the current connection, and review actual requests, Data, or Diagnostics. If the test fails, switch back to a network condition you know works, then check the server fields and routing settings in order. Avoid changing multiple parameters at once.
When importing via QR code or clipboard, first make sure the source is your own existing configuration. After import, verify each key field. Once connected, read about On Demand if you want connections to respond automatically to network conditions. To maintain multiple subscriptions over time, give each source a distinct name and note how the list changes after updates. For the complete screen-by-screen walkthrough, see the full guide.
Read the full guide →APP STORE / VERIFICATION
Search results may show similar names or icons. Before purchasing, open the App Store product page and verify the developer, app icon, and app ID in the URL together. Do not rely on the search result title alone.
The developer shown on the product page should be Shadow Launch Technology Limited. Confirm the full name, then check the icon and page address. This site is the official Shadowrocket website and official manual. Purchases and prices follow the App Store product page.
Compare the icon with the one shown on the App Store product page. The icon is one of three verification details and should not be used on its own. If the store listing changes, rely on the current product page.
Shadowrocket's app ID is 932747118, and the product page URL contains id932747118. Check this number alongside the developer name and app icon. If you open the App Store link from this page, you can also check the address and product details after it opens to confirm you are viewing the correct store listing.
Shadowrocket is a paid commercial app sold as a one-time purchase. The US storefront lists it at about $2.99; the current App Store listing determines the actual price, currency, and eligibility. Store details may differ by account region, so check the product page opened with your own account before purchasing. To use the app on another device or reinstall it, check your App Store purchase history using the Apple ID used for the original purchase. The App Store listing determines purchase eligibility and system requirements for iPhone, iPad, and other compatible devices. App updates are also handled through the App Store.
Buying the app ≠ buying a server plan. Purchasing Shadowrocket gives you the app; it does not provide server details. The import steps apply only if you already have your own subscription or server details. This site does not provide, sell, or recommend servers or subscriptions. If a connection fails, check four separate things: whether the app was purchased, whether a configuration was imported, whether the server can connect, and whether a rule matched. Verify each one instead of treating purchase status as connection status.
NEXT / QUESTIONS & READING
Importing, connecting, and routing are separate steps. Identify where the problem occurs, then read the relevant guide. This is usually more effective than repeatedly switching settings.
Is the list empty after adding a subscription? Check that the link is complete and the update finished, then verify that the returned content can be recognized. See troubleshooting →
Is the toggle on, but traffic is routed incorrectly? Check Global Routing in Home, confirm the selected Config, and review its rule policies. Read the settings guide →
How do you restore a purchase on a new device? Check the App Store purchase history for the Apple ID used to buy the app, and review the current storefront prompts. See how to restore a purchase →
Start with how battery usage is reported. Distinguish a persistent connection from On Demand rules and speed tests, then decide whether to enable it for your usage.
Read article →Using your existing WireGuard details, learn what each field under Interface and Peer does and what to check when entering it.
Read article →Where Trojan TLS settings go in Add Server, and common mistakes when entering Host, Port, password, and SNI.
Read article →Field examples in this article are for explaining where to enter information. Always use your own server details. If a setting has a different name or location in your version of the interface, follow what the app displays. This site provides usage guidance; check the App Store product page for purchase information, system requirements, and device compatibility.