This guide is for anyone installing Shadowrocket on an Android phone or tablet, or dealing with an unresponsive download in WeChat, an installation blocked by the system, or connection issues after installation. Follow these steps in order: download in your system browser → authorize the app that opens the file → install → import your existing details → confirm the VPN connection. This helps distinguish download, installation permission, and connection setup issues without repeatedly downloading the APK.
1. Check Android download options and installation requirements
Shadowrocket is a closed-source commercial app available across platforms. The iPhone / iPad version is available on the App Store for a one-time payment of $2.99. The developer is Shadow Launch Technology Limited; check the App Store page for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. This guide covers installing the Android APK; for other devices, use the download option for your platform.
On your Android device, open the all-platform download page and find the Android section. The installer is provided on this site under /dl/shadowrocket/. Use the current link on the download page; don’t construct a URL from an old filename. Being able to open a webpage doesn’t necessarily mean your current browser can download APK files, which is one reason a page opened in WeChat may appear to do nothing.
- Check your device: These steps are for Android phones and tablets. An APK isn’t an installer for other operating systems.
- Check available storage: You’ll need space for both the downloaded APK and installation. If the system reports insufficient space, free up storage in Settings and try again.
- Check device restrictions: Devices managed by an organization, parental controls, or a work profile may block downloaded apps. Contact the device administrator if needed.
- Keep your service details: Installing the app doesn’t provide a connection service. You’ll need your own existing provider and subscription details to connect.
2. Download the APK in your system browser and install it
We recommend using your system browser to download and open the file. Android’s Install unknown apps permission is usually managed separately for each source app. Opening a download directly in the browser and opening it later in a file manager may require authorization for different apps. The steps below use common Android setting names; labels and menu paths may vary by manufacturer.
-
Open the download page
In your system browser, visit this site’s download page and tap the download button in the Android section. If you’re viewing the page in WeChat’s built-in browser, switch to your system browser using the steps in the next section.
-
Wait for the download to finish
Open Downloads in your browser and make sure the task is complete before tapping the APK. If the download is still in progress, canceled, or failed, don’t keep opening the incomplete file from your notifications.
-
Allow installation from this source
If the system says this source can’t install apps, tap Settings in the prompt. Go to Install unknown apps, enable Allow from this source for the app you’re using, then return to the installer.
-
Confirm the installation
On the system confirmation screen, check that the app is named Shadowrocket, then tap Install. If the system displays a specific risk or device policy warning, read the reason first. Don’t bypass it by disabling system-wide security protections.
-
Open the app and revoke permission if needed
When installation finishes, tap Open. If you don’t need this source to install other apps, return to Install unknown apps and turn off Allow from this source for it. The installed app will still open normally.
3. Still blocked after enabling Install unknown apps? Check which app needs authorization
A common scenario: the browser downloads the APK, but you open it from the Download folder in a file manager. Android then sees the file manager as the installation source, and the permission you granted to the browser doesn’t apply. Check the source app named in the current system prompt rather than enabling installation for every app.
Open from your browser
- Where to find the file
- Browser → Downloads → completed APK
- App to authorize
- Current browser
- Permission settings
- System Settings → Apps → Special app access → Install unknown apps
- Enable this permission
- Allow from this source
This is a general Android example. If you can’t find the setting, search Settings for “Install unknown apps.”
Open from a file manager
- Where to find the file
- File manager → Download → downloaded APK
- App to authorize
- Current file manager
- How to identify the source
- Check the source app named in the system warning
- After installation
- Revoke this source’s installation permission if needed
If the permission switch is unavailable, check device management policies instead of trying repeatedly with different apps.
Some manufacturers put this setting under Security, Privacy, or a dedicated app permissions page. The menu location may vary, but the principle is the same: identify the app that starts the installation, authorize only that source, and then return to the same file to continue. If your device is managed by an organization, you may not be able to change this setting yourself.
4. Download does nothing in WeChat? Switch to your system browser
WeChat’s built-in browser may restrict file types, download redirects, or handing files off to the system installer. If tapping the button opens no page, shows no download progress, and creates no file, switch browsers rather than assuming the APK is damaged. Reopening the page won’t resume a download that never started; tap the Android download button again.
- Open the menu in the upper-right corner of the current WeChat page and choose Open in browser or a similarly named option. The wording varies by device and WeChat version.
- If there’s no such option, copy the page address, open your system browser, and paste the address into its address bar. Check that the domain is still
shadow4iphone.com. - Go to the Android section of the download page and start the download again. If your browser asks whether to save the APK, review the prompt and confirm.
- Check the task status in your browser’s Downloads. Continue to installation and source authorization only after the download is complete.
If switching to your system browser still doesn’t start the download, first check whether regular webpages load. Then check whether the browser shows a paused download, low storage, or a system restriction. You can try switching between your Wi-Fi and mobile data once. Changing networks usually won’t help if a device management policy is blocking downloads. Don’t use files forwarded in chats or downloads from unknown mirrors instead of this site’s download page.
5. Troubleshoot installation errors based on the system message
“Download failed,” “There was a problem parsing the package,” and “App not installed” occur at different stages. Note the exact message, source app, and how you opened the file; that’s more useful for troubleshooting than simply saying “it won’t install.” Follow the checks below in order. Different messages can have different causes.
| What you see | What to check first | What to do next |
|---|---|---|
| Downloads shows failed or paused | Network, available storage, and browser download status | Fix the relevant issue, then download the APK again from this site’s download page and wait for it to finish. |
| Message says this source isn’t allowed to install apps | The app you used to open the APK | Allow this source under Install unknown apps, then return to the installer. |
| Message says there was a problem parsing the package | Whether the file is complete and your device meets the current requirements on the download page | Delete the incomplete file and download it again. If it still fails, note the system message; changing the file extension won’t help. |
| Message says the update is incompatible or can’t be installed over the existing app | Where the existing app came from and whether the system blocks updates or downgrades | Keep your existing configuration and subscription details first, then decide how to proceed. Don’t uninstall the app immediately and risk losing local data. |
| The install switch is grayed out | Work profile, parental controls, or device management policies | Ask the device administrator whether installation is allowed. Avoid repeatedly trying different source apps. |
6. First connection after installation and choosing Global Routing
If Shadowrocket opens, installation is complete. Next, import your existing connection details: in Home, tap “+” in the upper-right corner, set Type to Subscribe, paste your own subscription link, save, and update the subscription. The example URL https://example.com/sub?token=xxxx is for formatting only and isn’t a working subscription. Treat the token in a real link as a private credential.
Once your list appears, select the server you need and turn on the connection switch. The first time you connect, Android will show a system VPN confirmation. Make sure Shadowrocket is the app requesting it before tapping Allow. This confirmation establishes a local VPN connection and is separate from Install unknown apps. Another VPN connection may replace the current one. If your subscription is empty or fails to update, troubleshoot the subscription details and update first; reinstalling the app isn’t necessary.
Config
RecommendedSelect Config under Global Routing. Traffic is routed according to the rules in the currently active configuration. Check your configuration in Config before use. FINAL determines where unmatched traffic goes; it doesn’t automatically send all local traffic Direct.
Best for: everyday use with an existing rule configuration when you need traffic routed by destination.
Proxy
Select Proxy under Global Routing to route traffic handled by the app in proxy mode. This can help isolate differences caused by rule selection, but it won’t fix an invalid subscription, incorrect server settings, or an unreachable service.
Best for: checking rule-related issues temporarily when you already have a working server.
Direct
Select Direct under Global Routing to handle traffic as a direct connection. Turning on the connection switch doesn’t guarantee that traffic passes through the selected proxy server. If you’re troubleshooting a connection that’s on but traffic isn’t going where expected, first make sure Direct isn’t selected.
Best for: checking how your current network behaves directly and comparing it with a proxy connection.
Rules in Config are usually matched from top to bottom. For example, DOMAIN-SUFFIX,example.com,PROXY sends requests matching that domain suffix to PROXY, while FINAL,DIRECT uses DIRECT when none of the earlier rules match. These examples explain the syntax; you don’t need to change your configuration to install the APK. After a new installation, first check that your connection details are valid, a server is selected, and Android has allowed the VPN connection.
7. Android installation FAQ
I tapped the download button several times in WeChat and nothing happened. Should I keep waiting?
First check system notifications and your browser’s Downloads to see whether a task actually started. If there’s no task, stop tapping. Copy the page address into your system browser and restart the download from this site’s download page. A WeChat page that hasn’t changed doesn’t mean a download is in progress.
Why does my file manager need authorization if I already authorized my browser?
Install unknown apps permissions are managed by source app. Your browser and file manager are separate sources. Open the completed file from your browser’s Downloads, or authorize only the file manager you’re using. Revoke the permission afterward if needed.
The app installed, but the Home list is empty. Did installation fail?
An empty list doesn’t mean installation failed. First check that you imported your own subscription and updated it successfully. If the link is expired or returns no content, ask your original service provider to check its status. This site does not provide, sell, or recommend servers or subscriptions.
The connection switch is on. Why can’t I access anything?
Check these in order: Android VPN permission, the server selected in Home, the Global Routing mode, and your provider’s service status. If another VPN is running, confirm which connection is actually active. Don’t assume every network issue is caused by APK installation permissions.
Shadowrocket downloads and setup guides for all platforms
The iPhone / iPad version costs $2.99 on the App Store as a one-time purchase; check the App Store page for system requirements. The Mac (Apple silicon / Intel), Windows, Android, and Linux versions are free. Choose your device on the download page, then follow the guide to import your existing details. Buying the app does not include a service plan.