Official Manual · FAQ
Shadowrocket FAQ Purchase, setup, subscriptions & routing troubleshooting
First identify where the problem occurs, then follow the checks in the answer. iPhone and iPad steps are used as examples; computer and Android installation issues are covered separately.
Current version Loading · iPhone and iPad: $2.99 one-time App Store purchase; Mac, Windows, Android, and Linux: free
- 20 questions
- 4 topics
- Check permissions first, then troubleshoot the connection
- Change one setting at a time
PURCHASE & IDENTITY
Purchase
First compare the purchase options and platform pricing, then check your store records. App purchase history and configuration data on a device are separate.
Can I use Shadowrocket on a computer or Android? How much does it cost?
Yes. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Download the appropriate computer or Android installer from this site; installers are under /dl/shadowrocket/. Shadowrocket is a closed-source commercial app. A one-time app purchase does not include a service plan. Before connecting, you’ll need your own subscription or server details. This site does not provide, sell, or recommend servers or subscriptions.
How can I verify the genuine Shadowrocket app in the App Store?
Open the App Store product page linked from this site’s download page. Check the app name, Shadowrocket, the developer, Shadow Launch Technology Limited, and app ID 932747118. Verify the official icon too; don’t rely on the name shown in search results alone. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. The price shown on the product page may vary by store region. Download desktop and Android installers from this site’s download page, not from similarly named store listings.
Can’t find Shadowrocket in the App Store? What should I check first?
Open the product page for app ID 932747118 from this site’s download page to distinguish a missing search result from regional unavailability. Shadowrocket isn’t available in the mainland China App Store. Check Settings → Apple Account → Media & Purchases → View Account → Country/Region, then check Screen Time content and privacy restrictions. If you need to change your region, use the Country/Region option in your account and follow Apple’s instructions for any balance, active subscriptions, and payment details. Don’t switch regions repeatedly. Check the App Store page for system requirements.
Do I have to buy Shadowrocket again after getting a new iPhone or reinstalling it?
Sign in to the App Store with the Apple ID used for the original purchase. Find Shadowrocket in your account’s purchased items or app list, then download it again. If the page still shows a price, first check the account used for Media & Purchases, the store region, and your purchase history. Don’t pay again without checking. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Restoring the app doesn’t restore local configurations. Save your subscription URL and any settings you need before reinstalling. For computer and Android reinstalls, download the appropriate installer from this site again.
Can I install Shadowrocket on iPad and use my iPhone purchase?
Yes. Shadowrocket works on iPad. Sign in with the Apple ID used for the purchase and download it again from your purchased items. If it isn’t listed, check the App Store account currently signed in and your purchase history. The iPhone and iPad app costs $2.99 as a one-time App Store purchase, and the purchase works on both devices. The Mac, Windows, Android, and Linux versions are free. Check the App Store page for iPad system requirements. A shared purchase history doesn’t automatically sync server lists, Config, or connection permissions between devices. Import your own configuration on each device and confirm system permissions the first time you connect.
INSTALL & FIRST LAUNCH
Installation & first launch
Handle installer architecture, system security warnings, and connection permissions separately. Before proceeding, confirm the file’s source and follow the operating system’s prompts.
Which Mac version should I download: Apple silicon or Intel?
Open the Apple menu → About This Mac. If it lists an Apple M-series chip, download the Mac Apple silicon version from this site’s download page. If it lists an Intel processor, choose Mac Intel. Don’t guess based on the Mac’s appearance or purchase year. After downloading the matching DMG, move Shadowrocket to Applications and launch it. If macOS can’t verify the developer, confirm the installer came from this site, then go to System Settings → Privacy & Security and select Open Anyway. If macOS says the app is damaged, follow the Mac security instructions on the download page. Don’t keep replacing it with installers from unknown sources.
Windows or Mac warns that the app may be unsafe on first launch. What should I do?
The desktop installers on this site are unsigned, so the operating system may block them on first launch. First confirm the file came from /dl/shadowrocket/ on this site. In Windows SmartScreen, select More info → Run anyway. On managed devices, follow your administrator’s policies. If macOS can’t verify the developer, go to System Settings → Privacy & Security and select Open Anyway. If macOS says the app is damaged, confirm the source, then run xattr -cr /Applications/Shadowrocket.app in Terminal and reopen it. Make sure the path matches the app’s actual location. Don’t disable system protection entirely.
What permissions and file formats should I check when installing on Android or Linux?
For Android, download the arm64 installer from this site. If Android blocks it, allow installation of unknown apps only for the browser or file manager you’re using to open the file. You can turn this permission off after installation. On Linux, choose deb, rpm, or AppImage according to your distribution; don’t mix package formats. For an AppImage, enable execution in the file’s properties or use chmod +x on the actual file. Also approve any network permissions requested when you first connect. Use the download page for exact commands and filenames. If installation fails, note the system message; don’t bypass management restrictions on a managed device.
What if the connection switch on Home won’t turn on or immediately turns off?
First add and select a working server, then turn on the connection switch on Home. The first time you connect on iPhone or iPad, allow Shadowrocket to add a VPN configuration and complete any device verification required by the system. If you previously denied permission, check the VPN settings in Settings. If the connection still drops immediately, disconnect other services using the system VPN, check whether device management policies apply, and review Shadowrocket’s error message. Don’t delete all configurations straight away. Keep your server details and existing subscription, then determine whether the issue is permissions, incorrect settings, or a server connection failure.
The interface is in English. Which sections should I learn first?
Use each section according to its purpose: Home selects a server and controls the connection; Add Server adds a server or existing subscription; Config manages configuration files; Global Routing selects how traffic is handled; Data shows traffic usage; Settings contains common options. This guide keeps the English interface names so you can match them to the app; you don’t need to change the interface language first. For a first setup, add your details, choose a mode, connect, then test access. Layouts vary by platform, so look for section names rather than relying on button positions.
SUBSCRIBE & ADD SERVER
Subscriptions & server imports
First distinguish a subscription URL from the details for a single server. Import, update, and organize them separately, keeping existing working configurations for comparison.
How do I import an existing subscription link into Shadowrocket?
On iPhone or iPad, open Home → Add Server and select Subscribe as the type. Enter your complete subscription URL in URL, add a recognizable remark, and save. Return to the list and wait for it to load. Confirm that servers appear, then select one to test. A subscription URL retrieves a server list; it isn’t the address of a single server, so don’t split it across server fields. When copying, avoid extra spaces, line breaks, or explanatory text. Subscription URLs may contain access credentials, so don’t share the full URL or its QR code in a public screenshot.
Subscription import fails or shows an empty list. What should I check, and in what order?
Check that the link is complete and doesn’t contain extra spaces, expired parameters, or a webpage title copied along with it. Then confirm your current network can reach the address. Check the app’s message: a request failure usually calls for checking the network and address reachability; a parsing failure means checking whether the returned content is in a subscription format Shadowrocket recognizes. A login page or error page can’t be imported as a server list. If the URL came from a service provider you use, ask that provider to confirm its validity and format. Keep existing working groups while troubleshooting, and don’t repeatedly add the same link, which can make old and new results hard to distinguish.
How do I update Subscribe, and why did my server list change afterward?
Update the existing subscription from its corresponding action, then check the result and server list. Don’t add the same subscription again instead of updating it. The list reflects the data returned by the subscription URL, so an update may add, remove, or rename servers. You may need to select a server again. Before updating, note the group and server you’re using; afterward, test the connection. If the update fails, keep the current list and check the URL, network, and app message. A successful update doesn’t guarantee a working connection; also check server status, account validity, and actual access.
Can I add a single server from its details or QR code?
Yes. Open Add Server and choose the protocol that matches the details you have. Check the address, port, authentication information, and any transport settings required by that protocol. To scan a QR code, use Scan QR Code and allow camera access when prompted. The fields for Shadowsocks, VMess, VLESS, Trojan, WireGuard, and Hysteria2 aren’t interchangeable; preserve parameters such as TLS and SNI exactly. A successful scan only means the details were read, not that the server is reachable. Save and test the server first, then check Global Routing. Avoid changing protocol settings and rules at the same time so you can identify the cause of any issue.
How can I organize overlapping servers from multiple subscriptions without deleting the wrong ones?
Add clear remarks identifying each subscription, then determine whether the same subscription was added twice or different subscriptions returned servers with the same name. Matching names don’t mean the servers are identical; check the protocol, address, and port before taking action. Don’t judge which subscription a server belongs to by its display name alone. Before deleting a group, make sure you’ve kept your original subscription URL and check whether the current connection uses that group. Servers managed by a subscription are usually maintained by its update results, so manual changes or deletions may be undone on the next update. Remove duplicate subscription entries first rather than repeatedly deleting individual generated servers.
ROUTING & DIAGNOSTICS
Routing rules & troubleshooting
Compare the same destination on the same network. First confirm basic connectivity and that the server works, then check Config, DNS, and background behavior.
How do I choose Config, Proxy, or Direct in Global Routing?
Config uses the rules in the selected configuration to decide how connections are handled. Proxy routes traffic primarily through the proxy and is useful for briefly testing the selected server. Direct connects without forwarding traffic through a proxy server. For everyday domain- or IP-based routing, make sure the intended configuration is selected under Config, then use Config mode. To troubleshoot, compare the same destination in Proxy and Direct, then restore your previous mode. Changing modes won’t fix incorrect server details or provide a working server. Retry the request after switching so an existing connection doesn’t affect the result.
Shadowrocket says it’s connected, but webpages won’t load. What should I check first?
Disconnect and confirm the device can access the internet normally. Then open Shadowrocket and check the selected server and Global Routing mode. Test the same webpage in Direct and Proxy. If Direct works but Proxy fails, check the server details and remote server status. If Proxy works but Config fails, check the rules and DNS. Then review Connectivity Test and the connection log to distinguish timeouts, DNS resolution failures, and authentication failures. Connected usually means the local connection was established; it doesn’t guarantee every remote request will succeed. Change one setting at a time and record the result. Don’t change the server, DNS, and entire configuration all at once.
How can I narrow down a suspected DNS or routing rule issue?
First confirm the server works in Proxy. Then check which configuration is active under Config and review the rule order. DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches address ranges, and FINAL usually handles connections that didn’t match earlier rules. Earlier matching rules can affect the final policy. If the log indicates a DNS resolution failure, check the current DNS settings, whether the resolver is reachable, and whether the configuration applies a separate policy to DNS requests. Don’t replace all DNS settings just because one site won’t load. Note the original values, retry the same request after each change, and restore the original settings if needed before continuing.
Will leaving Shadowrocket on drain the battery? How should I configure On Demand?
Battery use depends on data transfer, signal quality, protocol, connection retries, and background activity; the switch being on doesn’t tell you how much power it uses. Check system battery usage for the same period and compare it with Data and connection logs. Look for continuous uploads, frequent reconnections, or weak-signal conditions. On Demand starts connections when matching conditions are met; it doesn’t automatically reduce battery use. After configuring it, test your usual Wi-Fi and mobile networks, as well as behavior with the screen locked. To troubleshoot, temporarily turn off On Demand, connect manually, and observe. Don’t change several background settings at once or treat a short test as a measure of everyday battery use.
Why does Data traffic differ from server-side usage, and what should I save before updating?
Data shows traffic recorded by the client within its reporting period. The start of the reporting period, upload and download accounting, and protocol overhead may differ from server-side figures, so Data shouldn’t be used to settle a server-side allowance. Check the reporting period and whether the data was reset, then compare it with your own service records. Before updating, keep your existing subscription URL, manual server details, Config, and any Settings you need. Store backups securely if they contain authentication details. Update the iPhone and iPad app through the App Store. For Mac, Windows, Android, and Linux, get the latest installer from this site’s download page, follow its instructions for system security warnings, and test the connection after updating.