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.
- Check available storage: Your device needs room for both the downloaded file and the installed app data. If you see a low-storage warning, first remove files you no longer need from your Downloads folder.
- Check the download status: The browser’s download manager should show the task as complete, not paused, failed, or waiting for a network connection.
- Check the file type: The file should have the
.apkextension. If it opens as a web page, return to the download page and try again. Don’t change the file extension. - Check device restrictions: Work profiles, managed devices, and child accounts may restrict app installations from certain sources. Contact the device administrator to resolve these restrictions.
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.
-
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.
-
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.
-
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.
-
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.
-
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.
- Open the menu in the upper-right corner of the WeChat page and choose “Open in Browser.” If that option isn’t available, copy the current download page address.
- Open your system browser, paste the address into the address bar, and visit the page. Confirm it’s still this site’s download page, then select Android.
- When the download is complete, open the file from “Downloads” or “Download Manager” in that browser. The browser is usually the source that needs installation permission.
- If you open the APK from the Downloads folder using the system Files app, Android may ask you to allow installs for Files as well. That’s a separate source permission.
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
RecommendedRoutes 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.
- Subscription is empty: Check that the address was copied in full and contains no extra spaces or line breaks, then update it again.
- Rules aren’t taking effect: Check which Config is active and make sure a broader rule isn’t matching before the rule for your destination. FINAL is a fallback rule and should appear at the end of the relevant rule list.
- Disconnects when the screen locks: Check Android’s battery restrictions for Shadowrocket. Allow background activity if needed, then test again with the same screen-lock scenario.
- Reconnects automatically: Along with the system VPN settings, check any Settings → On Demand conditions configured in the app. For initial troubleshooting, connect manually.
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.