Install, setup, and connect · Official Guide

Shadowrocket Setup Guide for All Platforms

An all-platform client for phones, tablets, and computers. Add an existing server or subscription, then use rule routing to decide which requests go through a proxy, connect directly, or are rejected.

Current version v2.2.92 · iPhone / iPad: $2.99 one-time; other platforms are free

  • Shadowsocks
  • VMess
  • VLESS
  • Trojan
  • Hysteria2
  • WireGuard

01 Client features

Rule routing and connection settings

Configuration determines the route for each request; the server determines where proxied requests go. Start by understanding these two choices, then explore on-demand connections, sync, and diagnostics.

Apply Rule entries in match order

On Home, select Config under Global Routing for requests to match the current configuration's Rule entries. Use DOMAIN-SUFFIX to specify a domain and its subdomains, IP-CIDR to specify an address range, and FINAL for requests not matched earlier. To send a specific subdomain direct, put that specific rule before a broader domain rule. After editing, visit a known domain and check which rule matched, then test another domain to confirm the fallback behavior. Proxy and Direct are useful for temporary comparisons, but do not apply this routing order.

Compare Global Routing modes →
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-KEYWORD,ads,REJECT
FINAL,DIRECT

02 Devices and installers

Get Shadowrocket for your platform

iPhone / iPad: one-time purchase through the App Store ($2.99). Mac / Windows / Android / Linux: free. For computers and Android, open the relevant platform card to reach the download page on this site. Installers are provided from this site's /dl/shadowrocket/ directory.

iPhone / iPad

App Store · $2.99 one-time

Check the Apple Account currently used on the device and its App Store storefront, then verify the product page. See the App Store page for system requirements. If you have a previous purchase, check your purchased items before deciding what to do next.

View App Store instructions →

Mac

Free · Apple Silicon / Intel

Check About This Mac for the chip or processor: choose the Apple Silicon edition if it shows an Apple chip, or the Intel edition if it shows an Intel processor. Both installers are .dmg files, so the extension alone does not identify the edition.

Choose a Mac edition →

Windows

Free · 64-bit

Check the system type on the About page in Settings, then choose the 64-bit .exe installer. If installation is restricted on a work- or school-managed computer, check with an administrator rather than treating the restriction as an installer issue.

View Windows installation options →

Android

Free · arm64

The Android download is an arm64 .apk. If the system reports that the package is incompatible with your device, check the device architecture. If installation from the source is restricted, review which app and permission the prompt refers to; there is no need to change permissions for other apps.

View Android installation options →

Linux

Free · deb / rpm / AppImage

Choose a package format commonly used by your distribution, then check the architecture. Systems using a package manager can use deb or rpm; the download page also explains execution permissions for AppImage. These three formats are alternatives, not a sequence of packages to install.

Compare Linux package formats →

View all platforms →

03 First connection

Add a server, choose a mode, test the connection

The steps below use Home on iPhone / iPad as an example. Complete one manual connection first and confirm the server and policy are correct before setting up automatic connections or changing rules.

  1. Add Server: add a server or subscription

    Get the server address, port, protocol parameters, or subscription URL from your service provider. If you have details for a single server, choose the supplied protocol under Type and fill in its required fields. If you have a subscription URL, choose Subscribe, paste the complete URL, and save. Return to Home, check SERVER, and select the entry you want to use. Adding an entry only means its details have been saved. If the expected entry is missing, resolve the import issue before connecting.

  2. Global Routing: choose a route

    To route traffic according to the rules in a configuration, select Config and check the active configuration. To compare a proxy route temporarily, select Proxy; to compare a direct connection, select Direct. Selecting a server and choosing a mode are separate actions: even with a server selected, requests under Direct do not switch to the proxy. During testing, keep the server unchanged, switch only one mode at a time, and compare the same target to identify which setting caused the difference.

  3. Home: connect and test

    Turn on the connection switch on Home. When the system first asks you to confirm a VPN configuration, make sure the request came from the client you just opened, then follow the system prompt. After connecting, run Connectivity Test and visit a known target that matches one of your rules. If the test succeeds but access fails, first check whether the current mode and rules are as expected. If both fail, check the device network, current server, and protocol parameters; do not change several settings at once.

Read the complete guide →

04 Product verification and purchases

Verify the app and download source

Verify the product first, then distinguish the app purchase from configuration migration and network services. Shadowrocket is a closed-source commercial app. Store purchase records for phones and tablets are managed separately from installers for other platforms.

  • Shadow Launch Technology Limited
  • App ID 932747118
  • 2 ways to get it
