This guide is for anyone installing Shadowrocket on a computer for the first time. Check your Mac’s chip or Windows system information, then get the right installer from this site’s download page. If the system shows a security prompt on first launch, proceed only through the system’s provided option after confirming the file’s source. Once installed, you’ll still need to import a subscription from your service provider, choose a server, and check the routing mode. Opening the app does not mean a proxy connection is active.
1. Check your system and architecture before downloading
The Apple Silicon and Intel versions of Shadowrocket for Mac are distinguished by processor architecture, not by the computer’s appearance, purchase year, or system language. Open the Apple menu in the top-left corner and select About This Mac. Check the Chip or Processor field. If it shows an Apple chip, choose the Apple Silicon version; if it shows an Intel processor, choose the Intel version. Having previously installed software built for the other architecture does not change your Mac’s chip type.
Mac Apple Silicon
- Where to check
- Apple menu → About This Mac
- Field to check
- Chip shows an Apple chip name
- Download option
- Mac Apple Silicon
- Architecture
- arm64
Choose the native version for your Mac’s chip; don’t default to the Intel version.
Mac Intel
- Where to check
- Apple menu → About This Mac
- Field to check
- Processor shows an Intel processor
- Download option
- Mac Intel
- Architecture
- x86_64, also written as x64
For an Intel Mac, choose the Intel installer, not the Apple Silicon version.
On Windows, open Settings → System → About and note the System type and Windows specifications. Then go to the Shadowrocket download page and select the Windows version. If Windows says the installer isn’t compatible with your device, check the system requirements and architecture listed on the download page instead of repeatedly trying compatibility options.
2. Install on Mac: copy the app from the DMG to Applications
After the download finishes, make sure your browser has completed it before opening the DMG. A disk image is an installation medium, not the permanent location for running the app. Copy the app to Applications and launch it from there. Otherwise, you may lose access to the copy you were running when you eject the disk image.
-
Check your Mac’s chip
Open Apple menu → About This Mac to confirm whether your Mac has Apple Silicon or an Intel processor, then choose the matching DMG from this site’s download page. Don’t rely on the file icon to identify its architecture.
-
Open the disk image
In Finder, open Downloads and double-click the fully downloaded DMG. Wait for macOS to mount it. If you’re told the disk image can’t be opened, download it again; don’t run Terminal commands to bypass the warning.
-
Copy the app
Drag Shadowrocket to Applications. If the window doesn’t show an Applications shortcut, open Finder → Applications in a separate window. Wait for the copy to finish.
-
Launch for the first time
Open Shadowrocket from Finder → Applications. Once you’ve confirmed it launches, eject the mounted disk image from the Finder sidebar. The Dock shortcut should also point to the copy in Applications.
If macOS asks whether to replace an existing app, quit Shadowrocket first and save your current configuration. Don’t delete the configuration folder when replacing the app; the application and user configuration are separate. After updating, check that your existing servers and Config are still available, then test the connection. This helps distinguish configuration changes from installation issues.
3. macOS can’t verify the developer: check System Settings
“Can’t verify the developer” and “will damage your computer” are different warnings. The first may concern verification of the source or developer identity; the second indicates a security risk assessment. The steps below apply only if you’ve confirmed the file came from this site’s download page and macOS offers Open Anyway. These steps don’t apply to every warning.
- Try opening Shadowrocket from Applications once. Read the app name in the alert, then close the alert window.
- Open Apple menu → System Settings → Privacy & Security, then find the Security section.
- If there’s a blocked-app entry for Shadowrocket, confirm its name and source, then select Open Anyway. Authenticate with an administrator account or Touch ID if prompted.
- When macOS asks you to confirm, read the prompt and select Open. If there’s no matching option to allow the app, don’t disable your Mac’s security checks.
If macOS says the app is damaged or can’t read the disk image, quit and remove the downloaded file, then get the correct build for your Mac’s architecture from this site’s download page. If the issue recurs, note the full warning, chip type, and system information before troubleshooting further. Don’t use commands to remove security attributes in bulk and hide the warning; that makes it harder to tell whether the download is incomplete, the architecture is wrong, or macOS is blocking the app.
4. Install on Windows: distinguish SmartScreen from security alerts
The Windows SmartScreen message “Windows protected your PC” is usually an app reputation warning. It does not mean the connection failed or that you need to change a proxy port. Continue with the installation steps below only after confirming the file came from this site’s download page, its name matches the file you just downloaded, and there are no separate malware alerts.
-
Get the installer
Select Windows on this site’s download page and wait for the browser download to finish. Don’t run a temporary file that’s still downloading or start the installation from a file forwarded in a chat.
-
Review the warning
Run the installer. If SmartScreen shows a reputation warning, select More info to view the app and publisher details. If the information is unclear, stop and check the file’s source first.
-
Confirm that you want to continue
After confirming the source, select Run anyway in the warning. If organizational policy doesn’t offer this option, contact your administrator instead of changing policies to bypass the restriction.
-
Finish installation
Choose an installation location in the setup wizard and complete the installation. If User Account Control appears, confirm the request is for the installer you just ran. Then launch Shadowrocket from the Start menu.
If Microsoft Defender or another system security component explicitly reports a threat or quarantines the file, that’s not the SmartScreen reputation warning described above. Stop running the file and verify the detection name and file source. Don’t turn off real-time protection or add a broad exclusion. If the file from the download page is incompatible with your device’s security policy, don’t keep clicking through different security prompts to force it to run.
- No “Run anyway” option: Check whether the device is managed by your organization or whether a policy other than SmartScreen is blocking the app.
- “This app can’t run on your PC”: Check your system architecture and the download page requirements, then download the compatible installer.
- The app is already running: Quit it from within the app first. If needed, check for a leftover process in Task Manager, then try installing again.
5. Connect for the first time: import a subscription and check Global Routing
Installation only gets the app running. Use Home for servers and connection controls, Config for configuration files, and Settings for app preferences; their locations may vary between desktop layouts. If you already have a subscription, get its link from your service provider. In Home, open the add option, set Type to Subscribe, paste the link, and save it. Then update the subscription and confirm that the server list appears. Don’t paste a subscription link into rule text or use installation credentials from another platform as a subscription.
Select a server before turning on the connection. If the system asks to create a VPN configuration or enable a network component, confirm the request is for Shadowrocket and approve only the permissions needed for this connection. For your first test, connect manually and leave Settings → On Demand unconfigured. This avoids automatic connection conditions complicating troubleshooting. If a platform doesn’t show a feature with the same name, don’t follow menu steps from another platform.
Config: route traffic using rules
RecommendedWith Global Routing set to Config, the currently active configuration determines how requests are routed. Rules are matched in order, and the final behavior also depends on the policy assigned to FINAL. Requests without a specific rule don’t necessarily go direct.
Best for: everyday rule-based routing with a trusted configuration.
Proxy: route through a proxy
Routes requests handled by the client through the proxy path, which is useful for comparison with Config. It doesn’t automatically route traffic from every app the operating system doesn’t hand off to the client.
Best for: briefly checking server availability and the effect of rules.
Direct: connect directly
Connects requests handled by the client directly, without using the selected proxy server. If Global Routing is still set to Direct after you select a server, this mode can’t tell you whether that server is reachable.
Best for: checking whether the local network can reach a destination directly.
Scene: choose a scene
Applies routing behavior according to the conditions in a configured scene. Check the scene’s existing conditions and actions before using it; it isn’t a fixed equivalent of Config or Proxy.
Best for: switching behavior based on your environment when scene conditions are already configured.
To inspect the rules, open Config and check which file is currently active. The examples below explain rule syntax only: example.com is a sample domain, not a subscription or server address; PROXY is a sample policy name, so confirm that your current configuration defines it before using it.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
DOMAIN-SUFFIXmatches the specified domain and its subdomains. Rules earlier in the list are evaluated first.IP-CIDRmatches an IP address range. The example is a private address range, not a representation of every local network address.GEOIPmatches against an IP geolocation database. Whether a domain request can be matched this way also depends on DNS resolution and configuration.FINALsets the final policy for requests that don’t match earlier rules. Place it at the end of the rule list.
6. Can’t open webpages after installation? Troubleshoot by symptom
Keep your test conditions consistent: use the same server and destination webpage, and change only one setting at a time. First determine whether the app won’t start, the connection won’t establish, a single browser is failing, or rule routing is behaving unexpectedly. Then decide whether to troubleshoot the system installation or the app configuration. Don’t change servers, reinstall the app, and rewrite the configuration all at once; you won’t know which change affected the result.
Troubleshooting: test app startup and network connectivity separately
App won’t start
- On Mac, check whether you chose the Apple Silicon or Intel version.
- Record the exact system warning and distinguish a verification prompt from a security alert.
- On Windows, check the system type, whether installation finished, and any organization policies.
- When downloading again, replace only the installer and keep your user configuration for now.
App opens, but there’s no connection
- In Home, check the subscription update result and the selected server.
- Check the connection toggle and the current Global Routing mode.
- In Config, check the currently active file, not just files you’ve imported.
- Check the connection log for the destination, policy, and error details.
For installation issues, start with the system prompt. For connection issues, check the server, routing, and logs first; don’t make reinstalling your first step.
If one desktop app can’t connect but your browser works, check whether that app follows the system proxy settings. A successful browser test doesn’t mean every app’s traffic is routed through Shadowrocket. Also, don’t mistake the server port for a local HTTP or SOCKS5 listening port. For apps that require a manually configured proxy, use the listening address and port Shadowrocket actually provides; don’t assume a fixed port number.
I installed the Intel version on an Apple Silicon Mac. Do I need to import my subscription again?
Save your configuration and quit the app, then download the Apple Silicon version and replace the app in Applications. Don’t delete the user data folder. After reopening Shadowrocket, check Home and Config. Restore from a saved configuration or your own subscription only if the existing data wasn’t retained.
I selected “Run anyway” on Windows. Why can’t I connect?
Run anyway only allows the app to run; it doesn’t add a server or start a connection for you. After installation, go to Home, update your subscription, select a server, and check the connection toggle and Global Routing.
Webpages open with Proxy, but not with Config. Should I reinstall?
Don’t reinstall yet. Keep the server unchanged and check the active file in Config, the rule matched by the destination domain, the policy name, and the outcome for FINAL. This points first to a difference in configuration, but check the connection log to confirm.
My subscription link stopped updating after I switched computers. What should I do?
Check that the link is complete and hasn’t expired, and whether your service provider limits the number of devices or simultaneous connections. Check your local network and system time, then update that subscription once. If you contact your service provider, include the error text, but don’t share the full link or token in a public screenshot.