Shadowrocket Android Installation Guide: Download the APK and Allow Unknown App Installs

Download the Shadowrocket Android APK from this site. Allow your browser to install unknown apps in Settings. If WeChat won’t download it, open the link in your system browser.

At a glance

This guide walks first-time Android users through installing Shadowrocket: downloading the APK, allowing installs from the chosen source, completing installation, and importing an existing configuration. It also explains the difference between browser install permission and VPN access, and covers WeChat download issues, APK parsing errors, and update conflicts.

1. Check the platform and how to open the download

The Shadowrocket Android APK is available from this site’s download page. Open the Shadowrocket download page in your system browser, select Android, and start the download. The download page provides the current installation package, so there’s no need to guess a download URL from search results or rename another platform’s installer with an .apk extension.

There are two ways to get Shadowrocket: the iPhone / iPad version costs a one-time $2.99 on 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 steps below are for Android; for other devices, select the corresponding platform on the download page.

2. Download the APK and allow installs from this source

On Android, permission to install unknown apps is usually granted separately to each source app. Allowing it for your browser doesn’t grant the same permission to a file manager. The app named in the system prompt should match the app you’re using to open the APK. Menu names vary by device; when installation is blocked, use the prompt to open the relevant settings page.

  1. Open the download page

    Open this site’s download page in your system browser and select Android. Wait for the browser to confirm the download is complete, then tap the APK in your download history.

  2. Open the permission settings

    If Android says your device isn’t allowed to install apps from this source, tap “Settings” in the prompt. You can also search Settings for “Install unknown apps” and select the browser you used.

  3. Allow this source

    Turn on “Allow apps from this source” or “Allow installation of unknown apps.” If you opened the APK from a file manager, grant permission to that file manager instead of repeatedly changing your browser’s setting.

  4. Return and install

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

  5. Revoke install permission

    After installation, you can return to the same source permissions page and turn off the permission. This won’t remove Shadowrocket or revoke any separate VPN access it requests later.

A common settings path is “Settings → Apps → Special app access → Install unknown apps → Browser → Allow apps from this source.” If your device uses different menu names, search Settings for “unknown apps.” Don’t enable this permission for unrelated apps, and there’s no need to disable system security checks.

3. If WeChat won’t download the APK, switch to your system browser

WeChat’s built-in browser may restrict file downloads or fail to hand them off to your system browser. You may see no download in your history, remain stuck on a prompt page, or be unable to find the file after returning to the chat. First switch how you open the link; don’t repeatedly tap Download and create multiple incomplete tasks.

Use your browser’s download history to identify where the problem occurred. If there’s no entry, check how you opened the link and your network. If the download is incomplete, try again. Only open install permissions if the completed download is blocked by the source setting. Clearing Shadowrocket’s app data won’t help if the browser hasn’t downloaded the file.

4. Understand the difference between install permission and VPN access

Install-source permission lets a specific app start the installation process. The system VPN connection request shown when you first connect creates a VPN tunnel on your device. These permissions serve different purposes and can’t replace each other. If installation is complete but you haven’t connected, there’s no need to repeat the installation.

Install-source permission

System settings path
Settings → Apps → Special app access → Install unknown apps
App to authorize
The browser or file manager used to open the APK
When it appears
When you open the APK and start installing
After installation
You can turn off install permission for that source

Menu names vary by system. Use the app name shown on the blocked-install screen to identify which app needs permission.

VPN connection permission

How to open
Shadowrocket → Home → Connection toggle
App to authorize
Shadowrocket
System prompt
A request to establish a VPN connection
Before connecting
Check that you have a configuration, the right connection selected, and no other VPN is in use

Accept the system connection request only when you initiate the connection and have confirmed the app’s identity.

Android usually allows only one active VPN per user at a time. If another VPN is running, starting Shadowrocket may disconnect it or be affected by Android’s “Always-on VPN” setting. If the connection drops immediately, check the system’s VPN settings for an existing connection before assuming the APK installation failed.

5. Import a configuration and check routing

After opening Shadowrocket, check whether Home already has a usable item. If you have your own subscription, tap “+” in the upper-right corner of Home to open the add screen. Set Type to Subscribe, paste your subscription URL, save it, and update the subscription. The token in a subscription URL is an access credential; don’t share it in public chats or screenshots.

Home is for selecting a connection item, Config is for managing rule configurations, and Settings is for adjusting app preferences. Importing a subscription and configuring rules are separate tasks: seeing a connection item in Home doesn’t mean Config has been restored from an older device. For your first test, check the selected item and Global Routing before connecting.

Config

Recommended

Routes connections according to the active Config rules. DIRECT means a connection is made directly; PROXY sends it through the corresponding proxy policy. The result depends on rule order and which rule matches the destination.

Best for: everyday use with a complete ruleset and traffic routed by destination

Proxy

Sends intercepted connections through the proxy route. Temporarily switching to this mode can help determine whether an issue is caused by rule selection or the connection item itself.

Best for: briefly testing the selected connection and ruling out rule-related issues

Direct

Handles intercepted connections as direct connections. In this mode, whether a web page uses a proxy can’t tell you if your subscription imported successfully.

Best for: comparing against the device’s regular network to isolate differences between the proxy route and local network

Change one setting at a time while testing. Note the original Global Routing mode, select one of your own connection items, connect, and visit the same test page. If Proxy works but Config doesn’t, check the active Config rules and their policy targets. If both modes fail, first check that the configuration is complete, the connection item works, and system VPN access has been granted.

6. Fix installation errors, update conflicts, and maintain the app

Troubleshoot installation errors by stage. A file parsing error usually occurs before installation; a source restriction appears when installation starts; and a configuration error occurs after the app has opened. Note the full system message first, then take the relevant action to avoid repeated uninstalling and potential configuration loss.

The download is complete. Why am I still seeing an installation blocked message?

Check whether the blocked-install screen names your browser or file manager. Go to “Settings → Apps → Special app access → Install unknown apps,” grant permission only to the app you used to open the file, then reopen the same APK.

It says the package couldn’t be parsed. Should I rename the file?

Don’t change the extension. Delete the incomplete or corrupted download, return to this site’s download page, and download the file again. Make sure the task completes. If it still fails, check that the system and architecture requirements listed on the download page match your device.

What if an update conflicts with the existing app?

Stop repeated installation attempts and save the system message. Signature mismatches and incompatible installation packages require different fixes. Keep the existing app, back up your configuration, and make sure it can be restored before taking further action. Don’t start by uninstalling.

The Install button is greyed out. What should I do?

Close floating windows, screen filters, or assistive overlays covering the installer, then reopen the APK. If the system says a device management policy blocks installation, contact your administrator instead of changing unrelated permissions.

Will I need to import my subscription again after future updates?

A normal in-place update typically keeps app data, but back up your configuration beforehand. Get future installation packages from this site’s download page. After updating, check the items in Home, the active Config, and Global Routing, then test the connection.

After installing and testing, you can delete the APK from Downloads if you no longer need it, revoke your browser’s install-source permission, and store a backup of your configuration safely. When reporting an issue, share the system message, steps taken, and whether the download completed. Remove subscription URLs, passwords, and other access credentials first.

Download Shadowrocket