Official Manual · All-Platform Client

SHADOWROCKET Setup & Downloads

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 →
ShadowsocksVLESSConfig
GLOBAL ROUTING

Choose a mode, then review the rules

↗
ConfigProxyDirect

Config routes traffic according to the configuration; Proxy and Direct switch routing modes explicitly.

SUBSCRIBE

Import an existing subscription

↗

Get subscriptions from your service provider. After importing server details, select a default server and test the connection.

CONFIG / RULE / DIAGNOSTICS

Shadowrocket Features and Settings

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.

Route requests by rule order

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
GET / PLATFORM

Choose a device and access method

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.

See all platforms →
HOME / CONNECTIVITY TEST

First use:
Import, choose a mode, test

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 →
  1. 01 / ADD SERVER

    Add a server or Subscribe

    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.

  2. 02 / GLOBAL ROUTING

    Choose Config / Proxy / Direct deliberately

    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.

  3. 03 / CONNECT & TEST

    Turn on the connection and check real requests

    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.

OFFICIAL / PURCHASE / RESTORE

Verify the app and its purchase details

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.

Official Shadowrocket app icon, a blue-purple outlined rocket on white

Check three details in the App Store

Developer Shadow Launch Technology Limited App ID 932747118 Icon Matches the official app icon

Check the developer, then the app ID

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.

Store availability depends on account region

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.

Which devices are covered by each price

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.

Check the purchasing account before redownloading

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.

App purchase ≠ service plan

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 app and subscription separately

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.

READ / PRACTICE

Shadowrocket Guides and Tips

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.

Protocols

Trojan fields: password, SNI, TLS and Allow Insecure

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 →
Browse all articles →