Official Shadowrocket icon Official Manual · LINUX

Shadowrocket for LinuxDownloads and Usage Guide

Cross-platform rule-based proxy client: get it for your device, import an existing subscription, then configure Global Routing and rules.

Current version v2.2.92 · iPhone / iPad: $2.99 once; Mac, Windows, Android, and Linux versions are free

RULESWIREGUARDON DEMAND

CAPABILITY REFERENCE

Separate connection settings, routing, and rules

Whether a server connects, which policy handles traffic, and how a domain resolves are three separate questions. Use the topics below to find the relevant screen, then change specific fields. Adjust one variable at a time to identify what caused the change.

RULES / GLOBAL ROUTING

Config routes traffic according to rules

In Home's Global Routing, Config routes traffic according to the active configuration, Proxy sends applicable traffic through the selected proxy, and Direct connects without a proxy. To apply rules, select Config and check their order: matching stops at the first rule, from top to bottom. DOMAIN-SUFFIX matches domain suffixes; IP-CIDR matches address ranges; FINAL provides a fallback at the end. PROXY, DIRECT, and REJECT specify proxying, direct access, and rejection. The snippet below is not a complete configuration. Save the original file before editing, and check that each policy name exists.

See rule order and FINAL examples →

RULE ORDER

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

PLATFORM PACKAGES

Choose how to get Shadowrocket for your device

Two ways to get it: iPhone / iPad costs $2.99 once on the App Store; Mac, Windows, Android, and Linux versions are free. The links below go to the download page. Installers are provided by this site; read the instructions for allowing the app on your system before opening it for the first time.

iPhone / iPad

App Store · $2.99 once

The two devices share one purchase; Mac, Windows, Android, and Linux versions are free. Check the App Store product page for system requirements. On the product page, verify the developer and app ID, then check whether the app is available in your account's region. When changing devices or reinstalling, check your purchased items first instead of relying on search results to confirm your purchase history.

Mac

Free · Apple Silicon / Intel

Open About This Mac and choose the package that matches the listed chip or processor. Do not guess based on the computer's appearance or purchase year. If a first launch prompts that the developer cannot be verified, check the download source, then follow the download page instructions under Privacy & Security. Both chip versions use the same download method; no mobile app store is involved.

Windows

Free

Select the Windows 64-bit installer on the download page and run it after the download finishes. If SmartScreen blocks it, first confirm that the file came from this site, then select “More info → Run anyway.” On a device managed by an organization, check permissions first. Before importing, prepare an existing subscription or server details; installation alone does not establish a working connection.

Android

Free

The download page provides an arm64 package. If the system asks for installation permission, enable “Allow from this source” only for the app used to download and open the file. You can manage that permission in system settings afterward. If an in-app browser blocks saving, open this site's download page in the system browser and follow the device prompts instead of repeatedly tapping the same button.

Linux

Free · deb / rpm / AppImage

Check your distribution, package manager, and processor architecture before choosing a format. Debian-based distributions usually use .deb; RPM-based distributions use .rpm. For .AppImage, grant execute permission to the file. Do not convert formats by changing the file extension. Troubleshoot missing dependencies, desktop environment, and system permissions using terminal output. See the download page's installation and permission table for specific commands.

See all platforms →

For updates, iPhone / iPad use the App Store update mechanism; for other platforms, get the latest installer from this site's download page. Keep existing configurations before updating. Afterward, check the active file and selected server to distinguish changed settings from an installation failure.

FIRST CONNECTION

Three checks for your first connection

