This guide is for users who have received connection details or a subscription from their own service provider but haven’t connected yet. Learn the difference between the client, servers, and Config, then import your details, grant permission, and test connectivity. Finally, check subscription updates and On Demand. Steps use the iPhone / iPad interface; system authorization may differ on desktop and Android, so don’t assume the same system prompts apply.
1. Why can’t I connect right after installing Shadowrocket?
Shadowrocket is a rule-based proxy client. Installing the app only sets up the local tool; you also need valid server details and an account or credentials authorized to use that server. Get subscription links from your own service provider. This site does not provide, sell, or recommend servers or subscriptions.
On iPhone / iPad, Shadowrocket is a one-time $2.99 purchase on the App Store. The developer is Shadow Launch Technology Limited, and the app ID is 932747118. Check the App Store listing for system requirements. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free to download from this site. Buying the client doesn’t include a service plan; the app price and your provider’s service fees are separate.
- Client: Receives traffic, forwards it according to your settings, and applies rules locally.
- Server entry: Stores the address, port, protocol, and authentication details used to establish a connection.
- Subscription: A source of server entries maintained by your service provider, which you can use to import and update servers in batches.
- Config: Stores rules, policies, and other settings that determine how requests are handled. It is not the same as a server list.
2. What are Home, Config, and Settings for?
Start with these three sections to avoid changing unrelated settings while troubleshooting. Home is where you select a server and manage the connection; Config is for rule configurations; Settings contains app-wide options. Selecting a server doesn’t mean the right rule configuration is active. Importing a Config also doesn’t guarantee that every policy it references is available in your environment.
| Section | What to check on first use | Common misconception |
|---|---|---|
| Home | Server entries, selected server, connection switch, and Global Routing | A server in the list means the connection is working |
| Config | Active Config, rule order, and policies referenced by rules | Any Config can be applied to an existing server list |
| Settings | App settings such as On Demand and Subscribe | Turning on automatic connection fixes incorrect server details |
3. Which of the four Global Routing modes should I use?
Global Routing determines how traffic is handled overall. For everyday rule-based routing, first make sure your Config is valid, then select Config. To troubleshoot rules, you can temporarily switch to Proxy for comparison. This won’t fix an unavailable server, failed authentication, or an underlying network problem.
Config
RecommendedHandles requests using the rules and policies in the active Config. Requests matching DIRECT connect directly; requests matching a proxy policy are routed through that policy. Requests with no match are handled by later rules or FINAL.
Best for: everyday rule-based routing with a working Config
Proxy
Routes traffic handled by the client through a proxy instead of applying the individual routing rules in Config. You still need to select a working server or proxy policy.
Best for: temporarily testing the proxy route or comparing the effect of rules
Direct
Connects traffic handled by the client directly. Even with the connection switch on, requests aren’t necessarily going through a remote proxy server.
Best for: checking whether your local network can reach a destination directly
Scene
Uses the configured Scene. Before switching, check its matching conditions and corresponding actions. If no Scene is configured, don’t treat this mode as an automatic server-selection feature.
Best for: setups with explicitly configured and tested Scene conditions
4. What’s the right order for adding a subscription and connecting?
Import first, select a server next, then authorize the connection. Subscription URLs contain access credentials, so don’t share them in public comments or screenshots. The example https://example.com/sub?token=xxxx is for illustration only and cannot be used to import a subscription. When copying your actual URL, keep its query parameters and remove any quotation marks, spaces, or line breaks added by a messaging app.
-
Get the link ready
Get the subscription link from your own service provider. Make sure your account is active and that you have a client subscription URL, not an account management webpage.
-
Add the subscription
Go to Home → tap “+” in the upper-right corner → Type → Subscribe. Enter the full URL, add a recognizable remark, and save.
-
Check the entries
Return to Home and check whether the subscription contains any servers. If it hasn’t fetched any entries, update the subscription. Select a server your provider has marked as available.
-
Connect
Check Home → Global Routing, then turn on the connection switch on Home. When the system first asks to add a VPN configuration, verify that the request matches the action you just took, allow it, and complete device authentication.
-
Test access
Run Connectivity Test on Home, then use a browser to visit the site you need. Once both the test and webpage access work, adjust routing settings one at a time.
5. Should I allow the system to add a VPN configuration?
On iPhone / iPad, Shadowrocket uses a system network extension to receive and process traffic. Allowing it to add a VPN configuration on first connection sets up this local traffic-handling path. A VPN indicator only shows that the relevant tunnel is active; it doesn’t confirm successful authentication with a remote server or prove that all websites are routed through a proxy.
Don’t delete unfamiliar system configurations in bulk while troubleshooting. Work or school-managed devices may restrict adding VPN configurations, so check the device policy first. Other VPN apps that connect automatically may also interfere or take over the connection. Disable their automatic connections one at a time before comparing results.
6. What’s the difference between closing the app, disconnecting, and On Demand?
Leaving the app doesn’t disconnect the system tunnel. To stop proxy traffic during normal use, turn off the connection switch on Home and check the system status. If it reconnects shortly afterward, check Settings → On Demand first instead of repeatedly force-quitting the app.
Choosing between manual connection and On Demand
Manual connection
- While troubleshooting for the first time, turn off On Demand in Settings → On Demand.
- When you need a connection, turn on the Home connection switch.
- When you’re done, turn the switch off and make sure the connection doesn’t start again automatically.
On Demand
- Once manual connections are stable, configure Settings → On Demand.
- Check each network matching condition and its corresponding connection action.
- Test separately on Wi-Fi and cellular to make sure the conditions don’t apply more broadly than expected.
On Demand controls when a connection starts; Global Routing controls where traffic goes after it connects. They serve different purposes and can’t replace each other.
7. What does a subscription update change? Do I need to re-import it every day?
You usually don’t need to delete and recreate a subscription every day. An update fetches the latest entries published by your provider, which may change addresses, ports, names, or authentication details. After updating, check which server is selected, especially if an existing entry was removed or renamed. Server subscription updates don’t necessarily update Config rules; check these two sources separately.
- Regular update: Update the subscription on Home. First check whether it succeeded, then confirm that the number and names of entries look right.
- Update timed out: Check that your local network is online. If the subscription URL isn’t reachable over your current direct connection and you already have a working proxy, go to Settings → Subscribe, check Update via Proxy, and try again.
- Empty list: Check your provider account status, whether the link was reset, and whether the response is an error page. Repeatedly importing the same link won’t necessarily help.
- Before deleting: Keep the original link you’re authorized to use and any useful remarks. Note any fields you changed manually; an update may overwrite changes to provider-managed entries.
If there are no working servers, turning on Update via Proxy won’t create a usable proxy route. First check whether the subscription is reachable on your current network, or ask your own provider to verify the link and account status.
8. Which protocol should I choose in Add Server, and what port should I enter?
The Type must match the protocol provided by your service provider. Don’t choose based on the name or personal preference. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard use different fields; changing the Type for the same address usually won’t produce a working connection. If the subscription imported the server correctly, keep the supplied details and don’t change the protocol, port, and TLS settings all at once.
| Field | What to check |
|---|---|
| Address / Port | Check the address and port together. 443 is common, but it isn’t a standard port for every protocol or server. If your provider specifies 8443, don’t change it to 443. |
| Authentication | Enter the Shadowsocks method and password, the VMess / VLESS UUID, the Trojan password, and other credentials according to the selected Type. |
| TLS and transport | Check the TLS settings, Server Name, transport type, and path required by your provider. The server address may differ from the domain used on its certificate. |
| Protocol-specific settings | Use all provider-supplied settings, including Hysteria2 authentication and transport options or WireGuard keys and tunnel addresses. |
9. How do Config rules work, and why does their order matter?
Rules are generally checked from top to bottom, and the matching rule’s policy is applied. Put specific requirements first, broader rules later, and FINAL last. The lines below illustrate rule syntax; they aren’t a complete Config you can use to replace an existing file. PROXY must refer to a valid policy in your Config, so don’t copy the name without checking its definition.
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 suffix, including the domain itself and its subdomains.IP-CIDRmatches an IP range. In this example,no-resolvemeans the IP rule won’t trigger an additional domain lookup; it doesn’t disable all DNS.GEOIPmatches using the geographic database entry for the destination IP; it doesn’t determine routing based on the webpage’s language.FINALis the fallback rule. Its specified policy is used only when none of the rules above it match.
If a site works in Proxy but fails in Config, first check which rule matches the domain, whether its policy points to a valid target, and whether an earlier, broader rule is catching the request. Don’t delete all the rules first; you’ll lose the comparisons needed to find the problem.
10. Connected, but webpages won’t load? What should I check first?
Use one destination, one server, and one network for each test so the conditions stay consistent. Note whether the connection was established, whether Connectivity Test timed out, and the exact browser error. Then compare one factor at a time. A latency result in milliseconds isn’t a download speed, and a single timeout doesn’t mean all traffic is unavailable.
The VPN indicator is on, but webpages still won’t load?
Go back to Home and make sure a working server is selected, then check that Global Routing is set to the mode you expect. Run Connectivity Test. If a site that should connect directly also fails in Direct, check your local Wi-Fi sign-in page, cellular data permissions, and network connection first.
Sites load in Proxy but not in Config?
Keep the same server and destination, and change only Global Routing. If the difference is repeatable, check the matching rule, policy name, and FINAL in Config, then review DNS-related settings. Restore your usual mode after testing.
It fails on cellular. What should I change?
Using the same server, record the results on Wi-Fi and cellular separately. Make sure the app has permission to use cellular data, then check the network conditions in Settings → On Demand. If only one server fails on a particular network, give your provider the network type, error message, and time of the failure. Don’t share passwords or subscription URLs publicly.
You’ve completed the first connection when you know where the connection details came from, system authorization works, the target website is reachable, and traffic is routed as configured in Global Routing and Config. Once that’s confirmed, enable On Demand or adjust other rules. If an issue comes up later, you’ll have a tested baseline to return to.