If you already have a node or subscription, check the protocol listed by your service provider, then verify the address, port, authentication details and transport settings. To add a node manually, select its protocol under Add Server → Type. Subscribe is a way to import a node list, not a protocol. The port 443, a password or a UUID alone won’t tell you which type to choose.
Identify the protocol and required details
The protocol defines how the client and server communicate. The transport determines how protocol data is carried, while security settings such as TLS affect how the two endpoints authenticate and protect data. Even when a provider lists all these details together, check them separately. For example, in “VLESS + WebSocket + TLS,” select VLESS for Type; WebSocket and TLS are separate settings. edge.example.com:443 is only an address and port—it does not replace any of these three settings.
- Shadowsocks
- Check the server address, port, encryption method and password.
aes-128-gcmandchacha20-ietf-poly1305are different encryption methods. Don’t keep only the password and select a different method. If the provider lists a plugin and its parameters, check those too. - VMess
- A UUID is typically used to identify the user. Also check the transport and security settings used by the server. With WebSocket, the path and any Host specified by the provider must match. With TLS, check the server name associated with the certificate. A correct UUID doesn’t mean the other fields can be left blank.
- VLESS
- VLESS also commonly uses a UUID, but a VMess node cannot be configured as VLESS. VLESS does not encrypt data on its own; connection protection depends on the security layer used with it. If the details specify TLS, REALITY or
flow, use the combination provided by your service provider. Don’t copy settings from another node. - Trojan
- Trojan typically establishes a connection over TLS and authenticates with a password. Along with the password, check the port and TLS server name (SNI). The connection address and the server name used to verify the certificate may be different. If you see a certificate error, check the name and your device’s time rather than turning off verification.
- WireGuard
- WireGuard is an encrypted network tunnel based on UDP. The configuration may include a local private key, tunnel address, peer public key,
EndpointandAllowedIPs. The local private key is not the peer public key.AllowedIPsspecifies the address ranges associated with the peer; it is not the server address. - Hysteria2
- Hysteria2 uses QUIC over UDP. Check the server address, port, authentication details and TLS settings. If obfuscation is enabled on the server, its parameters must also match.
UDP 443andTCP 443are different transport endpoints. Being able to open an HTTPS site on the same domain doesn’t mean the Hysteria2 endpoint is reachable. - HTTP / SOCKS5
- A standard HTTP proxy can use
CONNECTto tunnel HTTPS traffic. The HTTPS encryption inside that tunnel does not mean the client-to-proxy connection itself uses TLS. SOCKS5 is also unencrypted, even when a username and password are configured. UDP forwarding over SOCKS5 depends on whether both the client and server support and allow it.
Choose a setup method based on the details you have
Use the same connection type as the existing server. The options below compare ways to add a connection in Shadowrocket and when to use them; they are not a ranking of protocol speeds.
Import a subscription (Subscribe)
RecommendedIf you already have a compatible subscription, it can import the node list and its protocol settings. After refreshing, check that the entry you want is still there, especially if your provider has changed its name or address.
Best for: managing multiple nodes from an existing subscription
Enter proxy details manually
Select the type specified by your service provider under Type, such as Shadowsocks, VMess, VLESS, Trojan, Hysteria2, HTTP or SOCKS5, then fill in the fields required for that type.
Best for: a single set of node details or checking parameters one by one
Configure WireGuard using peer details
Check the local interface and peer settings against the supplied details. Don’t use the peer public key as a proxy password or mistake the tunnel address for the public Endpoint.
Best for: having complete WireGuard interface and peer details
Takeaway: verify the protocol before troubleshooting the network
If the same Hysteria2 node works on cellular but times out on Wi-Fi, keep the existing settings and test again. Check whether that Wi-Fi network allows UDP traffic to the server. Don’t change Type to Trojan or HTTP just to try the same port.
Add and test a node in Home
Check what kind of details you have
Distinguish between individual node details and a subscription URL. Get subscriptions from your service provider. A URL may contain access credentials, so don’t forward the full link or include it in a public screenshot.
Choose what to add
In Home, tap the “+” in the upper-right corner to open Add Server. To add a single node, select the protocol specified by your provider under Type. To add a subscription, select Subscribe under Type, then enter the subscription address in URL. The example
https://example.com/sub?token=xxxxis for format recognition only.Save and verify
Tap Save to return to Home. To refresh a subscription, pull down on the Home screen. After refreshing, select the node you want to test from the list. If the node appears but won’t connect, check its settings and reachability next; a loaded list does not mean the connection succeeded.
Test real-world access
Run Connectivity Test in Home, then connect and visit the site you actually need. A test result only confirms that the specific test request received a response. It does not guarantee access to other domains or UDP apps, or that every routing rule works correctly.
Check whether the issue is rule-related
If access fails only with Global Routing → Config, you can briefly switch to Global Routing → Proxy on a test network that permits proxy traffic, then test the same address with the same node. If the result changes, check the active configuration and rule order under Config, then restore your original Global Routing setting.
Node timeouts, certificate errors and routing issues
My provider gave me an address, port 443 and a password. Which Type should I choose?
Ask your provider for the full protocol name first. Shadowsocks also requires the correct encryption method. For Trojan, check the TLS server name. For Hysteria2, confirm that UDP is reachable and verify the authentication settings. 443 and a password don’t identify the protocol.
VMess and VLESS both use UUIDs. Can I try one in place of the other?
No. Go to Home, open the node’s edit screen and check that Type matches the protocol specified by your provider. Then make sure the UUID has no accidental spaces and the transport settings match. If you use WebSocket, check the path, Host and TLS server name separately; don’t combine them into one value.
Why does the same node time out on Wi-Fi but work on cellular?
Keep the node and destination address unchanged. Switch networks, then run Connectivity Test and try accessing the destination again. If the issue involves Hysteria2 or WireGuard, ask your network administrator or service provider whether the server’s UDP port is reachable. For a TLS certificate error, check the device time, server name and certificate first; don’t mistake it for a UDP timeout.
The node test returned a result. Why can’t I open one particular domain?
First check Home → Global Routing. If it is set to Direct, you can’t use access to the destination site to determine whether the selected node is working. With Config, check whether a rule matches DIRECT or REJECT before checking whether traffic reaches FINAL. For example, FINAL,PROXY acts as a fallback only when none of the preceding rules match.
The subscription refreshed successfully. Why won’t the node I was using connect?
A successful refresh only means the subscription content was retrieved. In Home, check whether the selected entry is still in the list, then compare its address, port and authentication details with your provider’s current information. Select a valid entry and test again. You don’t need to change the entire Config to fix an issue with one node.
Get Shadowrocket and browse the guides
Get the iPhone / iPad version on the App Store for a one-time payment of $2.99. Check the App Store listing for system requirements. Verify the developer, Shadow Launch Technology Limited, and app ID 932747118. The Mac (Apple silicon / Intel), Windows, Android and Linux versions are free; download their installers from this site’s download page.