Shadowrocket for Android Documentation
Learn how to install the app, import nodes, connect VPN, test speed, configure advanced features, and troubleshoot common issues.
Detailed guides
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
Keep your subscription links or node links somewhere safe before upgrades or device migration. The main menu can export the current nodes to the clipboard so you can paste them on another device.
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.
- Speed test passes but nothing loads after connecting: open Settings, flip Enable local DNS (on if it was off, off if it was on) and reconnect; if that does not help, flip Enable fake DNS the same way; if it still fails, export your nodes to the clipboard, uninstall the app, reinstall it and import them again.
- 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.