· Getting Started · About 8 min

How to Connect to Shadowrocket for the First Time: Select a Default Server and Run Connectivity Test

After importing a server, select it as the default in the list, turn on the connection switch, allow the VPN configuration, then run Connectivity Test to confirm the connection.

At a Glance

Your first Shadowrocket connection involves three separate checks: whether a server is selected in Home, whether iOS allows the VPN configuration, and whether your current network can reach a test destination through that server. This guide is for users who have already imported their own server or subscription. Follow the steps in order—select, authorize, test, and verify—so you don’t confuse the DOT indicator, VPN status, and website access.

1. Make Sure a Server Is Available in Home

Importing a server doesn’t connect you automatically. Go to Home, expand your subscription group, and make sure individual server entries are listed. If you see only the group name and no servers, address the subscription update or its contents first; repeatedly toggling the connection switch won’t help. This guide assumes you already have your own service provider and subscription; it does not cover choosing a service.

If you haven’t imported a server yet, tap “+” in the upper-right corner of Home to open the add screen. Select Subscribe under Type, enter your own subscription URL, save it, and then update the subscription. An update can change the server list. During your first connection check, avoid changing the subscription, rules, and multiple server settings at once, or it will be hard to identify the cause of a failure.

2. Select a Default Server, Then Turn On the Connection

In Home, tap the server entry itself, not its edit option. The DOT indicator marks the currently selected default server; it is neither a test result nor confirmation of a successful connection. If you select a different entry, make sure the DOT moves to it before testing.

  1. Select a Server

    Home → Expand your group → Tap a specific server. Confirm that the DOT indicator appears beside it and note its name. Use this same entry for the tests that follow.

  2. Check Routing

    Home → Global Routing, then check the current option. To isolate the effect of rules during initial troubleshooting, you can temporarily select Proxy. If you’re using a rules configuration you’ve already checked, you can leave Config selected and note that condition.

  3. Turn On the Connection

    Return to Home and turn on the connection switch at the top. The first time you connect, iOS may ask to add a VPN configuration. Verify the app, allow the configuration, and complete any device authentication required by the system.

  4. Check the Status

    Wait for the status to stabilize and check whether the switch stays on. If it immediately turns off, address missing system authorization or a configuration error first; don’t assume the issue is with a website or rules.

  5. Run a Test

    Run Connectivity Test in Home and note whether it succeeds, fails, or times out. Then try the website you need to access. Keep the same server selected during both checks.

The system VPN indicator shows that the device has a VPN connection state; it does not, by itself, confirm that remote authentication, DNS resolution, and access to the destination website are all working. Status bar indicators can vary by device, so check both the in-app status and the system VPN status rather than relying on a label at the top of the screen.

3. How Global Routing Affects Your First Connection Test

Global Routing determines how traffic is handled; the DOT indicator only identifies the default server. One does not replace the other. The recommendations below are for initial troubleshooting: first reduce the number of variables to check the connection path, then restore your usual settings.

Proxy

Recommended

Routes traffic through the proxy, temporarily ruling out the effects of rules in Config. This doesn’t mean every type of system traffic on your device will use the selected server, nor does it guarantee access to a particular website.

Best for: Diagnosing your first manual connection and checking whether the selected server can handle proxy traffic.

Config

Handles traffic according to the rules in the active configuration. Rules may direct traffic to DIRECT, PROXY, or a policy in the configuration, so turning on the connection doesn’t mean a given webpage will use the default server.

Best for: Verifying everyday routing after confirming the configuration file and its rule policies.

Direct

Uses a direct connection and can’t verify whether a remote proxy server is working. If a webpage opens, that only confirms access under the current direct-connection conditions; it doesn’t confirm that server authentication is correct.

Best for: Comparing with a direct connection to see whether the issue occurs only when using a proxy.

Scene in Global Routing applies handling options based on the scene conditions you set. For your first connection, choose a clear manual option to avoid a network change triggering a scene switch and changing the conditions between tests. After temporarily using Proxy for diagnosis, remember to restore Config or another option that suits your needs.

4. How to Interpret Connectivity Test Results

