This guide is for users who have imported their own service details into Shadowrocket but are experiencing node timeouts or connection failures. Work through the checks in order—basic network access, latency tests, protocol fields, system time, and traffic routing—to distinguish an unreachable server, a failed handshake, and requests that aren’t using the selected node. Change one setting at a time and keep the before-and-after test results.
First, distinguish a timed-out test from a failed connection
The latency result shown in Home, the system VPN status, and whether a webpage loads are three separate signals. A connected VPN usually means only that the device’s local tunnel is established; it doesn’t confirm that the remote server has authenticated successfully. A successful latency test also doesn’t guarantee that every website or type of protocol traffic will work.
Think of the connection process as a chain of steps. A failure earlier in the chain can make later checks misleading. For example, changing the encryption settings won’t fix a server address that hasn’t resolved.
- Only one test times out: Repeat the test on the same network using the same method before considering deleting the configuration.
- Latency is reported, but webpages fail: Check the test method, TLS, authentication details, DNS, and Global Routing—not just the number of milliseconds.
- Webpages load, but the test times out: The test destination may be unreachable, or the test method may not accurately reflect whether the current protocol is working.
- All nodes fail at once: Check the network, system time, and device settings first. If only one node fails, start with its address, port, and service status.
Step 1: Keep the network fixed and repeat the latency test
First, confirm that the device can open a known working webpage. If the Wi-Fi network requires sign-in, complete its authentication first. The steps below refer to the Home and Settings interface labels on iPhone and iPad. Desktop layouts may differ, but record the selected node, test method, and network for each test.
-
Record the current setup
In Home, note the selected node and Global Routing mode, and save the original configuration. Don’t refresh the subscription, change DNS, and switch protocols all at once—you won’t know which change affected the result.
-
Keep test settings constant
Go to Settings → Connectivity Test and check the current test method and any related destination settings. If the method uses a test URL, make sure the URL itself is reachable. Keep the method and destination unchanged while troubleshooting.
-
Repeat the test
Return to Home and run Connectivity Test on the same node three times in a row. Record each result or timeout. One successful test doesn’t prove the connection is stable, and one failure doesn’t mean the server is down.
-
Switch networks
If possible, switch from Wi-Fi to cellular and run the same test on the same node three times. Change only the network connection; don’t alter the address, port, protocol, or test destination.
-
Test actual access
Select the node, connect, and try to access a known working destination. Record the exact time and what happened. If automatic connection interferes, note the Settings → On Demand status, temporarily turn it off while troubleshooting, then restore it afterward.
The test method determines what the result means. A TCP connection test only shows that a connection can be established to the relevant TCP port. An HTTP request sent through the proxy also involves a protocol handshake and access to the destination. No ICMP response doesn’t necessarily mean the proxy is unavailable; the server may not respond to this type of probe. For protocols that rely on UDP, a TCP port test can’t replace a full connection test.
| Observed result | Check first | Next step |
|---|---|---|
| The same node fails on Wi-Fi but works on cellular | Wi-Fi authentication, DNS, gateway, or UDP restrictions | Keep the node settings unchanged and check the current network |
| The same single node fails on both networks | The node’s address, port, and server status | Confirm the connection details with your service provider |
| TCP test succeeds, but the actual request fails | Authentication, TLS, transport settings, or destination access | Check the fields for the specific protocol |
| Multiple nodes fail only with the same test URL | Whether the test destination is reachable | Confirm the destination, then test access separately |
Takeaway: Keep the results from testing across networks
If the same settings work on cellular but not Wi-Fi, check the Wi-Fi connection path before rebuilding the node. This comparison narrows down the cause more effectively than a single latency reading.
Step 2: Check the address, protocol, and authentication fields
In Home, open the selected node’s editing screen and compare each field with the original information from your service provider. Check Type, server address, and port first, then review authentication and transport settings. The server address field usually takes a hostname or IP address. Don’t enter a full subscription URL as the server address or add a path unless the field requires one.
For example, if the service details specify port 443, the client and server must use the same port. But port 443 doesn’t prove that the node uses TLS, and it’s not a reason to change the protocol to Trojan. Port, protocol, and security settings are separate fields; use the original configuration as your reference.
| Protocol | Fields to check | Common misconception |
|---|---|---|
| Shadowsocks | Address, port, encryption method, password, and any plugin parameters required by the configuration | The password may be correct, but a different encryption method can still prevent communication |
| VMess | UUID, encryption settings, transport method, TLS, and any other fields required by the service | Copying the UUID but missing the transport path or Host |
| VLESS | UUID, transport method, TLS or required security settings, and flow | Reusing another node’s flow or security settings without checking |
| Trojan | Password, TLS, Server Name, and transport settings | Confusing the connection address with the name required for certificate verification |
| Hysteria2 | Authentication, TLS, Server Name, and any service-specific obfuscation settings | Overlooking that it uses QUIC and requires UDP |
| WireGuard | Local private key, peer public key, Endpoint, interface addresses, and allowed routes | Checking only the Endpoint address while overlooking key pairing and tunnel routing |
When using transports such as WebSocket, paths are usually case-sensitive, and the leading slash must be preserved. Server Name identifies and verifies the server in TLS connections; don’t clear it just because the connection address is an IP. Don’t disable certificate verification as a permanent fix. First check the name, certificate validity period, and system time.
- After pasting a password or UUID, check for leading or trailing spaces, line breaks, and truncation. Pay particular attention to field integrity when copying between apps.
- If you’ve manually edited an imported subscription node, save a copy first. Refreshing the subscription may overwrite your changes.
- Confirm that the subscription contents have actually changed, then select the node again and test it. A successful subscription update only means the configuration was retrieved; it doesn’t mean every node is online.
Step 3: Check system time and TLS errors
TLS certificate verification uses the device’s current time. If the clock is significantly ahead or behind, a valid certificate may appear not yet valid or expired. Some authentication methods are also sensitive to clock skew. If the protocol fields look right but the handshake keeps failing, turn on automatic time setting and repeat the same test.
- iPhone / iPad: Open the system Settings → General → Date & Time and turn on Set Automatically. Once connected to the internet, confirm that the displayed time is correct.
- Mac: In System Settings, go to General → Date & Time, turn on automatic date and time, and confirm that the time zone is correct.
- Windows: In Settings, go to Time & language → Date & time, turn on automatic time setting, sync the clock, and try again.
- Android / Linux: Turn on network time in the system’s date and time settings. On Linux, you can also run
timedatectl statusto check synchronization; the exact steps depend on the system service.
The following are examples of messages that may appear in network or TLS logs. Exact prefixes and wording vary by system and connection library. Check the full context rather than changing settings on every node based on a single word.
Error: i/o timeout
Cause and fix: A network read or write operation didn’t finish in time. This message alone can’t tell you whether the port or destination website is at fault. Check the address and stage in the surrounding log entries, then compare results across networks to identify the relevant connection path.
Error: connection refused
Cause and fix: The destination host or an intermediate device actively refused the connection, possibly because no service is listening on that port. Check the address and port, and ask your service provider to confirm that the port is listening. Repeatedly changing the password won’t fix this.
Error: certificate has expired or is not yet valid
Cause and fix: The certificate’s validity period doesn’t match the current time. Sync the system clock first. If the error persists with the correct time, ask the server administrator to check whether the certificate needs renewal.
Error: certificate verify failed
Cause and fix: Certificate verification failed, possibly because of a name mismatch, an incomplete certificate chain, or a trust issue. Check that Server Name matches a name on the certificate and review the server’s certificate chain. Don’t bypass verification.
Step 4: Confirm that requests use the selected node
Node tests and everyday requests may take different paths. In Home, check Global Routing: Proxy uses the proxy mode, Direct connects directly, Config follows configuration rules, and Scene follows the logic set for that scene. Selecting a node in Home doesn’t guarantee that every request will use it.
For a temporary test, note the original mode, then briefly switch to Proxy and check the same destination. Restore the original setting afterward. If Proxy works but Config doesn’t, check the active configuration and matching rules in Config instead of continuing to change authentication fields that have already been verified.
[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
The following example illustrates rule matching only; don’t use it to replace your existing configuration. Rules are checked from top to bottom, and processing stops when one matches. DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches IP ranges, GEOIP uses IP geolocation, and FINAL handles requests that don’t match earlier rules. In this example, example.com and its subdomains match DIRECT first, so they won’t reach the final PROXY rule.
- Domain won’t load: Check whether the log stops during DNS resolution. Don’t try opening an HTTPS site by IP to prove DNS is working; that can introduce a certificate name mismatch.
- Only one website fails: Check the policy that actually matched the request, the destination’s status, and remote DNS resolution. Don’t assume the entire node has failed.
- The connection switch turns itself back on: Check Settings → On Demand and look for other automatic connection settings in the system that may reactivate the connection during testing.
Common questions and troubleshooting details to share
Latency is only a few dozen milliseconds. Why won’t webpages load?
First, check the test method in Settings → Connectivity Test. If it only confirms a successful TCP connection, also check protocol authentication and TLS. Then return to Home, check Global Routing, and try the same destination directly. Record when the connection fails.
Hysteria2 works on cellular but always times out on Wi-Fi. Why?
Keep the node settings unchanged and repeat the test on both networks. Hysteria2 relies on UDP, which some Wi-Fi networks may restrict. Ask the network administrator whether UDP is reachable; a TCP port test isn’t a complete substitute.
It still fails after refreshing the subscription. Should I keep refreshing?
No need to refresh repeatedly. First check whether the retrieved address and port have changed, then test one node. Updating a subscription and establishing a proxy connection are separate processes. If the update request itself times out, check that the link is valid and that the current network can retrieve it.
What information should I send to my service provider?
Include the time and time zone of the failure, operating system, protocol, network type, test method, results from comparing networks, and relevant error text with credentials removed. Don’t send a full subscription link, password, UUID, private key, or QR code containing authentication details.
A useful report should reproduce one specific issue. For example: “Same node and test method: timed out three times in a row on Wi-Fi and succeeded three times on cellular; automatic time setting is on; the actual request failed during the handshake.” This is an example of how to report results, not data collected by this site. If an error appears only once in the logs, say whether you can reproduce it.