Shadowrocket Official Manual

Shadowrocket Troubleshooting

Find answers by installation, import, or connection issue. Check your device and the exact error first, then work through the steps one at a time. Change only one setting at a time and keep a record of the original values.

iPhone / iPad: $2.99 one-time App Store purchase · Mac / Windows / Android / Linux: free

ACQUISITION / 01

Genuine app & pricing

Distinguish getting the app from obtaining a connection service, then check the storefront region, device compatibility, and original purchase history.

Can I use Shadowrocket on desktop and Android? How much does it cost?

Yes. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free. Mac downloads are available for Apple Silicon and Intel. Get desktop and Android installers from this site at /dl/shadowrocket/. For first-time installation, see the system permission instructions for your device on this page.

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

Shadowrocket is available for iPad. Check the App Store product page for the iPhone and iPad system requirements. Review its compatibility details against your device’s OS version. If the install button is unavailable, check system compatibility, account region, and device management restrictions before concluding that iPad isn’t supported.

Can’t find Shadowrocket in the App Store?

Shadowrocket isn’t available on the mainland China App Store. Open the App Store product page linked on this site and check the country or region for the Apple ID used for Media & Purchases. Your device language and system region don’t determine the App Store region. To change it, go to Settings → Apple ID → Media & Purchases → View Account → Country/Region. Resolve any balance, subscription, or Family Sharing restrictions first.

How can I verify the Shadowrocket listing in the App Store?

Check the app name, Shadowrocket; the developer, Shadow Launch Technology Limited; and the app ID in the product page URL, 932747118. Compare the listing with the official icon in this site’s header. The iPhone and iPad app costs $2.99 as a one-time App Store purchase; Mac, Windows, Android, and Linux versions are free. Don’t mistake a free listing with the same name for the iPhone and iPad app.

Do I have to buy Shadowrocket again after changing or reinstalling my iPhone or iPad?

The iPhone and iPad app costs $2.99 as a one-time App Store purchase and works on both devices. Mac, Windows, Android, and Linux versions are free. After changing devices or reinstalling, sign in to Media & Purchases with the account used for the original purchase, then download it from your purchases. If a price still appears, check your account, purchase history, and current storefront before buying again. Availability depends on the current App Store page.

Why do I need to import service details after installing the app?

A one-time app purchase isn’t a service plan. Shadowrocket handles connections, rule matching, and traffic; installing it doesn’t provide a server. The iPhone and iPad app costs $2.99 as a one-time App Store purchase; Mac, Windows, Android, and Linux versions are free. To connect, use your own existing subscription or server details. This site does not provide, sell, or recommend servers or subscriptions.

INSTALLATION / 02

Installation & system permissions

Choosing the wrong architecture, system source restrictions, and device management policies are separate issues. Verify the installer source before deciding whether to allow it.

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

Open About This Mac from the Apple menu. Choose Apple Silicon if your Mac lists an Apple chip, or Intel if it lists an Intel processor. The download page offers a separate DMG for each architecture; don’t choose based on the Mac’s age alone. Move the app to Applications before opening it. If macOS blocks it, follow the next set of macOS permission instructions rather than repeatedly switching versions.

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, matches your Mac’s architecture, and downloaded completely. If macOS can’t verify the developer, try opening the app once, then go to System Settings → Privacy & Security and select “Open Anyway.” If macOS says the app is damaged and it’s in Applications, open Terminal and run xattr -cr /Applications/Shadowrocket.app, then try again. This command removes extended attributes from the specified app. Use it only for an app from a source you’ve verified; don’t disable system-wide security protections.

Windows SmartScreen warns that the app may be unsafe. What should I do?

First, confirm the file came from this site and was downloaded from /dl/shadowrocket/. Make sure it’s the Windows 64-bit installer for your device. If SmartScreen displays a protection warning, verify the source, then select “More info → Run anyway.” If your device is managed by your workplace or school, or Windows explicitly detects a threat, stop the installation and ask an administrator to investigate. Don’t bypass restrictions by turning off security software.

Android says this app can’t be installed. Where do I allow it?

The Android installer is for arm64 devices. After downloading it from this site, use the system prompt to allow your current browser or file manager to install unknown apps, then return to the downloaded file and continue. You can turn off this permission for that source afterward. If installation fails during parsing, check that the download is complete, the architecture matches, and enough storage is available. Contact your administrator about installation restrictions on managed devices.

Which Linux package should I choose: deb, rpm, or AppImage?

Choose the package format used by your distribution: deb for systems that use deb packages, rpm for rpm-based systems. For a standalone package, consider AppImage and check the architecture and runtime dependencies first. To install a deb, open the download directory and run sudo apt install ./ followed by the actual deb filename. For AppImage, run chmod +x followed by the actual filename to make it executable, then launch it. See the download page’s installation section for commands and system permission requirements.

How do I update Shadowrocket, and what should I keep beforehand?

Update the iPhone and iPad app through the App Store. For Mac, Windows, Android, and Linux, download the installer for the right architecture or package format from this site. If the system blocks installation, verify the source and follow the instructions on this page. Before updating, keep details for existing subscriptions, essential server settings, and any Config you edited yourself. Don’t assume an update will preserve all local data, and never share backups that contain credentials.

