Shadowrocket Official Manual / FAQ

Shadowrocket FAQ

Check download options for your device, then troubleshoot imports, connections and routing by symptom. Keep your current configuration before troubleshooting and change one setting at a time so you can compare results and restore it.

Select a question to expand its answer. You can open several at once for comparison. Before sharing error details, remove credentials from subscription links, server passwords and personal account information.

Download options / purchase history / authenticity checks

Official downloads and pricing

Separate app access from your existing service, then check your device, storefront and purchasing account.

How much does Shadowrocket cost? Does the app include server access?

The iPhone and iPad app costs $2.99 as a one-time purchase on the App Store; the displayed price may vary by storefront currency. The Mac, Windows, Android and Linux versions are free. A one-time app purchase does not include a service subscription. Purchasing the app grants access to the app; you still need your own subscription or server details to connect. This is the Shadowrocket official website and manual. We do not provide, sell or recommend servers or subscriptions, or activate connection services.

Can I use Shadowrocket on a computer or Android device?

Yes. Shadowrocket is available for Mac (Apple silicon and Intel), Windows, Android and Linux. The iPhone and iPad app costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android and Linux versions are free. Get desktop and Android installers from this site's download guide; files are hosted under /dl/shadowrocket/. You do not need to transfer a phone app to your computer. Before installing for the first time, review the system security prompts on this page and choose the installer for your device.

Can I install Shadowrocket on iPad? Where can I check the system requirements?

Yes. Get Shadowrocket for iPhone and iPad from its App Store product page. Check the App Store listing for the current system requirements. The iPhone and iPad app costs $2.99 as a one-time purchase; you can restore it on either device using the same purchasing account. The Mac, Windows, Android and Linux versions are free. Before installing, check the account signed in for Media & Purchases, your device's OS and available storage. Do not rely on search result names alone to determine compatibility.

Do I need to buy Shadowrocket again after changing or resetting my device?

When you replace or reset an iPhone or iPad, sign in with the original purchasing account and find Shadowrocket in your App Store purchase history to download it again. You usually won't need to purchase it again. Initial pricing has two tiers: the iPhone and iPad app is a one-time $2.99 App Store purchase; the Mac, Windows, Android and Linux versions are free. If you see a purchase button, check your Media & Purchases account, purchase history and storefront before paying again. Re-download desktop and Android versions from this site. After restoring the app, check your subscriptions and configuration separately.

How can I verify that I downloaded Shadowrocket?

For iPhone and iPad, check the App Store listing for the app name Shadowrocket, the official icon, developer Shadow Launch Technology Limited and app ID 932747118. The product link should contain the same ID. Do not rely on a Chinese nickname or a similar-looking icon. For Mac, Windows, Android and Linux, choose an installer from this site's download guide and check that its address is under /dl/shadowrocket/. If the file source or name does not match your platform, stop the installation and choose again from the download guide.

View download options and authenticity checks →

Device architecture / system prompts / connection permissions

Installation and first launch

Check the file source and device architecture first, then handle system permissions. Security warnings and connection setting errors are separate issues.

Which Mac version should I choose: Apple silicon or Intel?

Open About This Mac from the Apple menu and check the Chip or Processor field. If it shows Apple silicon, choose Mac Apple Silicon; if it shows Intel, choose Mac Intel. Don't guess based on the computer's appearance, purchase year or browser detection. Both installers are in the Mac section of the download guide, with a dmg for each architecture. If you see an unverified developer warning on first launch, confirm the file came from this site, then follow the prompt in System Settings → Privacy & Security to open it anyway. If the architecture doesn't match, download the correct installer.

Windows warns that Shadowrocket is risky or blocks it from running. What should I do?

First confirm the file came from the Windows download option in this site's guide and that the download completed. The installer is not code-signed, so SmartScreen may appear the first time you run it. After confirming the source, select More info → Run anyway in the warning. Do not leave system protection disabled just to launch the app. If your device is managed by your employer or school, its policies may prevent you from allowing the app; contact your administrator. If the warning is about a damaged file, incompatible architecture or incomplete download, allowing the app to run won't fix it. Recheck the file and system requirements.

Mac says the developer can't be verified or the app is damaged. What should I do?

Confirm the download came from this site, then move Shadowrocket to Applications. The installer is not code-signed. If macOS can't verify the developer, go to System Settings → Privacy & Security, find the blocked app and select Open Anyway, then confirm. If macOS says the app is damaged, verify the source and that the download completed, then run xattr -cr /Applications/Shadowrocket.app in Terminal and try again. This command clears the app's extended attributes; it will not repair a genuinely damaged file. If the problem persists, download the installer for the correct Mac chip.

What should I know before installing Shadowrocket on Android or Linux?

On Android, download the correct installer from this site. If the system blocks installation, open Settings and allow the browser or file manager you used to install unknown apps. You can revoke this permission afterward; don't disable the device's overall security checks. On Linux, choose deb, rpm or AppImage for your distribution. Install a deb with sudo apt install ./Shadowrocket.deb, replacing the filename with the one you downloaded. For an AppImage, run chmod +x followed by the actual file path, then launch it. Resolve dependency or architecture errors based on the message; don't keep forcing the installation.

The connection switch won't turn on, or turns off immediately. What should I do?

First, make sure a valid server is selected in Home and all required fields are filled in. Check whether the system prompts you to add a VPN configuration or authorize the connection. On iPhone and iPad, allow the VPN configuration and complete any required verification. If you denied the prompt, check the VPN configuration in system settings, then try again. Also check for another active VPN connection, device management restrictions or a problem with the current configuration. Stop conflicting connections and restart the app first; don't delete all subscriptions right away. If it still fails, note the exact error and steps that triggered it.