Connectivity Test is a connection-checking tool, not proof that every website or app is accessible. A latency test in the server list is also different from an access test after connecting: a latency reading alone doesn’t confirm that authentication, transport, TLS, and the destination request are all working. One timeout doesn’t prove the service is permanently unavailable either.

Before the Test

Default server
The specific entry marked with a DOT in Home
Routing mode
Home → Global Routing → Current option
Network
The Wi-Fi or cellular network currently in use
Connection status
Whether the switch stays on and the system VPN status is established

Record these four details before testing so results from a different network aren’t confused with the original conditions.

After the Test

Test location
Home → Connectivity Test
Test result
Record whether the screen shows success, failure, or a timeout
Destination check
Open the same website you need to access in a browser
Retest conditions
Change only one thing at a time: the server or the network

There’s no universal latency threshold. Results depend on the test destination, network distance, and connection conditions.

If Connectivity Test succeeds but a particular webpage won’t open, keep the current server selected and check whether the issue affects only that domain. Then check DNS and the matching rules in Config. DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches IP address ranges, GEOIP matches based on an IP address’s geographic location, and FINAL handles traffic that doesn’t match an earlier rule. Don’t assume a request uses the proxy just because you see a PROXY rule.

If all access fails, check the server settings and network conditions first rather than rewriting the entire ruleset. For TLS connections, also verify that the system date and time are correct, along with fields such as the server name required by your service. Don’t disable security checks instead of correcting the settings.

5. Retest on Wi-Fi and Cellular with One Variable at a Time

The same server may behave differently on two networks. For a useful comparison, keep the server, Global Routing option, and destination website unchanged; change only the network. Wait for the connection to stabilize after switching, then reconnect and test again. Cellular availability depends on your device and plan, and testing uses mobile data.

Retest Plan: Change Only the Network

On Wi-Fi
  • Complete any required sign-in page authentication first.
  • Select the same server and note the Global Routing option.
  • After connecting, run Connectivity Test and visit the same website.
  • Note whether it fails immediately, times out after waiting, or works normally.
On Cellular
  • On a device that supports cellular, turn off Wi-Fi and confirm that cellular data is available.
  • Keep the same server and routing option; don’t update the subscription at the same time.
  • Reconnect, then repeat the same test and website check.
  • Compare the results with Wi-Fi; don’t use a single speed test to predict long-term performance.

If only one network fails, troubleshoot that network environment first. If both fail, focus on the server settings and service status.

6. First-Connection FAQs and Next Steps

I tapped a server. Why am I still not connected?

Tapping a server changes the default server in Home; it doesn’t connect you. First check the DOT indicator, then turn on the connection switch at the top and authorize the system VPN configuration. Selecting a server and establishing a connection are separate steps.

The switch turns off right after I turn it on. What should I check?

First check whether you missed a system authorization prompt or received a specific error, then check the VPN status in your device’s system settings. If the device is managed and adding VPN configurations is restricted, follow the applicable management requirements. Repeatedly deleting the configuration won’t remove a management restriction.

The VPN status is on, but websites won’t load. Am I connected?

VPN status alone isn’t enough to tell. Go to Home → Global Routing and confirm the expected option, run Connectivity Test, then open the destination website. If Proxy works temporarily but Config doesn’t, check the rules and policies in the active configuration first.

Why does it reconnect after I’ve manually turned it off?

Check Settings → On Demand first, then review the on-demand connection status for the VPN configuration in your system settings. Disable automatic triggers while troubleshooting and test the switch manually. Before turning automatic connections back on, make sure you know what should happen on each network.

Do I need to select a server again after updating the subscription?

An update may change server entries or their names. Go to Home and check that the original server is still there and that the DOT indicator is beside the intended entry, then reconnect and test. Don’t rely on the entry’s previous position in the list.

Your first connection is verified when the selected entry is clear, the connection status is stable, Connectivity Test returns a result you can check, and the destination website works as expected. After restoring your everyday Config and On Demand settings, revisit the destination to confirm that the changes haven’t introduced unexpected routing or automatic connections. Keep the results and conditions for future troubleshooting. Before sharing them, hide your subscription URL, authentication details, and any other sensitive information.

Verify the Official App Store Listing