This guide walks through installing Shadowrocket for Android and checking your first connection. First, confirm your device supports arm64 and download from the right source. Then allow the app opening the APK to install it, and revoke that permission once installation is complete. WeChat download issues, APK parsing errors, blocked installs, and VPN permission prompts happen at different stages and need to be handled separately. Connection setup assumes you already have your own service provider and subscription.
1. Check the platform, architecture, and file source before downloading
Choose the Android version on the app download page to get the arm64 APK. arm64 refers to the 64-bit ARM architecture, not an Android version number. Knowing your Android version alone doesn’t tell you whether your processor and system are compatible. Older devices, systems that run only 32-bit apps, and some emulators may not support arm64.
Shadowrocket is available through two purchase options: iPhone and iPad versions are on the App Store for a one-time $2.99 purchase. The developer is Shadow Launch Technology Limited; check the App Store page for system requirements. Versions for Mac (Apple silicon and Intel), Windows, Android, and Linux are free. This guide covers Android phones, so you don’t need to purchase the iPhone or iPad version first.
Check before downloading
- Platform
- Android
- Package type
- apk
- Architecture
- arm64
- Download source
- Android download link on this site’s app download page
Don’t rename a desktop installer or a file for another architecture to make it look like an APK.
Check before installing
- Download status
- The browser shows the download as complete, not paused or failed
- File extension
- .apk
- Storage space
- Leave room for the installation process as well as the downloaded file
- App opening the installer
- Note whether you open the file from the browser or a file manager
Grant install permission to the app that starts the installation, not to the download webpage.
The download page provides the current installation link; this guide doesn’t specify a fixed filename, file size, or minimum system version. If the download page lists compatibility details, compare them with your device information. Don’t assume your device is compatible just because the file installs on another device.
2. Download with your system browser and install
We recommend opening the download page in your system browser before following these steps. Android manufacturers may use different menu labels. In English, the permission names are commonly Install unknown apps and Allow from this source. Follow the options shown on your device.
-
Open the download page
Open this site’s app download page in your system browser and choose the Android version. Make sure the browser starts saving the APK; loading the page doesn’t mean the file has finished downloading.
-
Open the installer
Open the completed APK from your browser’s download history. You can also open it from the Downloads folder in a file manager; you may need to grant the file manager permission separately.
-
Allow installs from this source
If Android says installs from this source are blocked, open Settings from the prompt, find the browser or file manager you’re using, and temporarily enable Allow from this source. Then return to the installer.
-
Confirm the installation
Check that the installer names the app as Shadowrocket, then follow the system prompts. Don’t change the file extension or start multiple installation tasks at once.
-
Revoke the source permission
After installation, open the app and confirm you can reach its main screen. Then return to Install unknown apps in system settings and turn off permission for the source you just allowed.
3. Can’t find “Install unknown apps”? Here’s where to look
Recent Android versions usually manage install permissions separately for each source app, rather than through one master switch. Start with the Settings link in the installation warning. Or search system settings for “Install unknown apps.” Menu paths vary by manufacturer, so you don’t need to match the steps for another phone brand.
- Common path on English-language systems:
Settings → Apps → Special app access → Install unknown apps, then select the browser or file manager you used to open the APK. - Browser allowed, but the install is still blocked? Check whether you opened the APK with a file manager this time. Permission granted to your browser doesn’t apply automatically to a file manager.
- No installer after returning to the app? Reopen the APK from your original download history. Some systems don’t restore the pending install request automatically.
- Can’t change the setting? Check for a work profile, parental controls, or device management policies. If your organization manages the device, ask your administrator whether installs are allowed.
If Android shows a specific security or compatibility warning, read it first, then verify the download source on this site’s download page. Don’t disable device-wide security to continue. Restrictions imposed by device management won’t be fixed by downloading the same file repeatedly.
4. WeChat won’t download the APK? Switch browsers and try again
WeChat’s built-in browser may handle downloads and opening external apps differently from your system browser. If tapping the button creates no download, leaves the page unchanged, or prompts you to open a browser, switch to your system browser instead of repeatedly tapping the same button in WeChat.
- Open the menu in the upper-right corner of the WeChat page and look for “Open in browser” or a similar option. The wording depends on your system and WeChat version.
- If that option isn’t available, copy the current page link and paste it into your system browser’s address bar. Copy the webpage address from this site, not an attachment link from an unknown chat.
- Open the app download page in your browser, choose the Android version, and check the browser’s download list.
- Wait for the download to finish, then open the APK from that browser. If Android asks for source permission, grant it to the browser—not WeChat.
A download task that stays paused in the browser is a download-stage issue. A completed download followed by an “Install blocked” warning is a permission issue. First, open a regular page on this site in the same browser to check basic connectivity. Then check the download task, available storage, and system prompts. Treat these issues separately.
5. First connection after installation: subscriptions, VPN, and routing
Installation only means the app can run; it doesn’t provide a working connection by itself. Import your own existing subscription or connection details, and check the protocol, server address, port, and authentication information. This site doesn’t provide, sell, or recommend nodes or subscriptions. Don’t import an arbitrary webpage URL as a subscription.
- Import your existing details: Use your own subscription link from the app’s add or import option. If you see items such as Home, Type, or Subscribe, follow the relevant prompts. Save, update, and confirm that the content appears in the list.
- Keep the original connection details: Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard are different protocol types; matching server addresses don’t make them interchangeable. There’s no universal default port, so use the value in your existing configuration.
- Handle VPN authorization: When you connect for the first time, Android may ask to set up a VPN connection. Confirm the request is from Shadowrocket before allowing it. If another VPN connection is active, disconnect it before testing.
- Check each part of the connection: Check the app’s connection switch, Android’s VPN status, and whether webpages load. A VPN status showing connected doesn’t mean every remote connection detail is correct.
If the app offers Global Routing, use the options below to distinguish a connection problem from a rule-selection issue. These options affect traffic handled by the app; they don’t mean every request from every app on your device goes through the VPN. Layouts vary by platform, so don’t assume the buttons are in the same place.
Config
RecommendedUse the policy selected by the rules in the current configuration. First check the configuration; unmatched requests don’t always go direct, as the final behavior also depends on rules such as FINAL.
Best for: routine use and testing with a verified rules configuration
Proxy
Route traffic handled by the app through the current proxy policy to temporarily rule out rule-based routing. If access still fails, check the remote connection details and network conditions.
Best for: briefly checking whether the issue is related to rules in Config
Direct
Use a direct connection without forwarding traffic through a proxy to test the remote connection. Being able to open a webpage with Direct selected doesn’t prove the imported connection works.
Best for: checking whether your current network can access the internet directly
6. Common download and installation issues
The download finished, but Android says “There was a problem parsing the package.” Why?
First, check the download list to confirm the file finished downloading, then download it again from this site’s download page. If it still fails, check that your device supports arm64 and review the compatibility details on the download page. Keep the exact system warning. An incomplete file, system incompatibility, and an architecture mismatch are separate possibilities; that message alone doesn’t identify the cause.
I already allowed it. Why am I still being sent to Settings?
Check which app is named in the installation warning. If you allowed your browser but opened the APK from a file manager this time, you’ll need to allow installs from that file manager. After changing the setting, return to the original app and reopen the downloaded file.
The update says “App not installed.” Should I uninstall it first?
Don’t uninstall it yet. Note the full error, check available storage, and confirm the update file came from this site’s download page. An incompatibility between the existing installation and the new file can also cause failure. Back up your configuration before uninstalling to avoid losing settings or connection details stored only on your device.
The app installed, but there’s no internet. Is the APK broken?
Disconnect first and check whether your system browser can access the internet directly. Then check VPN authorization, the current connection details, and Global Routing. If the connection drops only when the screen is locked, check Android’s background and battery restrictions for Shadowrocket. Don’t start by reinstalling the app.
What should I include in a screenshot when asking for help?
Include your phone model, Android version, browser used to download, steps leading to the problem, and the full error message. Hide subscription URLs, tokens, passwords, UUIDs, private keys, and connection QR codes. Take separate screenshots of the install-permission page and connection settings so it’s clear which step is affected.
A successful installation means the download finished, Android installed the app, the app opens, and the temporary source permission has been revoked. Check the connection separately; don’t change every setting at once. Change one thing at a time and note the resulting message to avoid confusing installation, subscription updates, and routing issues.
Go to the download page and choose Android
The iPhone and iPad versions cost a one-time $2.99 on the App Store; check the App Store page for system requirements. Versions for Mac (Apple silicon and Intel), Windows, Android, and Linux are free. Get the Android version from this site’s download page, then follow the import and connection guides after installation.