See installation and security prompt steps for each platform →

Subscribe / Add Server / Config

Subscription and server imports

The steps below assume you already have your own subscription or server details. Identify the content type first, then choose the right import option.

Subscribe import failed. What should I check first?

Make sure you copied a subscription link from a service you already use—not an account dashboard, help page or individual server share. When pasting it into Subscribe on the Config page, check for extra spaces, line breaks or an incomplete copy. Confirm your current network can reach the subscription URL and that the subscription hasn't expired. If you get a format error, ask the original service provider whether the response is in a format the app can read. Subscription links may contain credentials. Don't share the full link or post screenshots containing credentials publicly.

How do I update a subscription, and will a failed update affect existing connections?

Use the update action on the existing subscription entry. Wait for it to finish, then check whether the server list changed. Don't add the same subscription repeatedly instead of updating it. To enable automatic updates, look for subscription update options in Settings and check whether update on app launch is enabled; available options vary by interface. A failed update only means that this fetch didn't succeed; it doesn't necessarily mean existing servers have stopped working. Keep the current entry while you check the link's validity, network access and response format. If the provider has revoked the old URL, replace it with your own new one.

QR code or clipboard import didn't recognize a server. What should I do?

Before using Scan QR Code, allow camera access and make sure the QR code is clear, complete and not obscured or cropped. For clipboard import, copy the full share content again and allow access if prompted. Extra explanatory text, line breaks or an incomplete copy can prevent recognition. A QR code may also point to a regular web page, so not every code contains a server configuration. If your service provided connection details in a parameter list, use Add Server, select the protocol specified in the original details and enter each field as given. Don't guess passwords, ports or encryption settings.

Add Server saves the entry, but the server keeps timing out. What should I do?

Saving only means the form passed basic checks; it doesn't confirm that the server is reachable. Check the protocol selected in Add Server, then compare the address, port, password or UUID, encryption method and any applicable TLS, SNI or transport path fields against the original details. Watch for capitalization and extra spaces. Then run Connectivity Test and, if possible, repeat it on another network. Change one field at a time and keep the original details so you can revert. Don't assume a failed test is caused by rules, and don't turn off certificate verification to bypass an error.

What's the difference between a subscription and a Config file, and how should I handle duplicates?

Subscriptions are mainly used to retrieve and update server details. Config files may also include behavior and routing settings such as General, Rule and Host, so the two aren't interchangeable just because their links look similar. After importing, check separately that the server is present and which Config file is active. For duplicate entries, compare the name, associated subscription and address. Confirm the entry you want to keep works before deleting the duplicate. Save any personal configuration you need before deleting anything. Don't clear subscriptions and rules at the same time just to tidy the list, or it will be harder to pinpoint later problems.

Follow the steps to import and make your first connection →

Global Routing / Connectivity Test / On Demand

Rules & Config

Check system connection status, server reachability and matched request rules separately. Don't judge everything by one icon or test.

How do I choose Config, Proxy or Direct in Global Routing?

Global Routing has three modes: Config, Proxy and Direct. Config applies the policies in the active Config file and suits everyday use when routing rules are set up. Proxy sends connections through the selected proxy and can help temporarily rule out routing rules as the cause. Direct connects without a proxy and can help check your underlying network. When troubleshooting, note the original setting, change only this option for comparison, then restore it afterward. Proxy won't fix incorrect server settings, and Direct doesn't mean every rule in the current configuration has been verified.

It says connected, but webpages won't load. What should I check, and in what order?

Connected usually means the system connection is established; it doesn't guarantee that a request has succeeded. Disconnect to confirm the underlying network works, then check the selected server and run Connectivity Test. Next, check whether Global Routing and the active Config match your expectations. If only domain names fail, check DNS settings. If only some sites fail, inspect the connection logs to see which rules and policies were matched, and check for REJECT or incorrect routing. Change one thing at a time and repeat the same test, noting any errors. Avoid changing the server, rules and DNS all at once, or you won't know what made a difference.

Connectivity Test returns a result, but browsing is still slow. Why?

Connectivity Test results depend on the test method and target. They only indicate connectivity at that moment, not webpage load times or actual throughput. Repeat the test with the same target on the same network to distinguish occasional jitter from a persistent issue, then check whether the target request follows the expected policy. Wi-Fi signal, server load, the destination site's response, DNS and protocol transport settings can all affect performance. Don't repeatedly rebuild the configuration based on a single test. If switching networks clearly improves things, start by checking your local network and connection conditions on the original network.

The interface is in English. Which setting names should I look for?

This manual uses the original English interface labels, so look for Home, Add Server, Config, Subscribe, Global Routing, On Demand, Settings and Connectivity Test. The explanations describe what each item does without renaming buttons. If your system offers a separate app language setting, check the languages available in the app settings. If an option isn't listed, that doesn't mean installation failed. Layouts can vary by platform; use the item name and function, and follow the prompts on your current screen. Don't change unrelated connection settings just to match a guide.

The connection drains my battery. How should I check On Demand?

Check your system's battery usage over a representative period. Distinguish actual data transfer from background retries and traffic from other apps; don't judge by the connection icon alone. Check for frequent latency tests, repeated subscription updates or continuous retries after connection failures. Reduce unnecessary tests and resolve connection errors first. On Demand starts a connection when its configured network conditions are met. If it reconnects automatically after you turn it off, check its triggers and the system VPN settings. Note the original conditions before making changes, then test on your usual Wi-Fi and mobile network separately. Battery use also depends on the protocol, signal strength and amount of traffic.

Read the Global Routing settings guide →