See the full installation, permission, and command instructions →

SUBSCRIBE / 03

Subscriptions & server imports

These steps assume you already have your own subscription or server details. First identify whether you’re working with a subscription, an individual server, or a configuration file.

Where do I import an existing subscription?

Check with your existing provider for the subscription link and supported import format. In Home, open the add option and select Subscribe. Enter the complete link in the appropriate field, save it, and then update. After importing, check that entries appear in the list, then test one. Subscribe provides a server list; Config organizes rules and settings. They serve different purposes, so don’t use a server subscription as a rules configuration file.

Subscription import failed or the list is empty. What should I check first?

Check that the link is complete and contains no spaces, line breaks, or unintended punctuation. Make sure it’s still valid and returns subscription data the app supports. An error page, login page, or individual server share link can’t replace Subscribe content. If the update request fails, check whether your current network can reach the subscription URL, then ask your original provider to confirm your access and format. Don’t post the full subscription link publicly.

How do I update an existing Subscribe, and will it overwrite manual changes?

In Home, find the relevant Subscribe and use the update action for that group or entry; its location depends on the current interface. After updating, check whether the server count, names, and selected entry have changed. Subscription entries may be rebuilt from remote data, so don’t rely on local name or parameter edits as your only backup. If you need to keep custom entries, record their settings first and keep them separate from the subscription group.

Can I add a server if I only have its settings, not a subscription link?

Yes. In Home, open Add Server and select the protocol used by your existing server. Enter its address, port, authentication details, and any required TLS and transport settings. Fields vary between Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and other protocols; changing the protocol name alone doesn’t make the other settings compatible. Save the entry and run Connectivity Test. Keep passwords, keys, and complete share details secure.

Scan QR Code can’t read the code. How can I identify the cause?

First, make sure the system allows camera access and the QR code is complete, clear, and not obscured or compressed by a chat app. Scan QR Code reads supported share formats, not arbitrary webpages or payment codes. If the imported details show an error, ask your original provider to confirm the encoding format and protocol. If the system camera also can’t focus, resolve the camera or permission issue before trying again.

Can I share my subscription or Config file for troubleshooting?

Don’t publicly share the original file, full subscription link, or QR code. A subscription URL may contain access credentials, while Config may include server authentication details, internal domains, or personal network settings. For troubleshooting, share only the error text, relevant settings, and redacted rule snippets. Replace example domains with example.com. If credentials have been exposed, contact your original provider to reset them, then update the relevant entry in the app.

Follow the complete guide from import to connection →

DIAGNOSTICS / 04

Rules & Config

The connection switch, latency tests, DNS, and rule matches each reflect a different stage. Use comparison tests to narrow down the cause instead of resetting everything at once.

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

The three modes are Config, Proxy, and Direct. Config follows the rules in your current configuration and is suited to everyday use when those rules are set up. Proxy routes traffic handled by the app through the selected proxy and can help with a short comparison test. Direct uses a direct connection. Proxy doesn’t guarantee every request will succeed, and Direct doesn’t disconnect the app. Restore your intended mode after comparing results.

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

First, check whether the system prompts you to authorize the VPN configuration and approve it as instructed. Make sure you’ve selected a valid server entry. Check for another connection using the system VPN interface; temporarily stop it and try again. If the switch still turns off immediately, note the message and check Log to distinguish permission issues, configuration parsing errors, and connection failures. Managed devices may restrict VPN configurations; don’t repeatedly remove system management settings.

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

Connected only describes the app’s connection status; it doesn’t mean the destination website is reachable. First confirm your basic network works, then run Connectivity Test. If it fails, check the server settings and service status. If it succeeds, compare Config and Proxy in Global Routing and check request logs for rule matches and DNS errors. Change DNS only if you see a resolution issue; change one setting at a time and note its original value so you can identify the cause.

Why does the latency test pass while the actual connection still times out?

Latency results depend on how the test works and don’t by themselves confirm that authentication, TLS, and access to the destination are all working. Check the protocol, address, port, password or key, TLS name, and transport settings. Make sure the system date and time are set to update automatically. Connections such as Hysteria2 that rely on UDP are also affected by network conditions. Note the error category in Log and retest one setting at a time on the same network; don’t rely on repeatedly switching servers to locate the problem.

What settings should I check if background battery use increases?

Compare battery use in system settings over the same time period and under similar traffic conditions. Check for high data transfer, frequent reconnects, or extended diagnostic logging. See whether On Demand is triggering repeatedly as the network changes, stop intensive tests you no longer need, and check Log for recurring reconnect errors. Don’t change protocol settings you don’t understand just to reduce battery use. If you need to stay connected, don’t simply disable every background-related setting.

The interface is in English. Where should I start?

Start with the task-specific sections: Home manages connections and servers; Add Server is for entering existing server details; Subscribe imports an existing subscription; Config manages configurations; Global Routing selects Config, Proxy, or Direct; Settings contains app settings. This guide keeps interface labels in English so you can match them on screen. Menu locations can vary by platform and system language, so confirm each label and its purpose instead of relying on screenshots from a different platform.