This guide is for anyone installing Shadowrocket on an Android device. Follow the steps in order: download the APK, open it in a browser or file manager, allow installation from that source, then approve the VPN connection on first use. If a download won’t start, installation fails, or you can’t access sites after connecting, troubleshoot the relevant step. Importing connection details later requires details from a service you already use; installing the app does not provide them.
1. Check platform availability and permissions
Shadowrocket for Android is free. Get the installer from the Android section of our downloads page. iPhone and iPad: $2.99 one-time purchase on the App Store. Mac (Apple Silicon and Intel), Windows, Android, and Linux: free. On Android, choose the Android installer; renaming a file for another desktop platform won’t make it installable.
Android installation involves two permissions that are easy to confuse. First, Android checks whether the browser or file manager you’re using can start an app installation. After the app is installed, Android asks you to approve its VPN connection the first time it connects. The first permission allows the installer to run; the second allows the app to create a system VPN connection. They are separate permissions.
2. Download and install the Android APK
These steps use an Android system browser as an example. Labels can vary by Android version, device manufacturer, and browser; the English paths shown are common system UI terms, so follow what appears on your device. Downloading and installing are separate steps: after the browser finishes downloading the file, you usually need to tap it to open the installer.
-
Open the downloads page
In your system browser, visit our downloads page. Check that the address bar shows
shadowrocketlite.com, then go to the Android section. Don’t start the installation from a chat attachment or a file forwarded from an unknown source. -
Save the installer
Tap the Android download button and confirm the save prompt in your browser. The installer is served from our
/dl/shadowrocket/path. Wait until the browser’s Downloads list shows that the download is complete; don’t open a temporary file that is still downloading. -
Open the installer
Open Downloads in your browser and tap the
.apkfile you just downloaded. You can also open it from the Downloads folder in the system Files app, but then Files is the app that starts the installation and may need its own source permission. -
Allow installation from this source
If Android blocks the installation, follow the prompt to open Settings → Apps → Special app access → Install unknown apps. Select the browser or file manager you used and turn on Allow from this source, then return to the installer.
-
Finish installing
Tap Install. When Android finishes, tap Open. Once you’ve confirmed the app opens, you can return to the source permission page and turn off Allow from this source. Revoking this permission won’t uninstall the app.
If your device doesn’t show Special app access, search Settings for “Install unknown apps” or “unknown sources.” Don’t look for this switch in Shadowrocket’s Settings: it’s an Android system permission, not an in-app setting.
3. Fix downloads that won’t start in WeChat
WeChat’s built-in browser handles downloads differently from your system browser. If tapping the button leaves the page unchanged, shows a loading indicator, or doesn’t create a download task, that doesn’t necessarily mean the installer is faulty. First open the page in your system browser, then check whether the download starts. This is more useful than repeatedly tapping the same button.
- Open the menu in the top-right corner of the WeChat page and choose “Open in Browser” or a similarly named option. The wording may vary by device.
- If the menu doesn’t include that option, copy the address of the downloads page, open your system browser, paste the address, and go to the Android section.
- In your system browser, tap the Android download button again. Check Downloads for a file showing its size, progress, or completed status.
- If no download starts, check whether you need to sign in to a network access page, whether the browser reports a save error, and whether your device has enough free storage.
4. Why installation can still fail after allowing unknown apps
Recent Android versions usually manage installation permissions separately for each app that starts an installation. For example, if you download the file in a browser but open it from Files, Android may check Files’ permission rather than the browser’s. When you see a warning, note the name of the source app shown and update the permission for that app.
Why is Android still blocking the install after I allowed it in my browser?
Check whether you opened the APK from a file manager. If so, go to Settings → Apps → Special app access → Install unknown apps, select that file manager, and allow installation from this source. Or open the file from Downloads in the browser you already approved.
Does a “Can’t parse package” error mean I haven’t allowed the right permission?
Not necessarily. A parsing error can also mean the download is incomplete, the file is damaged, or the installer isn’t compatible with your device. Delete the incomplete file and download it again from our downloads page. Check that the package’s architecture matches your device; changing the file extension won’t help.
Should I uninstall an older app if Android says “App not installed”?
Don’t uninstall it right away. Note the full error message and check your available storage and whether the download completed. If Android explicitly reports an app conflict or a signature mismatch, back up your existing configuration and check where the older app came from before resolving the conflict. Uninstalling may delete local configuration.
What if my work phone doesn’t let me allow installs from this source?
Check whether a work profile, parental controls, or an organization’s device management policy restricts your device. If a management policy locks the setting, ask your device administrator whether installation is allowed. Don’t bypass the restriction by disabling system protection or changing unfamiliar security settings.
Read each Android security warning carefully. If the file source, app name, or installation behavior doesn’t match what you expect, stop and verify the download on our downloads page. Allowing an app to start installations doesn’t mean every file it downloads is safe to install. Turning off the temporary permission afterward helps control future installations.
5. Import connection details and check your first connection
If the app opens to Home, installation is complete. Whether sites are reachable through a selected route also depends on your connection details, VPN permission, and Global Routing settings. Protocol, address, port, password, and TLS parameters must match the details you already have. Don’t infer a real configuration from an example port or protocol name.
- If you already have a subscription, tap “+” in the top-right corner of Home to open Add Server. Set Type to Subscribe, enter your own subscription URL, save it, and update the subscription. For reference only,
https://example.com/sub?token=xxxxis a placeholder, not a working subscription. - If you already have details for an individual server, choose the matching protocol in Add Server and fill in the fields. Don’t enter a subscription URL in the server address field or use a server port as a subscription update setting.
- On Home, select an imported item and turn on the connection. The first time, Android displays a VPN connection request. Confirm that it’s from the Shadowrocket you just installed, then approve it as prompted.
- Check the connection status and Global Routing on Home. If you use rule-based routing, confirm the intended configuration is selected in Config. Then test a page you’re authorized to access.
A VPN icon or connected status only indicates that the system connection is established; it doesn’t guarantee that the remote server, DNS, or destination site is reachable. If another VPN connection is already active, check whether it’s occupying the system VPN slot. In general, regular apps can’t maintain multiple independent system VPN connections at the same time in one user profile.
Troubleshoot subscription update failures separately from APK installation failures. An update failure happens after the app is running; check that the URL is complete, access is still authorized, and the network can reach it. An installation failure happens at the Android system stage; check the source permission, whether the file downloaded completely, and device compatibility. Reinstalling the app usually won’t fix an invalid subscription URL.
6. Choose a Global Routing mode after installation
These options are Shadowrocket routing settings. They help distinguish a successful installation from traffic being handled as expected. Config, Proxy, Direct, and Scene in Global Routing are different options. Scene switches related settings for a preset scenario; for your first test, focus on the first three.
Config
RecommendedRoutes traffic according to the rules in the currently selected configuration. The result depends on rule order and policy. Requests that don’t match a rule don’t necessarily go direct; check what FINAL points to at the end of the configuration.
Use when: You have a trusted configuration and understand what it does, and want to route traffic by rules day to day.
Proxy
Sends connections within the client’s handling scope through the selected proxy. This can help you check whether an issue is related to rule matching. It won’t fix incorrect server settings or replace valid connection details.
Use when: You have a working server and want to briefly troubleshoot rule selection under Config.
Direct
Sends connections within the handling scope directly, so you can check how the network behaves without the selected proxy. Selecting a server does not mean Direct requests go through that server.
Use when: You want to compare local network connectivity temporarily and check whether the issue is with the proxy route.
For example, if the configuration includes DOMAIN-SUFFIX,example.com,DIRECT, traffic matching that domain suffix uses DIRECT. FINAL,PROXY assigns the PROXY policy to traffic that didn’t match an earlier rule. Understanding the difference helps avoid mistaking a routing result for an Android installation problem. The policy names used in your configuration must exist; don’t replace your own settings based on an example.
- If only certain sites are affected, check Global Routing and which Config rules match, then investigate DNS and the destination site.
- If all proxied requests fail, check that the server is working, the authentication details match, and your current network can reach the server.
- If the connection drops after switching networks, reconnect in the foreground and check Android’s prompt. Then review battery management settings; don’t start by changing protocol parameters.
7. Updates and post-install checklist
For future updates, return to the Android section of our downloads page. Back up your configuration and make sure the download is complete before installing over the existing app. An update will usually keep data if the app signature and version allow it, but this isn’t a substitute for a backup. If Android explicitly refuses to install, read the error first instead of repeatedly trying files from unknown sources.
- Download source: Confirm the address bar shows our domain and the Android installer comes from a site-hosted path linked from the downloads page.
- Source permission: Allow installation only for the browser or file manager that actually opens the APK. You can revoke the permission after installation.
- System connection: When connecting for the first time, confirm which app requested VPN access and check for another active VPN connection.
- App settings: Select the right item in Home, confirm the configuration in Config, and make sure Global Routing matches your intended use.
- Troubleshooting notes: Keep the exact system error, the step when it occurred, and the browser name. Before sharing screenshots, hide subscription URLs, passwords, and server credentials.
If installation is complete but the connection becomes unstable after the screen locks, check background restrictions in Settings → Apps → Shadowrocket and the battery settings on your device. Menu names vary, so first confirm that the app is actually being stopped in the background, then adjust the relevant setting. You don’t need to grant every background permission just to install the app.
Download Shadowrocket and continue setup
iPhone and iPad: $2.99 one-time purchase on the App Store. Mac (Apple Silicon and Intel), Windows, Android, and Linux: free. Find download information for every platform on our downloads page. For iPhone and iPad, check the App Store listing for system requirements. Verify the developer is Shadow Launch Technology Limited and check the official icon and app ID 932747118.
After installing Shadowrocket on Android, follow the quick-start guide to import your own connection details, confirm Config and Global Routing, then test the connection.