· Install · About 8 min

Shadowrocket Android Installation Guide: Download the APK and Allow Unknown Apps

Download the arm64 APK from this site, allow your browser to install unknown apps in Settings, and use your system browser if WeChat blocks the download.

At a glance

This guide is for anyone installing Shadowrocket on an Android device. Follow these three steps: open this site's download page in your system browser, download the arm64 APK for your device, and allow only the app you'll use to open the installer to install unknown apps. If WeChat won't start the download, the package won't parse, or an update fails, first identify whether the issue is with downloading, installation, or connection, then troubleshoot that step.

Before you download: Check your device architecture and where to get the app

Get the Android version from the Shadowrocket download page by selecting Android. This guide covers installing the arm64 APK. Arm64 means the package is built for a 64-bit ARM environment; it does not mean it will install on every Android device. A 64-bit processor alone doesn't guarantee that the manufacturer provides a compatible system environment. Check your device specifications and follow the installer prompts.

There are two ways to get the app: iPhone and iPad versions cost $2.99 as a one-time purchase from the App Store; check the App Store listing for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. The developer listed on the iPhone and iPad App Store page is Shadow Launch Technology Limited. Select your platform on this site's download page, and don't try to install a desktop package on a phone.

Install the APK and allow the right source

Install unknown apps is an Android permission for the app that starts an installation; it is not a setting inside Shadowrocket. Usually, grant it to the browser that opens the APK. If you open the file from a file manager, Android may ask you to grant permission to that app instead. Follow the app name shown on the system prompt. You don't need to enable this permission for every browser and file manager.

  1. Open the download page

    In your system browser, open this site's Android download page and choose the Android package. If you're viewing the page in WeChat, switch to your system browser using the steps below.

  2. Wait for the download to finish

    Open your browser's Downloads or Download Manager and make sure the task is complete before selecting the APK. Don't rely on repeatedly tapping the page's download button to tell whether a download has started.

  3. Allow this source

    If Android blocks the installation, open the Settings option shown in the prompt and check the app name at the top. Then enable Allow from this source. On English-language systems, the settings may be labeled Install unknown apps and Allow from this source.

  4. Return and confirm installation

    Return to the installer, confirm the app is named Shadowrocket, and tap Install. If the installer closed, reopen the completed file from the same browser's download history.

  5. Revoke permission when you're done

    After installation, open the app. You can then return to the source's permission page and turn off Allow from this source. This won't remove Shadowrocket; grant permission again if needed for a future update.

If you can't find the prompt's Settings option, search Settings for Install unknown apps. A common path is Settings → Apps → Special app access → Install unknown apps. On some devices, it's under Security or Privacy. Don't confuse it with permissions for notifications, background activity, or VPN access.

Installation source permission

App to authorize
The browser or file manager used to open the APK
System setting
Install unknown apps
Permission to enable
Allow from this source
When to use it
For the first installation or a manual update

Authorize only the app that starts the installation; it may not be your default browser.

First connection permission

App to authorize
Shadowrocket
When it appears
When you start a connection from Home
System prompt
VPN connection request
What it allows
Allows the app to establish a system VPN connection

This permission applies to the connection stage. It does not replace the installation source permission or confirm that a server is available.

Can't download in WeChat? Switch to your system browser

WeChat's built-in browser may block app downloads or fail to hand them off to the system installer. You might tap the button and see no download in progress, get a prompt to use a browser, or remain on the webpage. Switch to your system browser rather than changing Shadowrocket settings or repeatedly tapping the same button in WeChat.

  1. Open the menu in the top-right corner of the WeChat page and look for Open in browser or a similar option. The wording depends on WeChat and your device's system.
  2. If that option isn't available, choose Copy link, open your system browser, and paste this site's page address into the address bar. Copy the webpage URL; don't save the page text as a file.
  3. Go to this site's download page, select Android, and start the download in your browser. Switching browsers won't resume a download that never started in WeChat.
  4. Check your browser's download list to confirm the task is complete, then open the APK. If Android asks you to authorize an installation source, check that the app named in the prompt is the browser you're using.

If your browser reports a network interruption, check that other webpages load, then try again. Don't change the file extension of a partial download and try to install it. Remove the incomplete task and download the file again from this site's download page. Don't repeatedly transfer the same incomplete file through chat apps.

