Shadowrocket Android Installation Guide: Download the APK, Allow Unknown App Installs, and Fix WeChat Download Issues

Download the arm64 APK, allow your browser to install apps from this source, and complete setup. Includes steps for switching from WeChat to your system browser when downloads fail.

At a Glance

To install Shadowrocket on Android, download the arm64 APK from our download page, then allow the browser or file manager you use to open it to install apps from that source. This guide covers first-time installation, blocked installs, and downloads that fail in WeChat. Follow the steps in order to identify whether the issue is with the file, system permissions, or later configuration.

1. Check Your Device and Download Options

The Android version is provided as an APK, with an arm64 download option on our download page. arm64 refers to the processor and app runtime architecture, not the Android version. A 64-bit processor does not necessarily mean the installed system can run 64-bit apps; some devices use a 32-bit system. If you see a compatibility warning, check the system architecture as well.

Open the Shadowrocket download page and find the Android section. Do not try to find other packages by renaming files or changing characters in the download URL. All downloads in this guide start from the download page; installation files are served from /dl/shadowrocket/.

2. Download and Install the APK in a Browser

Use your system browser for the full process so you can find the download and identify which app needs permission. Wait for the browser to confirm the download is complete before opening the file. Tapping a download button on a webpage does not mean the file has finished downloading.

  1. Open the Download Page

    Open our download page in your system browser, find the Android section, and select the arm64 APK. If you are viewing this page in WeChat, switch browsers as described in the next section.

  2. Wait for the Download to Finish

    Check the task in your browser’s Downloads list. The file should have a .apk extension. If it is still downloading or shows an error, finish or retry the download before opening it.

  3. Allow Installs from This Source

    If the system says this source cannot install apps when you open the file, tap Settings in the prompt and enable Allow from this source. This setting applies only to the app you are using as the source.

  4. Return to the Installer

    Use the system Back action to return to the installation screen. Confirm the app is named Shadowrocket, then tap Install. If the installer has closed, reopen the APK from the same browser’s download list.

  5. Open the App for the First Time

    When installation finishes, tap Open or launch Shadowrocket from the system app list. Once the app opens, you can return to the source permissions page and turn off the temporary install permission.

Permission to install apps from a source is separate from VPN connection permission. The first controls whether a browser or file manager can start an installation. Android asks separately when the app starts a system VPN connection. Allowing installation does not automatically approve a later connection request.

3. Fix Downloads That Do Nothing in WeChat

Downloads may work differently in WeChat’s built-in browser than in your system browser. If tapping Download produces no file, leaves you on the same page, or shows a restriction, switch the browser rather than tapping repeatedly. Start troubleshooting the installation only after the file appears as complete in the browser’s download list.

  1. Open the menu in the upper-right corner of the current WeChat page and look for Open in Browser or a similarly named option. The wording may vary between devices and WeChat versions.
  2. If that option is missing, tap Copy Link, switch to your system browser, and paste the address into the address bar. Make sure the address is on shadowrocket9.com, then open the download page.
  3. In your system browser, tap the Android arm64 download option again and check the browser’s own download list for progress. Tapping a link in WeChat may not create a download task that can continue in your browser.
  4. After the download finishes, open the APK in the same browser. If the system asks for installation permission, grant it to that browser instead of looking for a setting in WeChat.

4. Allow Unknown App Installs: Which App Needs Permission?

On Android, “unknown apps” refers to the installation source, not an assessment of the app’s features. Permissions are managed separately for each source app. If you open the APK in a browser, check the browser’s permission; if you open it from a file manager instead, Android may check that app’s permission. If an install is still blocked after you enabled permission, first verify which source app the system identifies.

Check System Settings

Common path
Settings → Apps → Special app access → Install unknown apps
Select
The browser or file manager used to open the APK
Permission toggle
Allow from this source
Can’t find the setting
Search Settings for “Install unknown apps,” or use the settings link on the installation warning screen

Manufacturers may change the settings layout. Follow the path and source name shown on your device.

Check the Installation Status

Still blocked after allowing permission
Check that the source app shown in the warning is the same app you just allowed
Nothing happens after returning
Reopen the completed APK from the original browser’s download list
Can’t change the toggle
Check whether the device is managed or restricted by a work profile or parental controls
Installation complete
You can turn off the temporary install permission and keep Shadowrocket installed

Turning off permission to install from a source does not uninstall the app or replace system VPN permission controls.

On a device managed by an employer or school, an administrator may control these settings. Contact the device administrator to confirm whether installation is allowed. Do not try to bypass a policy by repeatedly clearing system settings or disabling other security features. Read any security warning carefully to determine whether it concerns an unapproved source, an incompatible file, or a management restriction.

5. First Launch and Checks Before Connecting

If Shadowrocket opens, installation is complete. Next, add your existing configuration in Home. Use Config to manage rule configurations and Settings to change app preferences. Button locations may differ in the current Android version; do not assume they match the layout on other platforms.

The Global Routing mode affects how traffic is handled after connection. These are three commonly used modes in Shadowrocket. Choosing Proxy will not fix incorrect server settings; choosing Config requires a working set of rules and policies in the active configuration.

Config

Recommended

Uses the rules in the active configuration to select a policy. This does not mean all unmatched traffic goes direct; traffic that matches no earlier rule is handled according to settings such as FINAL.

Best for: Using a verified rule configuration to route traffic by rule day to day

Proxy

Uses the proxy mode for all traffic handled by the app. This can temporarily rule out rule-based routing as a factor during testing, but the selected connection and your network must still be working.

Best for: Short-term troubleshooting to see whether rule selection is causing the issue

Direct

Uses a direct connection for traffic handled by the app. This does not test whether a proxy server works. A system VPN connection indicator does not mean a request is going through a proxy server.

Best for: Comparing access over your current network without a proxy

6. Common Installation and First-Use Questions

Start by noting the full error message, then troubleshoot the stage where it occurs. If installation is not complete, there is no need to change protocol settings or rules. If the app opens but a particular website does not, reinstalling is not the first step. Narrow the issue down to downloading, installing, opening, or connecting to avoid repeating steps unnecessarily.

“There was a problem parsing the package.” What should I do?

First check whether the browser says the download is complete. Delete incomplete or duplicate failed files, then download the APK again from our download page. If the same message appears, note your Android version and device architecture, then check the package compatibility information. Renaming the file or repeatedly changing permissions will not fix a file parsing error.

Why does Android ask for permission again after I allowed my browser?

Check the source name in the system prompt. If you switched to a file manager to open the APK, the source has changed from the browser to the file manager. You can reopen the file from the original browser’s Downloads list or grant permission to the source app you are actually using, then turn it off after installation.

“App not installed.” Should I delete the old app first?

Do not delete an existing app as the first step. Check available storage, device compatibility, and whether Android reports a package conflict. If Shadowrocket is already installed, save your configuration using the app’s backup or export feature before deciding what to do next. Uninstalling may erase local data and should not be your first step.

The app opens, but the connection fails. Did installation go wrong?

If you can open Home, installation is usually complete. Check that you imported your own configuration, selected an entry, and approved the system VPN request. Then check the Global Routing mode and server settings. An empty list or incorrect credentials do not mean the APK failed to install.

The download is complete. Do I need to keep the APK?

Once you confirm the app is installed and working, you can delete the downloaded file from your browser’s download list or file manager to free up storage. Deleting the APK does not uninstall the app. To download it again, return to our download page. Before installing an update, save important configuration and read the system’s update prompt.

How to Get Shadowrocket

The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Visit the download page for platform-specific instructions, then see the tutorials for help with initial setup.

Go to Downloads View the Guide
Download Shadowrocket