Shadowrockets for Android Documentation
Learn how to install the app, import nodes, connect VPN, test speed, configure advanced features, and troubleshoot common issues.
Quick Start
- Install. Download the Android APK and install it.
- Import. Import nodes from QR code, clipboard, file, or remote list.
- Choose. Use speed test results to select a stable node.
- Connect. Tap connect and allow Android VPN permission.
Import
| Method | Use case |
|---|---|
| QR code | Quickly import a single node from another screen. |
| Clipboard | Import one or more node links. |
| Local file | Migrate or import batch configuration files. |
| Remote node list | Maintain multiple nodes and update them later. |
| Manual | Enter protocol, server, port, TLS, SNI, and transport settings. |
Connect
Select a node before connecting. Tap the connect button and approve the Android VPN permission. Tap it again to stop the VPN service.
Speed Test
Run batch speed tests, sort nodes by latency, and remove unavailable entries after confirming the current network is normal.
One-tap speed testing helps users find stable nodes quickly.
Advanced
Most users can stay with import, connect, and speed test. Advanced users can continue with policy groups, proxy chains, Fragment, Mux, FakeDNS, and Xray TUN.
Policy groups, proxy chains, Hysteria2, and Xray TUN remain available for deeper control.
Backup
Use local backup or WebDAV backup before upgrades or device migration. WebDAV needs a URL, username, password, remote directory, and timeout.
Troubleshooting
- Cannot connect: check network, node parameters, VPN permission, and per-app proxy.
- Connected but no access: check DNS, routing, IPv6, and the selected node.
- Remote node list update fails: check the URL, User Agent, HTTPS, and network.
- Xray TUN issue: disable Xray TUN first and confirm normal VPN mode works.