The steps below use the iPhone / iPad interface terms to explain the workflow. You will need your own subscription or server details. Establish one connection first, then add automatic triggers, complex rules, or sync settings; this makes troubleshooting easier.

  1. Add Server / Subscribe: import your details first

    Get an existing subscription or server details from your service provider. First identify whether you have a subscription link, a single server link, or a complete configuration file. To add a server manually, open Add Server, select Type, then enter Host, Port, and the required credentials. For a QR code, first confirm that it contains connection details rather than an account page. After importing a subscription, wait for the update to finish and check that entries appear in Home's SERVER group before selecting one to test.

    If no entry appears, check the link type and copied text before changing DNS. Extra spaces, line breaks, or missing characters can prevent import. Do not share a complete subscription link publicly while troubleshooting. Keep the configuration from before the import so you can compare whether entries were updated, parameters changed, or the wrong group was selected.

  2. Global Routing: check Config / Proxy / Direct

    Check Global Routing in Home. Config follows the rules in the active configuration; Proxy sends applicable traffic through the selected proxy; Direct connects without a proxy. To use rule-based routing, select Config and confirm the expected file is enabled. If you are investigating a rule issue, you can briefly use Proxy for comparison, but the result only shows how access differed at that moment; it does not replace checking rules individually.

    Rules are matched from top to bottom. A broad rule placed first may prevent a more specific rule below it from matching. Check domain rules first, then address ranges and the final fallback, FINAL. Do not change servers, switch modes, and rewrite rules all at once. Change one thing at a time and record the test result to distinguish a connection parameter issue from unexpected traffic routing.

  3. Connection switch and Connectivity Test: verify actual access

    Turn on the connection switch. On the first connection, if the system prompts you to add a VPN configuration, confirm that the request comes from Shadowrocket and allow it as required by the system. Then run Connectivity Test and open the webpage you need. A connected status only confirms that the corresponding connection is established; it does not guarantee access to every domain, protocol, or app request. A latency test and a webpage visit are different kinds of checks.

    If it fails, turn off the connection and check the regular network, then verify server parameters, system time, and subscription status. If latency is normal but webpages do not load, check DNS and rule matches. If the issue occurs only after changing networks, review On Demand conditions. When checking Log or Diagnostics, note where the error occurs and remove subscription links, server credentials, and other personal information before sharing.

Full guide: from import to connection testing →

IDENTITY / PURCHASE / RESTORE

Verify the app, check purchase history, understand service scope

This is the official Shadowrocket site and manual. Shadowrocket is a closed-source commercial application. Getting the client, restoring a purchase, and importing service provider details are separate tasks.

  • Shadow Launch Technology Limited
  • App ID 932747118
  • Two ways to get it

Verify the product details in the store

On iPhone / iPad, open the specified App Store product page. Check that the name is Shadowrocket, the developer is Shadow Launch Technology Limited, and the app ID is 932747118. The official icon is the white icon with a blue-purple outline shown at the top of this page. A Chinese nickname, a similar icon, or search ranking alone cannot verify the product; check these details together.

If search results show an app with the same name, use the product link on the download page to verify it rather than trying similar results. Check the App Store product page for system requirements and device compatibility. Desktop and Android downloads are available on this site's download page; installers are provided through the site's /dl/shadowrocket/ path.

See product verification steps →

Check store region separately from device compatibility

This app is not available in the Chinese mainland App Store. If it does not appear in search, check the region of the Apple ID used for the store and whether the product page is available in that region. Store availability does not determine device compatibility. If you need to change your account region, follow the Country or Region process in Apple account settings and review restrictions involving balances, existing subscriptions, and payment methods first.

Do not confuse the website language, device system language, and store region. Seeing the product page in a browser does not guarantee that it is available to the current store account. If the product page on your device says it is incompatible, check its requirements instead of repeatedly signing out and back in. Check purchase history separately under purchased items.

Read about App Store regions →

Two price tiers and purchase restoration

iPhone / iPad costs $2.99 once on the US App Store, and both devices share the purchase; other storefronts display local currency. Mac, Windows, Android, and Linux versions are free. If you have already purchased the app and are changing devices or reinstalling it, check purchased items using the original purchase account before downloading it again. Changing devices does not necessarily mean you need to purchase it again.

If the app is not listed under purchased items, first check that you are using the same store account as when you bought it, then verify the purchase history and product identity. Reinstalling the app and restoring configuration are separate tasks: after reinstalling the client, check that your local configuration, synced files, and existing subscriptions are still available. For other platforms, download the installer again and keep existing data safe before updating or reinstalling.

Restore a previous purchase →

One-time client purchase ≠ service plan

A one-time client purchase ≠ a service plan. The client reads existing connection details, applies rules, and provides diagnostic tools. An app purchase does not include a service provider account, server access time, or subscription allowance. This site does not provide, sell, or recommend servers or subscriptions; get subscription links and server details from your service provider. Check the validity period, parameter changes, and availability of connection details separately from app installation and purchase.

If a subscription will not update, first check the regular network and link integrity, then confirm that the existing service is still valid. Replacing the client installer does not renew a subscription automatically. When preparing troubleshooting details, you can describe the error, selected protocol, and test sequence, but do not share complete links or passwords. Separating the client, configuration files, and service provider details helps avoid repeated steps and identify issues.

Subscription, configuration, and rule terms →

FIELD NOTES

Guides to rules and connection issues

These three articles cover common troubleshooting topics. Choose the one closest to the issue: check DNS for resolution failures, connectivity and parameters for server timeouts, and Global Routing and rule order for unexpected traffic routing. Do not reset settings from different layers at the same time.

View all articles →