Cross-platform rule-based proxy client. Import existing subscriptions and route traffic according to your configuration. iPhone / iPad: $2.99 one-time in the App Store; other platforms are free.
routing referenceplatformiOS / iPadOS / macOS / Windows / Android / Linuxacquisition2 ways to get the appruleStop at the first match
Get the app by device
get
Check your device first, then choose how to get the app. iPhone / iPad costs $2.99 once in the App Store; Mac, Windows, Android and Linux versions are free. Desktop and Android installation packages are available on this site's download page under /dl/shadowrocket/. The platform links prioritize your current device, while letting you select another device directly.
Manage existing subscriptions, choose Global Routing and check connections on a phone or tablet. Both devices can restore the app using the same purchasing account. Check the App Store listing for system requirements. When connecting for the first time, allow the VPN configuration when prompted by the system, then return to Home to check the status.
Available for both Apple Silicon and Intel. Check your chip or processor in About This Mac, then choose the matching package on the download page; do not infer the hardware from the computer's appearance. If a developer verification prompt appears on first launch, confirm the file came from this site, then follow the download page's Privacy & Security instructions to allow it.
Import existing server details and configuration files on your PC. If SmartScreen appears after downloading, verify the source, select More info, then select Run anyway. See the download page's installation section for full instructions. When diagnosing a connection, check the local network, server reachability and rule matches separately instead of changing several settings at once.
Use the arm64 package provided on this site. When Android asks for installation permission, enable Allow from this source only for the browser or file manager used for this download. You can turn it off after installation. If an in-app browser blocks the download, open the download page in your system browser and continue from there.
Choose a format based on your distribution's package management: use deb or rpm with the system package manager, or choose AppImage. AppImage requires execution permission before it can run. The download page lists installation commands and permission instructions. Keep a copy of the original file before importing a configuration to make differences easier to identify.
See all platforms →If the system blocks installation, read the download page's instructions for allowing it.
Connection & rule configuration
rule-set
Top to bottom; stop at the first match
When Global Routing is set to Config, connections are handled by the rules in the active configuration file. DOMAIN-SUFFIX matches a domain and its subdomains; IP-CIDR applies to a specified address range. Put specific rules first and FINAL at the end. PROXY and DIRECT describe what happens after a match; they do not guarantee a successful connection. To troubleshoot, confirm the active configuration first, check rule order next, then observe the actual connection.
On Demand starts connections based on configured network conditions. Before checking the related option in Settings, use the manual switch to confirm that an existing server works, then adjust conditions one at a time. On Demand controls when a connection starts; it does not replace Global Routing or fix an expired subscription. If a connection repeatedly resumes, check the On Demand conditions and system VPN settings first. When stopping a test manually, also check the On Demand state so an automatic reconnection is not mistaken for a faulty switch.
Settings · settings entry
On Demand · on-demand connection
Global Routing · routing mode
Match the protocol to the server details
Shadowrocket supports protocols including Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard and Hysteria2. In Add Server, choose Type first, then enter the address, port and authentication details from your existing server information. Each protocol uses different fields; changing only the type while keeping other parameters does not work. The transport method, TLS and server name must also match the server. Choose a protocol based on what the server actually provides, then consider the network environment, battery use and compatibility rather than judging by its name alone.
A subscription stores and updates server entries in batches. Get the subscription URL from your own service provider. In Add Server, choose Subscribe, paste the complete URL, save it, then update the list. After import, confirm that the group contains entries and select one to test connectivity. An update refreshes the list from the remote source, so keep any necessary notes before making manual changes. URLs often contain personal access credentials; hide the full link in screenshots and troubleshooting notes. If the list is empty, first check the copied content, subscription status and network during the update.
Distinguish server subscriptions from configuration files
Config manages connection rules and related settings, while a server subscription manages available servers; they serve different purposes. After importing a configuration, confirm which file is active and set Global Routing to Config so its rules are applied. Save a copy before editing Rule, and change one item at a time before testing. When using iCloud sync, check the selected file and sync status on both devices. A completed file sync does not automatically switch to that configuration or establish a connection.
General · general settings
Rule · matching rules
Hosts · host mapping
Check connectivity, traffic and rules separately
Connectivity Test helps determine whether a server is reachable; its result does not directly indicate actual web browsing speed. Data can help track changes in traffic during a connection, while Diagnostics provides additional troubleshooting tools. First confirm that the local network works, then test an existing server and check Global Routing and the configuration file. Keep the same network and target during testing, changing one condition at a time. When reporting a problem, record what happened and the steps taken, and hide subscription URLs, authentication details and personal browsing records.
Developer Shadow Launch Technology LimitedApp ID 9327471182 ways to get the app App Store purchase / site download
Check the app name, icon and developer together
Open the product page in the App Store and verify the name Shadowrocket, the official icon shown here and the developer, Shadow Launch Technology Limited. Also confirm that the app ID in the product URL is 932747118. Search results may include similarly named apps, so do not rely on keywords or icon color alone. Check that the developer details and product ID match before purchasing and installing.
Shadowrocket is a closed-source commercial app. iPhone / iPad costs $2.99 once in the App Store; Mac, Windows, Android and Linux versions are free. Getting the app works differently by platform: App Store manages purchases on iPhone and iPad, while desktop and Android installation files are provided on this site's download page. Check the platform before applying a free download method intended for another device to an iPhone / iPad App Store purchase.
store / region
Store availability and account region
App Store availability depends on the storefront associated with the purchasing account. The app is currently unavailable in the mainland China storefront. If it does not appear in search, first check the account region used for Media & Purchases rather than repeatedly changing the device language. Open the Apple Account in system settings, go to Media & Purchases, then check Country/Region in account settings. Before changing regions, review the system guidance on balance, active subscriptions and payment methods.
After opening the product page, use the currency and price displayed by the current storefront for checkout. The listed price is $2.99 once in the US App Store for iPhone / iPad; Mac, Windows, Android and Linux versions are free. Check the App Store listing for system compatibility. If installation fails, first review the device system and store compatibility notices, then troubleshoot network or account issues.
iPhone and iPad can share app purchase history through the same purchasing account. When changing devices or reinstalling, first confirm that the App Store is signed in to the original purchasing account, then find Shadowrocket in purchased items. Restoring the app and restoring its configuration are separate tasks: you can get the app again, but existing subscription URLs, manually added servers and personal settings must be restored from your own backup or service details.
If the store shows a purchase button again, check the signed-in account, storefront and purchase history before considering another payment. Users on computers, Android or Linux can return to this site's download page and select the package for their platform. Keep a copy of your configuration before reinstalling, and note the active file and Global Routing mode to help restore your usual connection setup.
The client imports server details, establishes connections and applies rules; connectivity services are provided by a service provider you already use or by your own server. Purchasing or downloading the app does not automatically add working servers to the list. Before getting started, prepare your own subscription URL or complete server details, including protocol, server address, port and any required authentication. Some protocols also require transport and TLS parameters.
This site does not provide, sell or recommend nodes or subscriptions; it explains how to import and use your existing configuration. Opening the client, reaching a server and accessing a destination website are separate checks. If a subscription expires or a remote service is unavailable, check the status of your own service; reinstalling the client does not resolve that. App and service charges should be understood and checked separately.
Get installation files for Mac, Windows, Android and Linux from this site's download page. Their URLs are under /dl/shadowrocket/. Check your chip type for Mac and package format for Linux. If the system blocks installation, follow the instructions for that system on the download page. On macOS, check for Open Anyway under Privacy & Security; on Windows, see More info in SmartScreen; on Android, check permission for the current installation source.
App Store manages iPhone / iPad app updates. To update other platforms, return to this site's download page to check the current version and get the package for your device. Keep a copy of your configuration before updating, then check that the active server and configuration file are correct. Version details on the page are read dynamically from the download manifest. If they temporarily show Loading, refresh the download page later rather than relying on version details in an older article.
Before connecting, understand these three settings
before-connect
The server selected on Home determines which existing entry is used for the proxy connection. The active file in Config determines which rules are available. Global Routing determines whether those rules are applied. These settings work together but cannot replace one another. Seeing an entry in the subscription list only confirms that the information was imported; it does not mean the system connection is active or that a rule matched as expected.
Choose Config in Global Routing when connections should follow rules. Proxy sends eligible connections through the selected proxy and can be used as a comparison when troubleshooting; Direct connects directly. After changing modes, start a new test connection, as existing connections may not be rebuilt immediately. To verify the result, use a fixed destination on the same network so you can identify whether the difference comes from the mode, rules or server.
Follow this order from import to verification: prepare existing details, import a subscription or server, select an available entry, confirm the configuration and routing mode, enable the connection, then test access. If a step fails, note the message and check the related settings before continuing. Do not change DNS, protocol and rules all at once before confirming that the server is reachable. See the complete guide or look up field definitions in the glossary.
Common questions topic guides
field-notes
These three guides cover an empty subscription list, Global Routing modes and the two price tiers. Choose the topic that matches the issue, then check each item in order. Always use your own existing details for subscription URLs and server parameters.
If a subscription saves but no server entries appear, first confirm that the copied content is complete, then check your subscription status and network during the update. Distinguish a URL parsing failure, an empty remote response and an update that has not finished; repeated imports can hide the real cause.
Config, Proxy and Direct use different handling paths. Learn how they relate to the active configuration and selected server, and compare modes to tell whether a problem lies in the rules instead of treating a mode change as a connection fix.
Get the app and check purchase records by device. iPhone / iPad use a one-time App Store purchase; other platforms are free to download from this site. App purchases, configuration restoration and existing connectivity services are explained separately, so app costs are not confused with service fees.