Shadowrocket FAQ
First identify whether the issue involves getting the app, installation, importing details, or connecting, then follow the relevant checks. Steps involving screens such as Home use iPhone and iPad as examples; installation permissions for computers and Android are covered separately.
Getting the App and Pricing
Confirm your device, how you got the app, and your purchase history before troubleshooting storefront regions or transferring configurations.
Can I use Shadowrocket on a computer or Android? How does pricing work?
Yes. The iPhone and iPad app costs $2.99 as a one-time purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. Mac downloads are available for Apple silicon and Intel. For Windows, Android, and Linux, choose the installer type listed on the download page. Get desktop and Android installers from this site's download page; their paths are under /dl/shadowrocket/. Similar platform names do not mean installers are interchangeable. Before installing, review the permission instructions for your platform, then follow the first-launch steps.
Can't find Shadowrocket in the App Store? What should I check?
Check the country or region of the account currently signed in to the App Store, and whether the product page shows the app as available. The app is not available in the mainland China App Store. Use the App Store product page linked on this site to check availability in your current storefront. To change your region, go to Settings → Apple Account → Media & Purchases → View Account → Country/Region, then follow Apple's prompts to review your balance, active subscriptions, and payment information. Don't install an app just because its search result has a matching name; verify the developer and app ID too.
How can I verify the official Shadowrocket listing in the App Store?
Check three details on the product page: the name is Shadowrocket, the developer is Shadow Launch Technology Limited, and the app ID in the product URL is 932747118. Then compare the icon with the official icon in this site's header. The iPhone and iPad app costs $2.99 as a one-time purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. Check the App Store page for system requirements. Use the product page itself to verify the listing—not search ranking, a similar name, or an icon shown elsewhere.
Do I have to pay again when I get a new iPhone or install Shadowrocket on an iPad?
If you've already purchased Shadowrocket, sign in to the App Store on your new iPhone or iPad with the same Apple ID used for the purchase. Find Shadowrocket in your account's purchased items and download it again; you usually won't need to pay again. The iPhone and iPad app costs $2.99 as a one-time purchase on the App Store. The Mac, Windows, Android, and Linux versions are free. If you're still asked to pay, check the account and purchase history before placing another order. Restoring the app does not restore all your configuration, so keep subscription details and configuration backups from your old device separately.
Why do I need an existing subscription or server details after getting the app?
A one-time app purchase is not a service plan. The iPhone and iPad app costs $2.99 as a one-time purchase on the App Store; the Mac, Windows, Android, and Linux versions are free. These prices cover the app, not network service. Shadowrocket reads server details, connects, and handles requests according to rules. Before setup, get a subscription URL or server details from your provider and make sure they're still valid. This is Shadowrocket's official site and manual. It does not provide, sell, or recommend servers or subscriptions; it explains how to import and use details you already have.
Installation and First Launch
Confirm the installer source and device type first, then address system permissions and VPN access.
Which Mac version should I choose: Apple silicon or Intel?
Open the Apple menu → About This Mac. If it lists an Apple chip, choose the Mac Apple silicon version; if it lists an Intel processor, choose Mac Intel. Don't guess based on the computer's appearance or purchase year. Download either version from this site's download page and use its matching .dmg installer. Move the app to Applications before opening it. If macOS says it can't verify the developer, first confirm the installer came from this site, then go to System Settings → Privacy & Security, find the blocked app entry, and select Open Anyway as prompted.
Windows SmartScreen warns that the app may be risky. What should I do?
First, confirm that you downloaded the Windows installer from this site's all-platform download page, and check its site path in your browser's download history. Once you've confirmed the source, expand More info in the SmartScreen window, if available, select Run anyway, and follow the installation prompts. Don't disable system-wide protection just to open the app. If your device is managed by your workplace or school and there's no option to continue, follow its device policy and contact the administrator. System policy restrictions and app connection settings are separate issues; importing the subscription again won't remove an installation restriction.
Mac says the developer can't be verified or the app is damaged. What should I do?
Confirm the installer came from this site and that you chose the right version for Apple silicon or Intel. If macOS can't verify the developer, try opening the app, then go to System Settings → Privacy & Security, find its entry, and select Open Anyway. If macOS says the app is damaged, make sure it's in Applications, then run xattr -cr /Applications/Shadowrocket.app in Terminal and reopen it. This command clears extended attributes only for that path. If you can't confirm the source or path, stop; don't broaden the command's scope or disable system-wide protection.
What permissions should I check when installing on Android or Linux for the first time?
After downloading the installer for Android from this site's download page, the system may ask you to allow the browser or file manager that started the installation to install unknown apps. Grant temporary permission only to the app you're using, and revoke it after installation if you like. On Linux, choose deb, rpm, or AppImage for your distribution. Before running an AppImage for the first time, allow execution in its file properties or run chmod +x on the actual filename in its directory. Don't rename an installer for another platform and try to run it. If device policy blocks installation, address the system permission first rather than changing server details.
VPN permission was denied on the first connection, and the switch won't stay on. What should I do?
On iPhone or iPad, the first connection requires system permission to add a VPN configuration. If you previously tapped Don't Allow, return to Shadowrocket's Home and try connecting again, then approve the system prompt. If it still fails, check the VPN entries in Settings, device management restrictions, and whether another VPN is connected. Before removing an entry, confirm what it belongs to; keep copies of existing servers and configurations, and don't delete unfamiliar management profiles. If the switch turns off immediately, note the full error message to distinguish a permission issue from incorrect server details.
For detailed platform steps, see Installation permissions; for first launch, see the setup guide.
Subscriptions and Server Imports
The steps below assume you already have a valid subscription or server details. Identify the type of information first, then check the import result.
A subscription URL won't import. What should I check, and in what order?
Make sure you copied the entire subscription URL without spaces, line breaks, or punctuation added by a messaging app. Get the URL from your provider. Check that the device's date and time are correct and that the current network can reach the URL. When adding it through Add Server, set Type to Subscribe rather than entering the link in a single server's Address field. A format error may mean the URL returned a login page, an error page, or an incompatible format. Ask your provider what the link is for, and avoid changing several unrelated settings at once.
How can I tell a single server share link from a Subscribe URL?
A single share link usually describes one server, such as a string beginning with ss://, vmess://, vless://, or trojan://. A Subscribe URL is generally used to retrieve and update a group of servers. Don't distinguish them by link length alone; follow your provider's description of the link. After importing a single entry, check its protocol and fields. After importing a subscription, check its group and server list. Subscription updates mainly sync server details; they don't necessarily update rule files in Config, which need to be checked separately.
How do I update a subscription, and will it change the selected server?
In Home, find the relevant Subscribe group or subscription entry and use its update action. Layouts vary by platform, so use the menu in your current app. Before updating, check that the URL is valid; afterward, confirm the list refreshed and that the previously selected server is still there. Your provider may change the list, including server names and available options, so a successful update doesn't guarantee the current connection will work. If the old server was removed, choose another and test the connection. Save any important settings you've changed manually so you can restore them after a sync.
Can't connect after adding a server manually with Add Server. Which fields are most often incorrect?
Check that Type matches the actual protocol, then review Address, Port, Password, and any relevant identity fields one by one. Enter the Shadowsocks encryption method, Trojan TLS parameters, and VMess or VLESS transport settings according to the details you have; don't fill gaps with values from another entry. Capitalization and extra spaces in the domain, port, or password can also cause connection problems. Get missing details from your provider. Fix one known issue at a time, save, and test again to identify what changed.
Can I share a subscription URL in screenshots, logs, or public support posts?
Don't share a complete subscription URL publicly. Its path or query parameters may contain credentials, and a QR code may expose the same information. When asking for help, include only the error message, protocol, steps you took, and necessary network details. Redact addresses, passwords, and identity fields; review logs carefully before sharing them too. If the full URL has been exposed, reset the relevant credentials using your provider's management tools and replace the old URL in the app. Deleting a public screenshot alone doesn't invalidate leaked information; update the subscription and test again after resetting it.
Rule Routing and Troubleshooting
Check the connection switch, actual request results, and rule matching separately to avoid unnecessary configuration changes.
How should I choose Config, Proxy, or Direct in Global Routing?
For everyday rule-based routing, choose Config, provided the active configuration contains the rules you need. Use Proxy to temporarily check the proxy route, or Direct to connect requests directly. The options are named Config, Proxy, and Direct in the interface. Proxy still requires a valid server and system permissions; Direct does not route requests through a server. Note the original setting before switching and restore it after testing. If results differ, check rule matching rather than leaving a temporary test mode in place to mask a configuration problem.
It says connected, but webpages won't load. What should I check first?
Connected mainly means the local VPN connection is established; it doesn't guarantee access to every destination. First disconnect temporarily and confirm the underlying network can open a known-working page. Reconnect and check that Home has a valid server selected. Then compare Config and Proxy: if only Config fails, focus on rules and their policy targets; if both fail, check server details, service status, and the network first. Next, review DNS and the specific errors in the logs, changing one thing at a time. Connectivity Test results can help narrow down the issue but don't replace testing an actual website or app request.
How do I troubleshoot DNS errors or a domain that won't load?
First check whether all domains fail or only specific ones, and note the network, Global Routing mode, and configuration in use. If you recently changed DNS, back up the current configuration and compare it with the last known working settings; don't change several DNS addresses at once. In Config, check for relevant DOMAIN, DOMAIN-SUFFIX, or DOMAIN-KEYWORD rules and confirm the policy points to the intended route. Don't assume a certificate error is a DNS issue or bypass certificate checks. Use the error message, system time, and request logs to continue troubleshooting.
The interface is in English. Which items should I learn first?
Start with Home, Config, Settings, and Data: Home shows connection status and servers, Config manages configurations, Settings contains app settings, and Data shows traffic records. In Home, distinguish the connection switch, Global Routing, Connectivity Test, and SERVER list. The official manual keeps these English labels so you can match them to the interface. Layouts may vary by platform or system, so look for the item names first. Don't change an unfamiliar field until you know whether it controls a server, rules, or system connection behavior.
Battery use seems high in the background. Should I turn On Demand on or off?
Compare battery usage with the times you used the device, and distinguish ongoing traffic, network changes, and repeated reconnections instead of relying only on the app's share of battery use. On Demand starts connections based on configured conditions; it isn't a battery-saving switch. If you don't need automatic connections temporarily, turn it off and disconnect manually, then compare usage under similar conditions. If reconnections continue, check server availability and network stability. Data can help identify ongoing traffic but can't prove what caused battery drain. While troubleshooting, avoid changing rules, DNS, and background settings at the same time.