Before installing Shadowrocket, check your processor, system requirements, and download source, then address any first-launch prompts. This guide is for users installing on Mac or Windows: choose the right build for your hardware, distinguish source verification from compatibility issues and explicit security detections, then check connectivity using your own configuration. Confirm the source and understand the prompt before approving an individual app to open. You do not need to disable system-wide protection.
1. Check the download source and installation requirements
Installing Shadowrocket on a desktop differs from getting it on iPhone or iPad. iPhone and iPad: get it from the App Store for a one-time $2.99 purchase. Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Check the App Store listing for iPhone and iPad system requirements. The developer is Shadow Launch Technology Limited.
Start all download steps from the download page. Mac, Windows, Android, and Linux installers are provided on this site under /dl/shadowrocket/. Don’t rely on search snippets, chat attachment names, or file icons to verify a download. Select the right platform from the download page and keep your browser’s download history so you can check the actual URL.
2. How to tell whether your Mac has Apple silicon or Intel
Don’t choose a build based on the year you bought your Mac, its appearance, or a name like “MacBook Pro.” A product line can include different processor architectures over time. Check the hardware information on your Mac. Apple silicon uses the ARM architecture, while Intel uses x86-64; the download page lists a separate option for each.
-
Open your Mac’s hardware information
Click the Apple menu in the top-left corner of your screen, then choose About This Mac. On a Mac set to Chinese, this appears as “关于本机.”
-
Check the processor field
If you see Chip with an Apple silicon model, choose the Apple silicon build. If you see Processor with Intel in the description, choose the Intel build. Don’t mistake the Memory value for the processor model.
-
Check system requirements
Note the macOS version shown in the same window, then check the current build’s system requirements on the download page. Matching the processor architecture does not guarantee that an older version of macOS is supported.
-
Choose a build and install
Go to the download page and choose the appropriate Mac option. If the download is a disk image, open it and follow the window’s instructions to copy the app to Applications, then launch it from Applications.
On Apple silicon Macs, choose the native build. There’s no need to select the Intel build just to complete installation. If you see an architecture or system compatibility warning, recheck your hardware details and the download page. “Allow opening” cannot fix compatibility problems.
Choose based on your Mac’s hardware, not its product name
Apple silicon Mac
- Check the Chip field in About This Mac.
- Choose Mac Apple Silicon on the download page.
- Make sure the app has finished copying before you launch it for the first time.
Intel Mac
- Check the Processor field in About This Mac.
- Choose Mac Intel on the download page.
- Check the current build’s macOS requirements separately.
The two Mac builds are provided for different hardware. Address any launch prompt only after selecting the right architecture and confirming system compatibility.
3. Mac first-launch blocks: identify the prompt before proceeding
“Developer cannot be verified” is a source and developer verification prompt; not every block should be handled the same way. If macOS says the app will damage your computer, detects malicious content, or reports that the file is damaged, stop. Don’t force your way past the warning by removing quarantine attributes or disabling Gatekeeper system-wide.
| Prompt | What to check first | What to do next |
|---|---|---|
| Developer cannot be verified, or the app cannot be checked for malicious software | Check that the browser history shows a download from this site’s download page and that the build matches your Mac’s architecture. | After verifying the source, check whether Privacy & Security offers Open Anyway for this app. |
| “The app is damaged and can’t be opened” | Check whether the download was interrupted, the app was copied completely, and your system is compatible. | Delete this downloaded copy and get it again from the download page. If the warning persists, stop and keep the exact warning text. |
| The app will damage your computer, or malicious content was detected | Record the system warning and the file’s source. Do not proceed. | Follow the system’s security guidance. Don’t treat this as a routine source verification prompt. |
| Your version of macOS or processor is unsupported | Check About This Mac against the compatibility requirements on the download page. | Select a compatible build. Changing security settings won’t fix a compatibility issue. |
Allow opening only after verifying the app’s source
- Try launching Shadowrocket from Applications once. Read the system prompt, then close it.
- Open Apple menu → System Settings → Privacy & Security, then scroll to the Security section. The settings name and layout may differ on older versions of macOS.
- If Open Anyway appears for this Shadowrocket launch, verify the app name, select it, and complete administrator authentication if prompted.
- In the confirmation dialog, check the app name again and select Open. This approval applies to the app, not to system-wide security checks.
If Open Anyway isn’t available, first confirm that you tried launching the app and check whether the prompt matches another case in the table above. A Mac managed by an organization may restrict local approval; ask the administrator for help instead of changing device management policies. If macOS provides no approval option, don’t treat a Terminal command as the default workaround.
4. Install on Windows and handle SmartScreen prompts
On Windows, open Settings → System → About and check System type and Windows specifications against the supported systems listed on the download page. The Windows edition name alone doesn’t establish compatibility. If your device uses ARM, check the download page to see whether the current build supports it; don’t assume compatibility with another architecture.
- Choose the Windows option on this site’s download page and wait for your browser to confirm the download is complete. Don’t open a temporary file that’s still downloading.
- Follow the steps for the downloaded file type: run an installer using its setup wizard, or use Extract All to unpack an archive to a fixed folder, then launch the app from the extracted folder.
- If Microsoft Defender SmartScreen shows “Windows protected your PC,” first verify which download the file came from. Don’t choose to run it right away.
- Only if you’ve confirmed the source and the prompt is a reputation check, select More info and review the app name and Publisher. Stop if either doesn’t match what you expect, or if there isn’t enough information to decide.
- After checking the details, proceed with this launch only if the screen offers Run anyway and you decide to continue. If User Account Control appears, check the program name, publisher, and source before responding; don’t click through without reviewing them.
If there’s no Run anyway button, it doesn’t mean you missed an installation step. Some device policies prevent users from overriding a block, and some warnings come from other security features. Note the window title and full message, then identify the type of issue. Don’t lower the SmartScreen level to install a single app.
5. After launch, check your connection configuration
A successful launch confirms the app is installed; it doesn’t mean you already have a working connection. First make sure Home loads correctly, then add a connection using your own details. To use a subscription, go to Home, tap “+” in the top-right corner → Type → Subscribe, enter your own subscription URL, save it, and update the subscription. Don’t enter a subscription URL in the Address field for a single server, and don’t post a full URL containing a token publicly.
If you use a configuration file, check and enable the intended configuration in Config, then review Global Routing. Config, Proxy, and Direct are different routing modes. Scene follows its configured conditions, so it’s not a good starting point for troubleshooting until you understand those conditions. The comparison below is for checking a working installation; changing routing modes won’t resolve a system installation block.
Config
RecommendedRoutes connections according to the rules in the active configuration. Rules can specify a proxy, a direct connection, or rejection; not every match goes through a proxy. Check the rule targets and order.
Use when: you have a verified configuration and want to check a connection using your usual rules.
Proxy
Routes connections handled by the client through the proxy. A short test can help distinguish a rule selection issue from a server connection issue, but it doesn’t guarantee that every program on your operating system is routed through the client.
Use when: you’ve selected a working connection and want to briefly check whether routing rules are causing different access results.
Direct
Routes connections handled by the client directly. Even if a server is selected, this mode doesn’t mean the proxy connection is in use.
Use when: checking your local network or comparing access before and after connecting.
Run a check in this order
- Keep your existing network connection in place. Confirm that a regular webpage loads to rule out a device-level connectivity issue.
- In Home, select a connection you already have and check its server address, port, and protocol details. The port must match the server; don’t change it to a conventional value by default.
- If a system VPN or network configuration permission appears on the first connection, verify which app requested it before approving. Allowing an app to open and authorizing network access are separate steps.
- If you use Config, check the active configuration, especially the order of
DOMAIN-SUFFIX,IP-CIDR, andGEOIP, and the target of the finalFINALrule. - While troubleshooting for the first time, check Settings → On Demand and note the on-demand connection status. This helps prevent automatic reconnections from confusing a manual disconnect test.
For example, if the app opens and regular webpages load, but a particular site times out after you enable a connection, check your connection details, rules, and server status first. Reinstalling repeatedly won’t help. Conversely, if a system warning appears before the app starts, changing your subscription, DNS, or Global Routing won’t affect that warning.
6. Installation and first-launch FAQs
I chose the wrong Mac build. Can I just overwrite it?
Quit the app, check your processor in About This Mac, then get the correct build from the download page. If you have a configuration, export a backup from the app first, then replace the copy in Applications as prompted by the system. Don’t clear your user configuration folder just to switch architectures.
Why am I asked to approve the app again after an update?
A replacement app file may trigger system checks again. Verify the latest download record and read the prompt. Proceed only for a routine source verification prompt when macOS offers an approval option for the individual app. Don’t assume the new copy is safe just because you opened an earlier version.
Windows says a file is missing. Should I search online for it?
First make sure the archive was fully extracted and that you aren’t launching the app from an archive preview. Then check Protection history to see whether the file was quarantined. Don’t download a DLL from an unknown source or blindly restore a quarantined file. If the problem persists after downloading the complete installer again, note the missing filename and system details.
There’s no approval button on my work computer. What should I do?
Keep the blocked window, filename, download source, processor type, and system information, then share them with your device administrator. Organization policies may restrict installation, administrator permissions, or network extension approval. Being unable to approve the app with a personal account doesn’t mean you chose the wrong build.
The app opens, but I can’t connect. Should I reinstall it?
First check the selected connection in Home, the Global Routing mode, and the active configuration in Config. Then check whether your own subscription updated successfully. If the app launches but connections fail, troubleshoot the network and configuration. Reinstalling usually won’t fix a server address, credentials, or rule target.