Official Manual · FAQ
Shadowrocket
Setup, Subscription & Connection FAQs
For iPhone, iPad, Mac, Windows, Android, and Linux. Find the stage where the issue occurs, then expand the answer. Import and connection steps assume you already have your own subscription or server details.
First handle app access and system permissions, then verify imports, and finally troubleshoot rules and connections. Avoid changing multiple settings at once so you can compare results reliably.
View app downloadsAuthenticity & Purchase
Choose the right option for your device. For App Store listings, verify the developer, official icon, and app ID.
Can I use Shadowrocket on a computer or Android, and how do I get it?
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 other versions for your device and Linux distribution. Visit the download page: iPhone and iPad users are directed to the App Store, while other installers are provided on this site under /dl/. If your system blocks the app on first launch, confirm that the file came from this site, then follow the relevant system-permission steps in the installation section.
How can I verify Shadowrocket on the App Store?
Don’t rely on the name shown in search results alone. Open the product page and check the app name, Shadowrocket, the developer, Shadow Launch Technology Limited, and app ID 932747118 in the product page URL. The icon should match the official icon in this site’s header. The iPhone and iPad app is a one-time $2.99 App Store purchase; the Mac, Windows, Android, and Linux versions are free. Store prices may vary by region. Don’t follow this manual for a listing with a similar name or icon but a different developer or app ID.
Can’t find Shadowrocket in the App Store? Check these settings first
Open the App Store product page from the download page to see whether the listing is missing from search or the store says it’s unavailable in your region. The app is not currently listed in the mainland China App Store. Check the country or region for the Apple Account used for Media & Purchases, not just your device language. Also check content age restrictions in Screen Time. To change your region, follow Settings → Apple Account → Media & Purchases → View Account → Country/Region. Review any requirements for your balance, subscriptions, and payment method first.
Can I install Shadowrocket on iPad? Do I need to buy it again after switching or reinstalling?
Shadowrocket is available for iPad; check the App Store product page for system requirements. The iPhone and iPad app is a one-time $2.99 App Store purchase. You can redownload it from your purchases on either device when both use the same purchasing account. The Mac, Windows, Android, and Linux versions are free. After switching devices, make sure you’re signed in with the original purchasing account, then look for your purchases in your App Store account page; menu names may vary by system. Reinstalling the app won’t restore all local servers and configurations automatically. Back them up separately before switching, and keep any credentials secure.
Why do I still need subscription or server details after getting the app?
A one-time app purchase is not a service plan. Shadowrocket reads configurations, matches rules, and establishes connections; your app purchase doesn’t provide a server address, authentication details, or a Subscribe link. The iPhone and iPad app is a one-time $2.99 App Store purchase; the Mac, Windows, Android, and Linux versions are free. Neither option includes network service. This site does not provide, sell, or recommend servers or subscriptions. The steps below assume you already have your own subscription or server details. Before importing, check that the information is complete and still valid.
Installation & First Launch
First verify the file source and device architecture. Grant permission only to an app you’ve verified; on managed devices, follow your administrator’s policies.
Which Mac version should I choose: Apple silicon or Intel?
On your Mac, open About This Mac from the Apple menu and check the Chip or Processor entry. If it shows Apple silicon, choose the Mac Apple silicon version; if it shows Intel, choose Mac Intel. Don’t guess based on the computer’s appearance or purchase date. Both installers are in the Mac section of the download page. After downloading, open the disk image and drag Shadowrocket into Applications. If macOS says it can’t verify the developer when you first open the app, confirm the source, then follow the steps under System Settings → Privacy & Security. There’s no need to keep switching between chip versions.
Windows SmartScreen warns that the app may be risky. How can I check and install it?
First, make sure you downloaded the installer from this site’s download page. Installers are provided under /dl/; confirm you’re about to run the file you just downloaded. If SmartScreen appears, select More info, check the file, then choose Run anyway and review the system permission prompt. If that option isn’t available, or your device is managed by your organization, don’t try to bypass its policies; contact your administrator. Allowing the app to run doesn’t configure your server details. You’ll still need to import your own information after the first launch.
Mac says the developer can’t be verified or the app is damaged. What should I do?
First confirm the installer came from this site and that Shadowrocket is in Applications. If macOS can’t verify the developer, try opening the app once, then go to System Settings → Privacy & Security, find the alert, and select Open Anyway. Confirm when prompted. If macOS says the app is damaged, download and install it again. If the warning persists and you’ve verified the source, run xattr -cr /Applications/Shadowrocket.app in Terminal, then try opening the app again. Apply the command only to this app, not to an entire directory. If your device is managed, check with your administrator first.
Android installation is blocked. Which permission do I need to enable?
Download the Android installer for your device from the download page. Your system may ask you to allow your browser or file manager to install unknown apps. Grant this permission only to the app you’re using to open the installer; you can turn it off after installation. If the package can’t be parsed, check that the download is complete and the device architecture is supported, then download it again. Don’t repeatedly try to install the same failed file. If a download won’t start in WeChat, follow the page’s instructions to use your system browser. When prompted to approve a VPN configuration on your first connection, review the app name and permission details before deciding.
Which Linux package should I choose: deb, rpm, or AppImage?
Choose a package that matches your distribution: Debian, Ubuntu, and similar systems usually use deb; distributions based on RPM packages use rpm. AppImage is suitable when you want to run a standalone file, provided its runtime dependencies are met. Download the package from the download page. For deb, run sudo apt install ./Shadowrocket.deb in the directory containing the file, replacing the example filename with the actual one. For AppImage, first make the file executable, for example with chmod +x Shadowrocket.AppImage, then run it. If you see an architecture or dependency error, resolve it rather than forcing installation.
Subscription & Server Imports
Check the link or fields before saving and testing. Subscription links, configuration backups, and QR codes may contain authentication details.
How do I import and verify an existing Subscribe link?
Make sure you have the complete subscription link you already use, not a link to a web page with instructions. In Home, open Add Server, select Subscribe, paste the link into the URL field, and enter a name that will help you identify it. Save and wait for the import to finish. Back in the list, check the group name, server entries, and protocols; seeing a group appear alone doesn’t confirm a successful import. Subscription links often contain authentication details, so don’t share them in public screenshots or support messages. See the subscription manual for details on the fields and steps.
Subscription import failed or the list is empty. What should I check first?
Check the link for spaces, line breaks, truncation, or extra punctuation at either end, then confirm it’s still valid. Next, identify the error: for a timeout, check whether your current network can reach the subscription address; for an authentication error, check the link parameters; if the fetch succeeds but no entries appear, check that the response is in a supported subscription format rather than a login or error page. Don’t give anyone your full link to test. If another subscription you already have updates successfully, the issue is more likely with this link or its response. Keep the error message and check with the original provider.
I only have server details. How do I fill out Add Server?
In Home, open Add Server, choose the protocol that matches your existing details, then fill in Address, Port, and the relevant authentication fields. Shadowsocks encryption settings, VMess or VLESS identifiers, and Trojan authentication details aren’t interchangeable. Enter TLS, SNI, and transport settings exactly as provided. A server address generally shouldn’t include a web page path, and the port should be the number supplied by your provider. Save, check the fields, then select that server and test it. Don’t turn off certificate verification just to clear an error; first check what the original configuration requires.
How do I update a subscription, and will the update change my manual edits?
In Home, find the relevant Subscribe group and use its update option. Wait for it to finish, then check whether the entries changed. Menu locations may vary by version and platform; use the options available for the current group. An update may rebuild or adjust the group’s servers based on the remote response, so don’t assume manually edited names, ordering, or fields will be preserved. Back up important changes first. Manage standalone servers separately if you need to keep them long term. If an update fails, keep the existing group for troubleshooting rather than deleting it immediately.
How can I organize duplicate servers from multiple subscriptions without deleting the wrong ones?
Name your existing subscription groups by source and purpose, then check whether the same link was imported twice or different subscriptions contain the same server. Don’t judge by display name alone: compare the protocol, address, port, and any required transport settings. Identically named entries can still be different connections. If you confirm a group is a duplicate import, back it up before deleting the whole group; deleting entries one by one may cause them to reappear at the next update. Before deleting, check whether the currently selected server belongs to that group. Backups may contain passwords and subscription parameters, so store them securely.
Rules & Troubleshooting
“Connected” status, server reachability, and successful requests to a destination are different outcomes. Narrow down the cause in order: network, system authorization, server, DNS, then rules.
The connection switch won’t turn on, or turns off right away. What should I do?
First, select a valid server and approve the VPN configuration permission requested by your system. If you canceled the first authorization, return to the app, try again, and read the system prompt. If it still fails, check in system settings whether the VPN configuration exists. Also check for another VPN connection or device management policy using the network permission, and avoid enabling conflicting connections at the same time. If the switch changes automatically with your network, check the On Demand conditions. Finally, note the error and steps that triggered it, then review the diagnostics. Don’t start by clearing all configurations.
The switch says connected, but web pages won’t load. How can I find the cause?
Temporarily turn off the connection and confirm that your Wi-Fi or mobile network works on its own. If the network requires a sign-in page, complete that first. Then check the server credentials, whether they’re still valid, and the system time. Use Connectivity Test to help check reachability, but a test result doesn’t guarantee that every web request will succeed. If all destinations fail, check the server and DNS first. If only some fail, review the matched rules and policies in the request log. Change one setting at a time and record the result after each test to identify whether the network, server, or rules caused the change.
Which Global Routing mode should I use: Config, Proxy, or Direct?
Config routes requests according to the rules in the current configuration file, making it suitable for everyday use when you’ve checked the rules. Proxy sends eligible traffic to the currently selected proxy policy and can help with comparison tests. Direct sends requests directly and can help check the underlying network. These modes aren’t separate servers and won’t fix an expired subscription. Before testing, note the current mode, compare the same destination in each mode, then restore the one you need. Config’s actual behavior also depends on rule order, policy references, and the final fallback rule.
DOMAIN-SUFFIX or REJECT isn’t working as expected. What should I check?
First confirm Global Routing is set to Config and that you’re using the configuration file you just edited. Rules are usually matched in order, so an earlier DOMAIN, IP-CIDR, or other rule may match the destination before the new rule is reached. Check that the DOMAIN-SUFFIX value is a domain suffix, not a full web address. Then review the request log to see the actual domain and matched policy. REJECT blocks connections that match its conditions; it doesn’t inspect page content. A page may request several domains, so its appearance alone can’t tell you whether a particular rule worked.
The interface is in English. Which screens should I start with?
Start with these screens by function: Home to view and select servers; Add Server to add details you already have; Subscribe to manage subscriptions; Config to manage configuration files; Global Routing to choose a routing mode; and Settings to view app settings. The manual keeps these labels in English so you can match them to the interface without translating each term. If your system lets you set an app’s language separately, check Shadowrocket’s language options in your device settings. Available languages depend on the interface. If a screen is in a different place on your platform, look for the feature name and follow the corresponding section.
Shadowrocket is using more battery. Should I adjust On Demand or diagnostic tests?
Start by separating foreground app use, background connection time, and the device’s overall network activity in your system battery report. Don’t diagnose a problem based on one percentage reading. Continuous downloads, frequent reconnects, weak signal, repeated Connectivity Test runs, and detailed logging can all add network and processing load. Check whether On Demand is repeatedly triggering on your current network, and reduce unnecessary tests. Change one setting at a time and compare similar usage periods in similar network conditions. Restore an appropriate log level when troubleshooting is complete. Don’t change authentication or rule fields you don’t understand just to reduce battery use.