View the download page verification checklist →
  1. Check the developer, icon, and app ID

    Open the Shadowrocket product page in the App Store. Check that the developer is Shadow Launch Technology Limited, compare the app icon with the white background and blue-purple outline, and confirm that the end of the product page URL is id932747118. Verify these three details; similar names or icons are not enough. If you opened the page from search results, check the product page information before proceeding.

    On a device where the app is already installed from the store, you can also open the app details from the update history. When opening the product page directly in the store, rely on the details page rather than search snippets or information in someone else's screenshot.

  2. Can't find it in the store? Check the account storefront

    Which App Store listings are visible depends on the storefront used by the Apple Account. The device's interface language, your current location, and the storefront region are separate settings. If the product page says it is unavailable in your region, first check the country or region in your App Store account. Do not mistake a storefront notice for a system-version incompatibility. If you can open the product page, check compatibility; see the App Store page for iPhone and iPad system requirements.

    Seeing the US product page on the web does not mean the account currently signed in has switched to the US storefront. If you need to change regions, follow the official steps in Apple Account settings and check prerequisites such as balances and subscriptions, then follow the store prompts.

  3. Restore a purchase with the same Apple Account

    The iPhone / iPad edition is a one-time App Store purchase. The US storefront price is $2.99; the price at checkout depends on the storefront. The Mac / Windows / Android / Linux editions are free. After purchasing on iPhone, you can download the app again from purchased items on an iPad using the same Apple Account, and vice versa. When changing devices or reinstalling, first check the account used for store purchases, then find Shadowrocket's download icon. An iCloud sign-in alone does not confirm which account was used for a purchase.

    Restoring the app does not restore all settings. Before migration, keep a copy of your configuration or check that iCloud sync is enabled. On the new device, check Config, Global Routing, and the current server, then test a request before resuming regular use.

  4. Client purchase ≠ network service plan

    An App Store purchase record is for the client itself. Get server addresses, protocol parameters, and subscription URLs from your service provider. This site does not provide, sell, or recommend nodes or subscriptions. If the SERVER list is empty after installation, first check whether you have added your own details. To update a subscription later, refresh the existing URL in the client; service periods and available entries depend on the information from your service provider.

    When troubleshooting an import failure, note the time, device, and step where the error occurred. Before sharing a screenshot, hide the complete subscription URL, server passwords, and other credentials. You can also refer to the glossary to distinguish subscriptions, servers, and configuration files.

  5. Get desktop and Android installers from this site

    Download the Mac, Windows, Android, and Linux editions from this site; they do not use iPhone / iPad store purchase records. The iPhone / iPad edition is a one-time App Store purchase for $2.99, while the clients for those four platforms are free. Mac has separate Apple Silicon and Intel .dmg files; choose packages for other platforms by device and distribution. For updates, return to the download page and select the platform, architecture, and package format you used before rather than searching by device name for an identically named file from an unknown source.

    Desktop and Android installers may trigger a system source warning. If installation is blocked, first check that the download address is under this site's /dl/shadowrocket/ directory, then read the installation instructions for your system. Stop if the source is unclear, the device is managed, or the prompt does not match the instructions.

05 Technical notes

Configuration sections and platform installation

After your first connection, continue with the topic at hand: a configuration change that did not take effect, restoring a purchase on a new iPad, or choosing a Linux package format.

Advanced

Shadowrocket .conf configuration file explained: General, Rule, Host, and URL Rewrite sections

Understand the roles of global parameters, local mappings, request rewriting, and routing rules, then identify which section to edit. The notes provide examples for each section and explain why the same request may match a rule earlier in the list. If you changed several sections, compare them one at a time with a backup to avoid mistaking the effect of a mapping or rewrite for a server failure.

Read the configuration sections guide →
Install

Install Shadowrocket on iPad: restore purchases and use the landscape interface

Check the Apple Account used for the purchase, find purchased items, and locate the relevant options in the landscape split view. The article explains purchase restoration separately from configuration sync so you can check each step after changing devices.

Read the iPad setup notes →
Install

Shadowrocket for Linux: choose deb, rpm, or AppImage

Choose an installation format based on your distribution and architecture, then distinguish package-manager installation from running AppImage directly. If a downloaded file will not open, check the package format, execution permissions, and terminal messages one by one.

Read the Linux installation notes →

View all articles →