Shadowrocket FAQ
Troubleshoot in order: access, installation, import and connection
First identify where the issue occurs, then expand the relevant answer. Connection steps assume you already have your own subscription or server details. Keep a restorable copy before changing your configuration.
Get & Purchase
Distinguish app access from connection configuration. Check your platform and purchase history first, then troubleshoot search results, redownloading and moving to another device.
Can I use Shadowrocket on a computer or Android? How do I get it on each platform?
Yes. The iPhone and iPad app is a one-time $2.99 purchase on the App Store. The Mac, Windows, Android and Linux versions are free. Mac downloads are available for Apple Silicon and Intel; choose the installer that matches your system on other platforms too. Start from this site’s download page. Desktop, Android and Linux installers are available through /dl/shadowrocket/. Don’t use an installer intended for a different operating system.
How can I verify Shadowrocket on the App Store?
On the product page, check the name Shadowrocket, developer Shadow Launch Technology Limited, official app icon and app ID 932747118. The icon should match the official icon in this site’s header, but don’t rely on the icon alone—check every detail, including for listings with the same name. Open the designated product page from this site’s download page to avoid confusing it with search results. Get the computer and Android versions from this site’s download page.
What should I check if Shadowrocket doesn’t appear in App Store search?
Check the country or region of the Apple Account you use for the App Store, not just your device’s language or location. The app isn’t available on the mainland China storefront; open the product page to check availability. To change your region, go to Settings, then your Apple Account, Media & Purchases, View Account and Country/Region. Follow Apple’s process for any balance, subscription or payment-method requirements. Avoid switching accounts repeatedly to change search results.
Do I have to buy Shadowrocket again after switching iPhones or reinstalling it?
Sign in with the Apple Account used for the original purchase, then find Shadowrocket in your App Store purchase history or app list and download it again. In most cases, you won’t need to buy it again. If the App Store shows a purchase button, check your purchase history, current store account and region. The iPhone and iPad app is a one-time $2.99 App Store purchase; the Mac, Windows, Android and Linux versions are free. Restoring the download restores access to the app, but subscriptions, rules and server details must be restored separately.
Can I install Shadowrocket on iPad? Does the iPhone purchase cover it?
Yes. iPhone and iPad use the same Shadowrocket app, and you can redownload it from your purchase history using the same Apple Account. The iPhone and iPad app is a one-time $2.99 App Store purchase; the Mac, Windows, Android and Linux versions are free. Check the App Store page for system requirements. Purchase history isn’t a configuration backup, so after moving to iPad, check that your server, Config and connection permissions are ready.
Does getting the app include servers I can connect to?
A one-time app purchase is not a server plan. Shadowrocket manages server details, subscriptions and rules you already have; getting the app does not create usable servers. This site is the official site and manual. It does not provide, sell or recommend servers or subscriptions. Before setup, have your own subscription link or complete server details ready, and check their validity period, connection requirements and usage permissions. This helps distinguish missing configuration from an installation problem.
Installation
Installers aren’t interchangeable across platforms. Check your operating system and chip first, then follow system prompts for files from this site. On organization-managed devices, follow your administrator’s requirements.
Which Mac version should I choose: Apple Silicon or Intel?
Open About This Mac from the Apple menu. If it shows a chip and an Apple chip name, choose the Apple Silicon version. If it shows a processor and Intel, choose the Intel version. On this site’s download page, select the matching DMG in the Mac section. Open it and move the app to Applications. If you see a developer verification warning on first launch, confirm the file came from this site, then go to System Settings > Privacy & Security and select Open Anyway. Don’t guess your chip type based only on what a browser reports.
How do I proceed if Windows SmartScreen warns about the installer?
First confirm that the Shadowrocket Windows installer came from this site’s download page and that your system is the corresponding 64-bit version. If SmartScreen displays a protection warning, verify the source, select More info, then Run anyway. Work or school devices may be restricted by organizational policies; contact your administrator if so. Don’t disable system-wide protection or repeatedly allow files from unknown sources.
What should I do if Mac says the developer can’t be verified or the app is damaged?
Check that the installer came from this site and matches your Mac’s chip, then move Shadowrocket to Applications. If macOS can’t verify the developer, try opening the app once, then go to System Settings > Privacy & Security and select Open Anyway. If macOS says the app is damaged and you’ve confirmed the installer came from this site, run xattr -cr /Applications/Shadowrocket.app in Terminal and try again. Run the command only on this app; don’t apply it to a broader directory. If the problem persists, download the correct version again.
What if Android installation is blocked or a Linux AppImage won’t start?
For Android, make sure you have the arm64 installer for your device. When prompted, allow the browser or file manager you’re using to install unknown apps; you can turn off this permission after installation. On Linux, choose deb, rpm or AppImage for your distribution. An AppImage needs execute permission, which you can enable in the file properties or by running chmod +x on the file. Only apply these steps to files downloaded from this site. On managed devices, follow your administrator’s policies.
What if the connection switch won’t turn on or turns off immediately on first launch?
On Home, first select a valid server entry, then try connecting. The first connection on iPhone or iPad requires permission to add a VPN configuration and any verification requested by the system. If you previously denied permission, check the system VPN settings. Temporarily stop other connections using the VPN, then restart the app and try again. If the switch immediately turns off, check the first error in the log and review permissions, server details and configuration syntax. Avoid rapidly toggling the switch.
The interface is in English. Which sections should I look at first?
Start with Home, Config and Settings: Home is for selecting a server and connecting, Config is for configuration files, and Settings is for app preferences. Add Server adds an entry, Scan QR Code scans a code, and Global Routing sets how traffic is handled. This manual keeps interface labels in English so you can match them directly. Layouts may vary by platform and system language, so look for the setting name rather than relying on a button’s position.
Subscriptions and server imports
Check what type of data you’re importing, then verify the entries and selection after import. Subscription links, QR codes and configuration files may contain credentials; treat them as personal sensitive information.
How do I import an existing subscription link?
Use a subscription link you already have. On Home, open Add Server, choose Subscribe for the subscription type and enter the link. Save it, update it, then check whether server entries were created. Remove leading or trailing spaces and any explanatory text added by a messaging app before pasting; keep the link intact. After import, select a specific entry and check Global Routing. Entries appearing in the subscription list only mean the data was read—not that every server can connect.
What if a subscription import fails, shows a format error or leaves the list empty?
Check three things separately: whether the link can be accessed, whether the response is a subscription, and whether it contains recognizable entries. A login page, web-sharing URL or error page can’t be used as subscription data. Check whether the link was truncated, access credentials have expired, or the provider requires a particular export format. Keep the original group while testing a corrected link instead of deleting all entries. Hide credentials in the subscription URL and server passwords in troubleshooting screenshots.
What if Scan QR Code fails or can’t recognize an image from Photos?
Make sure camera access is allowed, the QR code is clear and complete, and none of its corners are cropped. Adjust the scanning distance if needed. Scan QR Code requires recognizable server or subscription data; a regular webpage link is not a configuration QR code. If the source also provides text, use your original link or enter the details manually. Don’t repeatedly compress or forward QR code images. They may contain connection credentials, so share them only between your own devices with care.
When adding a server manually, which fields need to match?
In Add Server, first select the protocol used by your existing server, then enter the address, port and authentication details. Match the Shadowsocks encryption method, the VMess or VLESS user ID, the Trojan password, and settings such as TLS, SNI and transport type to the server configuration. Don’t mix fields from different protocols or turn off TLS verification to mask incorrect settings. Confirm missing details with the provider of your original configuration before saving.
How do I update an existing subscription without creating duplicate entries?
Update the original subscription group instead of adding the same link as a new subscription each time. After updating, check entry names, the selected entry and any change in the number of entries; then remove old groups only after confirming they’re duplicates. If the provider changes the link, back up anything you need to keep before editing the original subscription URL. Manually edited subscription entries may be overwritten on the next update. If an update fails, check the link and network connection first—don’t start by deleting all configuration.
What’s the difference between a subscription and Config? Can one replace the other?
Subscriptions are mainly for fetching and updating server entries in bulk. Config contains settings such as rules and DNS, so each serves a different purpose. A complete server list doesn’t mean the required rules are enabled. After importing Config, check that its referenced policies match your current servers or groups. Keep a copy of the configuration you’re using before importing. Once enabled, test a few destinations first; replacing both the subscription and Config at the same time makes it hard to tell what caused a change.
Advanced Setup
Test your regular network first, then the server, and finally rules and DNS. Connection status, server tests and actual browsing are three separate results.
How should I choose Config, Proxy or Direct in Global Routing?
For everyday rule-based routing, choose Config to match requests against the active configuration. Proxy sends requests through the selected proxy and is useful for briefly checking the proxy path. Direct connects directly and is useful for comparison with your normal network. The interface labels Config, Proxy and Direct correspond to configuration, proxy and direct connection. Proxy won’t fix an invalid server, and Direct doesn’t test a server. Switch back to your preferred mode after troubleshooting.
Why can’t I access the internet even though Shadowrocket says it’s connected?
Disconnect first and confirm that your Wi-Fi or cellular connection works normally. Then reconnect and run Connectivity Test on the selected server. If the test fails, check the address, port, authentication, device time and server status. If it passes but some websites still fail, check Global Routing, rule matches and DNS. Change one setting at a time and note what you tested. An active connection switch only means a local connection was established; it doesn’t confirm that the remote service or every destination is reachable.
Some domains won’t open. Should I change DNS or rules first?
Check the log first to distinguish a DNS resolution failure from a connection failure after resolution. If resolution fails, check the current DNS settings and whether the DNS server is reachable. If the domain resolves but traffic takes the wrong route, check the order and policies for rules such as DOMAIN, DOMAIN-SUFFIX and IP-CIDR. Rules are generally matched in order, so a broad rule above a specific one can take precedence. Back up Config before making changes, then change one item and test. Changing DNS isn’t a universal fix.
How do I troubleshoot On Demand auto-connect and battery drain?
On Demand triggers connections based on conditions such as the network; it doesn’t choose routing rules. Check for overlapping triggers, especially repeated connections when switching between Wi-Fi and cellular, then look for reconnects in the log. Compare battery use under similar network and usage conditions, and check the system’s battery statistics. Weak signals, continuous data transfer and frequent reconnects can all affect battery use. To isolate the cause, temporarily turn off On Demand and connect manually to distinguish trigger issues from server connection issues.
What information should I keep when troubleshooting further?
Note your device’s operating system, the network type where the issue occurs, the Global Routing option, protocol, steps that trigger the error, and the first relevant error in the log. Say whether all requests fail or only one domain, and keep a comparison result from when disconnected. Before sharing, hide subscription credentials, server passwords, user IDs and personal network details. Don’t share a complete Config or QR code. Describe the issue with only the necessary details, then add more information based on the troubleshooting results.