Can't install or update? Troubleshoot by stage

Package appears invalid, App not installed, and Installation not allowed can have different causes. Note the full system message and when it appears: before opening the file, in the installer, or after installation. Start with checks that won't affect your existing data; don't make uninstalling the first step.

Getting a package parsing error?

Return to your browser's download list to make sure the task is complete, then download the file again from this site's download page. If the new file still errors as soon as you open it, check whether your device supports arm64 apps and meets the requirements on the download page. Renaming the file repeatedly won't fix an architecture mismatch.

Still blocked after allowing installation?

Check which source app is named in the blocked prompt. If you authorized your browser but opened the APK in a file manager, the app that needs permission may have changed. If the setting is disabled or says it's controlled by an administrator, check for work profile or device-management restrictions and contact your administrator. Don't try to bypass management policies.

The update says the app isn't installed. Should I uninstall it first?

First check that you have enough storage and download the installer again from this site. An update can fail if the installed app has a different signature or the system doesn't allow downgrades, but App not installed alone doesn't identify the cause. Don't uninstall right away. Save your configuration and subscription details, confirm how to restore them, then decide what to do with the existing installation.

The browser says the download is complete, but where's the file?

In that browser's Downloads section, choose Open file or Show in folder. If the file manager requests permission, grant only the access to files required by the system prompt. Your phone may have multiple user profiles; make sure you downloaded and searched for the file in the same user or work profile.

If you see a system security warning, confirm the file came from this site's download page and that the app name is correct, then read the warning. Don't disable device security protections across the board just to install the app. If your device is incompatible or restricted by management policies, address that specific issue; enabling unrelated permissions won't fix it.

First launch: Add an existing subscription and test the connection

After installation, add your own server details or an existing subscription from Home. Get the subscription link from your service provider. Tap + in the top-right corner of Home to open the add screen, choose Subscribe under Type, enter the full subscription URL, and save it. Then update the subscription from Home. You should see its server entries after importing. If you see a subscription name but no entries, check the update result first.

Access credentials in a subscription URL are personal connection details. Don't show them in full in public screenshots or support requests. Importing a subscription and importing a Config serve different purposes: a subscription provides server entries, while Config determines settings such as rules and policies. Pasting a webpage URL into a server address field, or treating a regular configuration file as a subscription link, can cause the import to fail.

Connected but webpages won't load? Check Global Routing

Global Routing determines how connection traffic is routed. Before troubleshooting, note your current settings, change one thing at a time, test, then restore the original setting. The three options below are routing modes within Shadowrocket, not different installation methods. Scene lets you use settings for a particular situation; when troubleshooting for the first time, don't change scene conditions and rules at the same time.

Config: Route traffic using rules

Recommended

Traffic is routed according to the rules and policies in the current Config. Rules are usually matched from top to bottom, and the matching rule's policy is applied. Traffic that doesn't match a rule is handled by fallback settings such as FINAL; it isn't necessarily sent direct. Before using this for everyday traffic, make sure the current configuration meets your needs.

Best for: Applying traffic rules with a clear configuration.

Proxy: Proxy mode

Routes traffic within the interception scope through the selected proxy. This can help narrow down whether a problem is caused by your rules. If a destination works in Proxy mode but not in Config, check the matching rule and policy instead of reinstalling the app.

Best for: Temporarily testing the selected proxy and troubleshooting routing rules.

Direct: Direct mode

Connects traffic within the interception scope directly to its destination, without using the selected proxy server. Selecting a server in the list doesn't mean Direct mode will use it. If access that requires a proxy fails in this mode, that alone doesn't indicate a problem with the installation package.

Best for: Checking direct access over your local network.

If neither Proxy nor Config can reach the destination, check the server settings, subscription update, and current network. If only certain domains fail, check the domain rules and DNS. Don't start by reinstalling, clearing your configuration, and changing routing modes all at once; you'll have no way to tell what changed the result. For help understanding configuration structure, see the rule reference.

Get Shadowrocket and continue setup

The iPhone and iPad versions cost $2.99 as a one-time purchase from the App Store; check the App Store listing for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Select your platform on the download page, then follow the setup guide to import a subscription from your service provider.

Download Shadowrocket