This guide is for anyone installing Shadowrocket on an Android device or troubleshooting an unresponsive download in WeChat or an installation blocked by the system. Follow the steps in order: download in a browser, allow installation for the app that opens the file, confirm installation, then configure a service you already have. A completed download, a successful installation, and a working proxy connection are three separate checkpoints; troubleshoot them separately.
Check the platform and download source first
Shadowrocket is available for Android. Here, APK means an Android application package; it is not a configuration file and does not include a ready-to-use proxy service. Select the Android option on the site’s Download page. Installation packages are served from /dl/shadowrocket/; this guide does not hard-code a file URL, so use the current download button on the Download page.
There are two ways to get Shadowrocket: the iPhone / iPad version costs $2.99 as a one-time purchase on the App Store. The developer is Shadow Launch Technology Limited, and system requirements are as listed on the App Store page. The versions for Mac (Apple silicon / Intel), Windows, Android, and Linux are free. You do not need to buy the iPhone / iPad version to install the Android version.
- Check that the address bar shows
shadow-rule.com, then open the Android section of the Download page. - Check your browser’s download history and confirm the download is complete. A download icon appearing in the notification shade is not enough.
- Keep your system’s security checks enabled. If you see a specific security warning, stop and verify the source and file before continuing. Do not disable device protections across the board.
- Devices managed by an employer or school may block users from installing apps. Check with your device administrator first.
Download and install the APK in a browser
Use your system browser to download the file and open it for the first time. This makes it easier to identify which app needs permission to install it. Android menus may differ slightly by device manufacturer. English setting names are shown below to help you find them; localized systems may display translated names.
-
Open the Download page
In your system browser, go to the site’s Download page and find the Android section. Don’t use an old file URL from a search result snippet or mistake a subscription URL for an APK download link.
-
Download the file
Tap the Android download button. If your browser asks you to confirm saving the file, make sure you initiated the download, then confirm. Wait until the task is marked complete in Downloads.
-
Open the APK
Open the APK you just downloaded from the same browser’s Downloads. If the system says apps from this source are not allowed, open Settings from the prompt and note the name of the source app listed.
-
Allow this source
On that source app’s Install unknown apps page, enable Allow from this source, then return to the installer. Grant permission only to the browser you used; there is no need to enable it for every browser or file manager.
-
Confirm installation
Tap Install, wait for the system to confirm installation is complete, then tap Open. After installation, you can return to the same permissions page and turn off Allow from this source. This won’t uninstall Shadowrocket.
If the page says the download has started but your browser history shows no complete file, troubleshoot the download first. Tapping Install repeatedly won’t restore data that hasn’t finished downloading. Likewise, allowing installation won’t fix a file made incomplete by a network interruption.
Where to allow installation from unknown apps
On Android 8.0 and later, installation permissions are usually granted per app. The “source” is the browser or file manager requesting to open the APK, not Shadowrocket itself. If you download the file in a browser and then open it from a file manager, the system may require a separate permission for the file manager.
Find it in Settings
- Common path
- Settings → Apps → Special app access → Install unknown apps
- Select the app
- The browser or file manager you used to open the APK
- Permission toggle
- Allow from this source
- Can’t find the setting?
- Search Settings for Install unknown apps
Menu paths depend on the device manufacturer. Prefer the setting shown in search results or the system prompt over a generic path.
Know the difference between these permissions
- Install source permission
- Allows a specific app to ask the system to install an APK
- VPN connection permission
- Confirmed separately by Android the first time you connect
- Revoke permission after installation
- Turn off Allow from this source for the source app
- Policy restrictions
- If the toggle is disabled or the system says an administrator has blocked it, contact your device administrator
Installation permission is not VPN permission, and neither one confirms that a remote service is configured correctly.
Some devices place this setting under security options or show an explanation and confirmation screen before enabling it. Follow the on-screen instructions; don’t change unrelated permissions while looking for a menu with a similar name. If a work profile or device management policy blocks installation, switching browsers usually won’t remove the restriction.
Can’t download in WeChat? Try this
WeChat’s built-in browser handles downloads differently from a standalone browser. No response after tapping, a webpage appearing instead, or no save-file prompt does not necessarily mean the APK is faulty. First open the Download page in a standalone browser, then check its download history.
- Open the site’s Download page in WeChat, tap the menu in the top-right corner, and choose “Open in browser.” The exact wording depends on your version of WeChat.
- If that option isn’t available, choose “Copy link,” leave WeChat, open your system browser, and paste the link into the address bar.
- Check that the browser’s address bar still shows the site’s Download page, then open the Android section and tap the download button again.
- Check the task in the browser’s Downloads. If an earlier download is incomplete, identify the new task before opening a file so you don’t accidentally open the partial one.
If the standalone browser can’t start the download either, first check whether other websites load, then try switching between Wi-Fi and mobile data. Mobile data downloads may incur charges. Once the connection is back, start the download again. Don’t just rename a failed file to .apk; changing the extension won’t turn an error page or incomplete file into an installable package.
Installation and first-launch troubleshooting
I’ve allowed it already. Why am I being sent to Settings again?
Check the source app named in the system prompt. If you downloaded the APK in a browser but opened it from a file manager, the file manager may need permission instead. Open the Install unknown apps page for the app named in the prompt; checking only the browser’s previous setting may not help.
What if Android says the file can’t be parsed or is corrupted?
Delete the incomplete or failed download, download it again from the site’s Download page, and wait until Downloads shows it is complete before opening it. If the parse error persists, note the full system message, device model, and Android version, then check the compatibility notes on the Download page. Repeatedly granting installation permission won’t fix a parse error.
The update says the app wasn’t installed. Should I uninstall it first?
Don’t uninstall it right away. Check available storage, the installation source, and the specific reason shown by the system. A signature mismatch between the installed app and the new package, or system incompatibility, can cause installation to fail. Uninstalling may erase local configuration. Save any configuration you already have first, and don’t send files containing credentials to anyone.
The app opens, but there’s no internet. Did the installation fail?
If the app opens normally, focus troubleshooting on configuration and connectivity. Import a service configuration you already have, then confirm the Android VPN connection request. Also check whether another VPN is already using the connection. Successful installation alone doesn’t confirm that the server address, credentials, DNS, or routing settings are correct.
When reporting an issue, specify which stage is failing: “download won’t start,” “system installer error,” “app won’t launch,” or “can’t access sites after connecting.” Include the exact error message, without personal information. Don’t share server passwords, full subscription URLs, or account tokens. Identifying the stage is usually more useful than repeatedly downloading the file.
Check configuration and routing after installation
On first use, check your existing service entries in Home, the active configuration file in Config, and then Global Routing. Importing a subscription only loads a set of configurations; updating it doesn’t mean every service is ready to connect. Check each item on your current network, and avoid changing multiple settings at once so you can identify the cause of any issue.
Config
RecommendedUse the rules in the current configuration to determine how requests are handled. The outcome depends on the rule contents and order; it is not automatically “direct for everything else.” Pay particular attention to the final policy set by FINAL.
Best for: everyday use after confirming that you have clear routing rules and a working basic connection
Proxy
Routes requests selected for proxy handling through the proxy. This can help distinguish rule-matching issues from proxy connection issues, but it won’t fix an incorrect password, an invalid service, or a system network problem.
Best for: temporarily troubleshooting routing behavior when you’ve already selected a working service
Direct
Uses a direct connection without forwarding requests through the selected remote proxy. If a destination is unreachable on your current network, switching to Direct may not make it accessible. That doesn’t mean the app was installed incorrectly.
Best for: comparing with direct access on your current network
Scene in Global Routing provides routing choices for specific scenarios. Understand the existing scene settings before using it, and avoid changing it during initial troubleshooting. For each test, record the current mode and selected entry, change only one condition at a time, then restore your intended settings after comparing results.
- Check protocol parameters first: Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard use different parameters. Don’t copy a password or key from one protocol into a different protocol’s field.
- Then check the subscription result: After updating, check whether the expected entries appear in Home. If the update fails, check your connection and the link you already have. Don’t use the APK download page URL as a subscription URL.
- Finally, check the rules:
DOMAIN-SUFFIX,example.com,PROXYis an example of a domain suffix rule, andFINAL,PROXYsets the final policy. Rules are matched in order. The example domain does not indicate that this site provides a service. - Check automatic connections separately: To review On Demand, go to Settings → On Demand and check its conditions. It is not an installation permission and does not replace Android’s VPN connection confirmation.
The installation is complete when Downloads shows the file is complete, the system confirms installation, and the app launches. Next, follow the Quick Start to configure a service you already have. For routing and settings, see the Settings Reference. Troubleshoot connection issues separately from installation permissions.